BluetoothDevice 類別

定義

命名空間:

Android.Bluetooth

組件:

Mono.Android.dll

代表遠端藍牙裝置。

[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

繼承

Object

JavaObject

Object

BluetoothDevice

屬性

RegisterAttribute

實作

IParcelable IJavaObject IJavaPeerable IDisposable

備註

代表遠端藍牙裝置。 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	廣播動作：遠端裝置的藍牙類別已改變。
ActionFound	廣播動作：發現遠端裝置。
ActionNameChanged	廣播動作：表示遠端裝置的友方名稱首次被檢索，或自上次檢索後已更改。
ActionPairingRequest	廣播動作：此意圖用於廣播配對請求
ActionUuid	廣播動作：此意圖用於在擷取後，將包裹的訊號作為UUID遠端裝置的廣播android.os.ParcelUuid。
AddressTypeAnonymous	已淘汰. 地址類型用於表示匿名廣告。
AddressTypePublic	已淘汰. 裝置的硬體 MAC 位址
AddressTypeRandom	已淘汰. 位址可解析、不可解析或靜態。
AddressTypeUnknown	已淘汰. 地址類型未知或無法使用。
DeviceTypeClassic	已淘汰. 藍牙裝置類型，經典 - BR/EDR 裝置
DeviceTypeDual	已淘汰. 藍牙裝置類型，雙模式 - BR/EDR/LE
DeviceTypeLe	已淘汰. 藍牙裝置類型，低功耗 - 僅限 LE
DeviceTypeUnknown	已淘汰. 藍牙裝置類型，未知
Error	此類別的哨兵錯誤值。
ExtraBondState	在 Intents 裡當作 int 額外欄位 #ACTION_BOND_STATE_CHANGED 使用。
ExtraClass	作為可 BluetoothClass 分割的額外欄位 #ACTION_FOUND 使用，意圖如此 #ACTION_CLASS_CHANGED 。
ExtraDevice	作為該級每個意圖廣播中的可 BluetoothDevice 分割額外場使用。
ExtraIsCoordinatedSetMember	在意圖中 #ACTION_FOUND 用作布林額外欄位。
ExtraName	作為弦的額外場#ACTION_NAME_CHANGED#ACTION_FOUND域與意圖。
ExtraPairingKey	在 intants 中 #ACTION_PAIRING_REQUEST 用作 int 額外欄位，作為通行金鑰的值。
ExtraPairingVariant	作為int extra field #ACTION_PAIRING_REQUEST 用於int in intents，表示所使用的配對方法。
ExtraPreviousBondState	在 Intents 裡當作 int 額外欄位 #ACTION_BOND_STATE_CHANGED 使用。
ExtraRssi	在意圖中作為可選的短額外欄位 #ACTION_FOUND 使用。
ExtraTransport	在 中用作 int 額外欄位 #ACTION_ACL_CONNECTED， #ACTION_ACL_DISCONNECTED 並 #ACTION_ENCRYPTION_CHANGE 表示連接的傳輸方式。
ExtraUuid	包含 android.os.ParcelUuid遠端裝置的 s，該 s 是 的 UUID可打包版本。
PairingVariantPasskeyConfirmation	使用者會被提示確認螢幕上顯示的通行金鑰，或應用程式會自動確認通行金鑰。
PairingVariantPin	使用者會被要求輸入 PIN 碼，或應用程式會為使用者輸入 PIN 碼。

屬性

名稱	Description
Address	回傳這個藍牙裝置的硬體位址。
AddressType	回傳此藍牙裝置的位址類型，為 #ADDRESS_TYPE_PUBLIC、 #ADDRESS_TYPE_RANDOM、 #ADDRESS_TYPE_ANONYMOUS#ADDRESS_TYPE_UNKNOWN或 。
Alias	取得遠端藍牙裝置的本地可修改名稱（別名）。
BluetoothClass	取得遠端裝置的藍牙類別。
BondState	取得遠端裝置的結合狀態。
Class	回傳此 Object的執行時類別。 (繼承來源 Object)
Creator
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	代表遠端藍牙裝置。 (繼承來源 JavaObject)
JniPeerMembers	代表遠端藍牙裝置。
Name	取得遠端裝置的友善藍牙名稱。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
Type	取得遠端裝置的藍牙裝置類型。

方法

名稱	Description
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, BluetoothPhy, Handler)	連接由此裝置主機託管的 GATT 伺服器。
ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, BluetoothPhy)	連接由此裝置主機託管的 GATT 伺服器。
ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, ScanSettingsPhy, Handler)	已淘汰. 代表遠端藍牙裝置。
ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, ScanSettingsPhy)	已淘汰. 代表遠端藍牙裝置。
ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports)	連接由此裝置主機託管的 GATT 伺服器。
ConnectGatt(Context, Boolean, BluetoothGattCallback)	連接由此裝置主機託管的 GATT 伺服器。
Construct(JniObjectReference, JniObjectReferenceOptions)	代表遠端藍牙裝置。 (繼承來源 JavaObject)
CreateBond()	開始與遠端裝置的綁定（配對）流程。
CreateInsecureL2capChannel(Int32)	建立一個藍牙 L2CAP 連線導向通道（CoC）， BluetoothSocket 可用來啟動與遠端裝置的安全外出連線，且其存取值相同，且其值相同。
CreateInsecureRfcommSocketToServiceRecord(UUID)	建立一個 RFCOMM BluetoothSocket socket，準備使用 SDP 查詢 uuid 來啟動對這個遠端裝置的不安全外出連線。
CreateL2capChannel(Int32)	建立一個藍牙 L2CAP 連線導向通道（CoC）， BluetoothSocket 可用來啟動與遠端裝置的安全外出連線，且其存取值相同，且其值相同。
CreateRfcommSocketToServiceRecord(UUID)	建立一個 RFCOMM BluetoothSocket ，準備使用 SDP 查詢 uuid 來啟動與此遠端裝置的安全外出連線。
DescribeContents()	描述此 Parcelable 的組建表示中包含的特殊物件種類。
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	代表遠端藍牙裝置。 (繼承來源 JavaObject)
Equals(Object)	代表遠端藍牙裝置。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
FetchUuidsWithSdp()	對遠端裝置執行服務發現，以取得 UUID 的支援。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
GetUuids()	回傳遠端裝置所支援的功能（UUID）。
JavaFinalize()	當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
SetAlias(String)	設定遠端藍牙裝置的本地可修改名稱（別名）。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPairingConfirmation(Boolean)	確認配對的 #PAIRING_VARIANT_PASSKEY_CONFIRMATION 通行金鑰。
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	代表遠端藍牙裝置。 (繼承來源 JavaObject)
SetPin(Byte[])	當配對方法為 #PAIRING_VARIANT_PIN
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	把這個物體壓扁成一個包裹。

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	代表遠端藍牙裝置。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	代表遠端藍牙裝置。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	代表遠端藍牙裝置。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	代表遠端藍牙裝置。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	代表遠端藍牙裝置。 (繼承來源 JavaObject)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 self類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	代表遠端藍牙裝置。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。