BluetoothSocket 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
一個連接或連接的藍牙插座。
[Android.Runtime.Register("android/bluetooth/BluetoothSocket", DoNotGenerateAcw=true)]
public sealed class BluetoothSocket : Java.Lang.Object, IDisposable, Java.IO.ICloseable
[<Android.Runtime.Register("android/bluetooth/BluetoothSocket", DoNotGenerateAcw=true)>]
type BluetoothSocket = class
inherit Object
interface ICloseable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- 繼承
- 屬性
- 實作
備註
一個連接或連接的藍牙插座。
藍牙插座的介面類似於 TCP 插槽: java.net.Socket 且 java.net.ServerSocket。 在伺服器端,使用 a BluetoothServerSocket 來建立監聽伺服器插槽。 當連線被接受 BluetoothServerSocket時,會回傳一個新連線 BluetoothSocket 來管理該連線。 在用戶端,使用單一 BluetoothSocket 連線來發起外出連線並管理連線。
最常見的藍牙插座類型是 RFCOMM,這是 Android API 所支援的類型。 RFCOMM 是一種以連線為導向的藍牙串流傳輸。 它也被稱為序列埠配置檔(SPP)。
要建立連接已知裝置的 a BluetoothSocket ,請使用 BluetoothDevice#createRfcommSocketToServiceRecord BluetoothDevice.createRfcommSocketToServiceRecord()。 然後打電話 #connect() 嘗試連接遠端裝置。 此通話會阻塞,直到連線建立或連線失敗。
若要建立 BluetoothSocket 作為伺服器(或「主機」),請參閱 BluetoothServerSocket 文件。
一旦套接字連接,無論是以客戶端啟動或被接受為伺服器,透過呼叫 #getInputStream 和 #getOutputStreamjava.io.InputStream 來開啟 IO 串流,分別取得 和 java.io.OutputStream 物件,這些物件會自動連接到套接字。
BluetoothSocket 是執行緒安全的。 特別是, #close 我總是會立即中止正在進行的操作並關閉插座。
<div 類別=“特殊參照”>
<h3>開發者指南</h3>
想了解更多藍牙使用資訊,請閱讀 藍牙 開發者指南。 </div>
Java 文件 android.bluetooth.BluetoothSocket。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。
欄位
| 名稱 | Description |
|---|---|
| TypeLe |
已淘汰.
LE 傳輸上的 L2CAP 插座 |
屬性
| 名稱 | Description |
|---|---|
| Class |
回傳此 |
| ConnectionType |
了解潛在連結的類型。 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| InputStream |
取得與這個 socket 相關的輸入串流。 |
| IsConnected |
取得這個插槽的連線狀態,也就是是否與遠端裝置有活躍連線。 |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
取得執行時最後指派的狀態旗標。 (繼承來源 JavaObject) |
| JniPeerMembers |
取得用於存取此 Java 綁定成員的 JNI 元資料。 |
| MaxReceivePacketSize |
取得底層傳輸的最大支援接收封包大小。 |
| MaxTransmitPacketSize |
取得底層傳輸的最大支援傳送封包大小。 |
| OutputStream |
取得與這個插槽相關聯的輸出串流。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| RemoteDevice |
取得這個插座連接或已連接的遠端裝置。 |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 (繼承來源 Object) |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 (繼承來源 Object) |
方法
| 名稱 | Description |
|---|---|
| Clone() |
建立並回傳此物件的副本。 (繼承來源 Object) |
| Close() |
關閉物件並釋放其儲存的系統資源。 |
| Connect() |
嘗試連接遠端裝置。 |
| ConnectAsync() |
非同步建立藍牙插座連線。 |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
將此對等節點的建置委派給執行時的值管理器。 (繼承來源 JavaObject) |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
請求值管理器處置此對等節點,除非其映射保留該受管理實例。 (繼承來源 JavaObject) |
| Equals(Object) |
測試另一個受管理節點是否參考相同的 Java 物件。 (繼承來源 JavaObject) |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時,由垃圾回收器呼叫。 (繼承來源 Object) |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
在控制區塊中儲存參考值,但不建立 JNI 參考副本。 (繼承來源 JavaObject) |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
回傳物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| Wait() |
使目前執行緒等待被喚醒,通常是透過 通知 或 中斷。 (繼承來源 Object) |
| Wait(Int64, Int32) |
使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。 (繼承來源 Object) |
| Wait(Int64) |
使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。 (繼承來源 Object) |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
標記此節點為處置,並以 |
| IJavaPeerable.Finalized() |
標記此節點為處置,並以 |
| IJavaPeerable.JniObjectReferenceControlBlock |
取得此對等端使用的原生控制區塊指標。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
儲存執行時提供的身份雜湊碼。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
取代儲存的受管理對等狀態旗標。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。 (繼承來源 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
將此實例從執行時的 Java 物件查詢中移除。 |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
重用相容的受管理對等端或取得請求型態的包裝器。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |