BluetoothDevice 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
代表遠端藍牙裝置。
[Android.Runtime.Register("android/bluetooth/BluetoothDevice", DoNotGenerateAcw=true)]
public sealed class BluetoothDevice : Java.Lang.Object, Android.OS.IParcelable, IDisposable
[<Android.Runtime.Register("android/bluetooth/BluetoothDevice", DoNotGenerateAcw=true)>]
type BluetoothDevice = class
inherit Object
interface IParcelable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- 繼承
- 屬性
- 實作
備註
代表遠端藍牙裝置。 A BluetoothDevice 讓你能與相應裝置建立連線,或查詢相關資訊,例如名稱、地址、類別和綁定狀態。
這個類別其實只是藍牙硬體位址的一個薄包裝。 此類物件是不變的。 此類別的操作會在遠端藍牙硬體位址上執行,使用 BluetoothAdapter 用於建立此 BluetoothDevice的 。
要取得 BluetoothDevice,請建立 BluetoothAdapter#getRemoteDevice(String) BluetoothAdapter.getRemoteDevice(String) 一個代表已知 MAC 位址裝置的裝置(可透過裝置發現 BluetoothAdapter取得),或從由 返回 BluetoothAdapter#getBondedDevices() BluetoothAdapter.getBondedDevices()的綁定裝置集合中取得 。 接著你可以開啟一個與遠端裝置通訊的 AP BluetoothSocket ,透過 #createRfcommSocketToServiceRecord(UUID) 藍牙 BR/EDR 或 #createL2capChannel(int) 藍牙 LE。
<div 類別=“特殊參照”>
<h3>開發者指南</h3>
想了解更多藍牙使用資訊,請閱讀 藍牙 開發者指南。 </div>
Java 文件 android.bluetooth.BluetoothDevice。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。
欄位
| 名稱 | Description |
|---|---|
| ActionAclConnected |
廣播動作:表示已與遠端裝置建立低階(ACL)連線。 |
| ActionAclDisconnected |
廣播動作:表示遠端裝置發生低階(ACL)斷線。 |
| ActionAclDisconnectRequested |
廣播動作:表示遠端裝置已請求低階(ACL)斷線,且即將被斷線。 |
| ActionAliasChanged |
廣播動作:表示遠端裝置的別名已被更改。 |
| ActionBondStateChanged |
廣播動作:表示遠端裝置的結合狀態發生變化。 |
| ActionClassChanged |
廣播動作:遠端裝置的藍牙類別已改變。 |
| ActionEncryptionChange |
廣播動作:表示加密狀態改變 |
| ActionFound |
廣播動作:發現遠端裝置。 |
| ActionKeyMissing |
廣播動作:表示先前綁定的裝置無法提供金鑰來建立加密。 |
| ActionLeAppearanceChanged |
若LE外觀值尚未已知或未更改,則綁定裝置會廣播此意圖。 |
| ActionNameChanged |
廣播動作:表示遠端裝置的友方名稱首次被檢索,或自上次檢索後已更改。 |
| ActionPairingRequest |
廣播動作:此意圖用於廣播配對請求。 |
| ActionUuid |
廣播動作:此意圖用於在擷取後,將包裹的訊號作為 |
| AddressTypeAnonymous |
已淘汰.
地址類型用於表示匿名廣告。 |
| AddressTypePublic |
已淘汰.
裝置的硬體 MAC 位址 |
| AddressTypeRandom |
已淘汰.
位址可解析、不可解析或靜態。 |
| AddressTypeUnknown |
已淘汰.
地址類型未知或無法使用。 |
| BondLossReasonBredrAuthFailure |
已淘汰.
表示鍵質遺失的原因是 BREDR 認證失敗。 |
| BondLossReasonBredrIncomingPairing |
已淘汰.
表示債券損失的原因為 BREDR 配對失效。 |
| BondLossReasonLeEncryptFailure |
已淘汰.
表示鍵結遺失的原因在於LE加密失敗。 |
| BondLossReasonLeIncomingPairing |
已淘汰.
表示鍵結損失的原因是LE配對失效。 |
| BondLossReasonUnknown |
已淘汰.
表示債券損失的原因不明。 |
| DeviceTypeClassic |
已淘汰.
藍牙裝置類型,經典 - BR/EDR 裝置 |
| DeviceTypeDual |
已淘汰.
藍牙裝置類型,雙模式 - BR/EDR/LE |
| DeviceTypeLe |
已淘汰.
藍牙裝置類型,低功耗 - 僅限 LE |
| DeviceTypeUnknown |
已淘汰.
藍牙裝置類型,未知 |
| EncryptionAlgorithmAes |
已淘汰.
表示連結是用 AES 演算法加密的 |
| EncryptionAlgorithmE0 |
已淘汰.
表示連結是使用 E0 演算法加密的 |
| EncryptionAlgorithmNone |
已淘汰.
表示該連結未使用任何演算法加密 |
| EncryptionAlgorithmUnknown |
已淘汰.
表示連結是使用未知演算法加密的 |
| Error |
此類別的哨兵錯誤值。 |
| ExtraBondLossReason |
包含債券損失的原因。 |
| ExtraBondState |
在 Intents 裡當作 int 額外欄位 |
| ExtraClass |
作為可 |
| ExtraDevice |
作為該級每個意圖廣播中的可 |
| ExtraDiscoveryResultType |
在意圖中 |
| ExtraEncryptionAlgorithm |
在 intants 中作為 int 額外欄位 |
| ExtraEncryptionEnabled |
在意圖中用作布林額外欄位 |
| ExtraEncryptionStatus |
在意圖中 |
| ExtraIsCoordinatedSetMember |
在意圖中 |
| ExtraKeySize |
在意念中用作整數額外欄位 |
| ExtraLeAppearance |
作為整數額外欄位用於ACTION_FOUND、ACTION_LE_APPEARANCE_CHANGED intents,以及音訊相關設定檔的 ACTION_*_CONNECTION_STATE_CHANGED intintations。 |
| ExtraName |
作為弦的額外場 |
| ExtraPairingAlgorithm |
在 intent 中用作額外欄位 |
| ExtraPairingContext |
作為 int 額外欄位 and |
| ExtraPairingKey |
在 intants 中 |
| ExtraPairingVariant |
作為int extra field |
| ExtraPreviousBondState |
在 Intents 裡當作 int 額外欄位 |
| ExtraRssi |
在意圖中作為可選的短額外欄位 |
| ExtraTransport |
在 中用作 int 額外欄位 |
| ExtraUuid |
包含 |
| ExtraUuidLe |
包含 |
| LeAppearanceUnknown |
值表示裝置的LE外觀未知。 |
| PairingAlgorithmBredrLegacy |
已淘汰.
表示使用 BR/EDR Legacy 配對演算法。 |
| PairingAlgorithmBredrSsp |
已淘汰.
表示使用 BR/EDR 安全簡單配對(SSP)演算法。 |
| PairingAlgorithmLeLegacy |
已淘汰.
表示使用 LE Legacy 配對演算法。 |
| PairingAlgorithmSc |
已淘汰.
表示使用安全連線配對演算法,適用於 BR/EDR 及 LE 傳輸。 |
| PairingContextRepairing |
表示系統自主啟動的重新配對過程。 |
| PairingContextUserApprovalRequested |
表示配對流程已啟動,並請求用戶批准以完成配對程序。 |
| PairingContextUserParticipationRequested |
表示請求用戶參與,開始LE Legacy配對流程。 |
| PairingVariantPasskeyConfirmation |
使用者會被提示確認螢幕上顯示的通行金鑰,或應用程式會自動確認通行金鑰。 |
| PairingVariantPin |
使用者會被要求輸入 PIN 碼,或應用程式會為使用者輸入 PIN 碼。 |
| PhyLeHdt |
已淘汰.
藍牙 LE HDT PHY。 |
| PhyLeHdtMask |
已淘汰.
藍牙 LE HDT PHY 遮罩。 |
屬性
| 名稱 | Description |
|---|---|
| Address |
回傳這個藍牙裝置的硬體位址。 |
| AddressType |
回傳此藍牙裝置的位址類型,為 |
| Alias |
取得遠端藍牙裝置的本地可修改名稱(別名)。 |
| BluetoothClass |
取得遠端裝置的藍牙類別。 |
| BondState |
此 API 回傳遠端裝置的綁定狀態。 |
| Class |
回傳此 |
| Creator |
取得實例的 BluetoothDevice 包裹建立器。 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| IdentityAddressWithType |
回傳此藍牙裝置的身份位址及身份位址類型。 |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
取得執行時最後指派的狀態旗標。 (繼承來源 JavaObject) |
| JniPeerMembers |
取得用於存取此 Java 綁定成員的 JNI 元資料。 |
| KeyMissingCount |
取得自上次成功加密連線以來,該裝置被投擲意圖的次數 |
| LeAppearance |
取得遠端裝置的藍牙 LE 外觀。 |
| Name |
取得遠端裝置的友善藍牙名稱。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 (繼承來源 Object) |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 (繼承來源 Object) |
| Type |
取得遠端裝置的藍牙裝置類型。 |
方法
| 名稱 | Description |
|---|---|
| CancelBondProcess() |
取消以 為開頭 |
| Clone() |
建立並回傳此物件的副本。 (繼承來源 Object) |
| Connect() |
連接所有使用者啟用且支援的藍牙設定檔,連接本地與遠端裝置。 |
| ConnectGatt(BluetoothGattConnectionSettings, IExecutor, BluetoothGattCallback) |
連接到該裝置所託管的 GATT 伺服器。 |
| ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, BluetoothPhy, Handler) |
連接由此裝置主機託管的 GATT 伺服器。 |
| ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, BluetoothPhy) |
連接由此裝置主機託管的 GATT 伺服器。 |
| ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, ScanSettingsPhy, Handler) |
已淘汰.
透過使用 BluetoothPhy. 的超載啟動 GATT 用戶端連線。 |
| ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, ScanSettingsPhy) |
已淘汰.
透過使用 BluetoothPhy. 的超載啟動 GATT 用戶端連線。 |
| ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports) |
連接由此裝置主機託管的 GATT 伺服器。 |
| ConnectGatt(Context, Boolean, BluetoothGattCallback) |
連接由此裝置主機託管的 GATT 伺服器。 |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
將此對等節點的建置委派給執行時的值管理器。 (繼承來源 JavaObject) |
| CreateBond() |
開始與遠端裝置的綁定(配對)流程。 |
| CreateBond(Int32) |
使用指定的傳輸工具開始與遠端裝置的綁定(配對)流程。 |
| CreateInsecureL2capChannel(Int32) |
建立一個藍牙 L2CAP 連線導向通道(CoC), |
| CreateInsecureRfcommSocketToServiceRecord(UUID) |
建立一個 RFCOMM |
| CreateL2capChannel(Int32) |
建立一個藍牙 L2CAP 連線導向通道(CoC), |
| CreateRfcommSocketToServiceRecord(UUID) |
建立一個 RFCOMM |
| CreateUsingSocketSettings(BluetoothSocketSettings) |
建立用戶端套接字以連接遠端藍牙伺服器,並設定為指定套接字 |
| DescribeContents() |
描述此 Parcelable 的組建表示中包含的特殊物件種類。 |
| Disconnect() |
斷開本地與遠端裝置間所有連接的藍牙設定檔。 |
| DisconnectAcl(BluetoothTransports) |
會斷開此裝置的 ACL 連結。 |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
請求值管理器處置此對等節點,除非其映射保留該受管理實例。 (繼承來源 JavaObject) |
| Equals(Object) |
測試另一個受管理節點是否參考相同的 Java 物件。 (繼承來源 JavaObject) |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| FetchUuids(Int32) |
對遠端裝置進行服務發現,以取得 UUID 支援,讓呼叫者能指定傳輸方式。 |
| FetchUuidsWithSdp() |
對遠端裝置進行服務發現,以取得 UUID 的支援。 |
| GetBondStatus(Int32) |
回傳此裝置的綁定狀態。 |
| GetEncryptionStatus(Int32) |
取得連接裝置的加密狀態。 |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| GetUuids() |
回傳遠端裝置所支援的功能(UUID)。 |
| IsConnected(Int32) |
回傳該傳輸中該裝置是否有開放連線。 |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時,由垃圾回收器呼叫。 (繼承來源 Object) |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| SetAlias(String) |
設定遠端藍牙裝置的本地可修改名稱(別名)。 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPairingConfirmation(Boolean) |
確認配對的 |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
在控制區塊中儲存參考值,但不建立 JNI 參考副本。 (繼承來源 JavaObject) |
| SetPin(Byte[]) |
當配對方法為 |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
回傳物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| Wait() |
使目前執行緒等待被喚醒,通常是透過 通知 或 中斷。 (繼承來源 Object) |
| Wait(Int64, Int32) |
使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。 (繼承來源 Object) |
| Wait(Int64) |
使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。 (繼承來源 Object) |
| WriteToParcel(Parcel, ParcelableWriteFlags) |
把這個物體壓扁成一個包裹。 |
明確介面實作
| 名稱 | 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) |
試著強制 |