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()一组绑定设备中获取一个。 然后,可以使用蓝牙 BR/EDR 或使用BluetoothSocket蓝牙 LE 打开#createRfcommSocketToServiceRecord(UUID)与远程设备的#createL2capChannel(int)通信。
<div class=“special reference”>
<h3>开发人员指南</h3>
有关使用蓝牙的详细信息,请阅读 蓝牙 开发人员指南。 </Div>
适用于 . 的 android.bluetooth.BluetoothDeviceJava 文档
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。
字段
| 名称 | 说明 |
|---|---|
| ActionAclConnected |
广播操作:指示已与远程设备建立低级别(ACL)连接。 |
| ActionAclDisconnected |
广播操作:指示与远程设备断开连接的低级别(ACL)。 |
| ActionAclDisconnectRequested |
广播操作:指示远程设备请求了低级别(ACL)断开连接,并且很快会断开连接。 |
| ActionAliasChanged |
广播操作:指示远程设备的别名已更改。 |
| ActionBondStateChanged |
广播操作:指示远程设备的绑定状态发生更改。 |
| ActionClassChanged |
广播操作:远程设备的蓝牙类已更改。 |
| ActionEncryptionChange |
广播操作:指示加密状态已更改 |
| ActionFound |
广播操作:发现远程设备。 |
| ActionKeyMissing |
广播操作:指示以前绑定的设备无法提供用于建立加密的密钥。 |
| ActionLeAppearanceChanged |
如果 LE 外观值尚未知道或更改,则会在建立 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 |
此类的 Sentinel 错误值。 |
| ExtraBondLossReason |
包含债券损失的原因。 |
| ExtraBondState |
用作意向中的 |
| ExtraClass |
用作可 |
| ExtraDevice |
用作此类广播的每个意向中的可 |
| ExtraDiscoveryResultType |
用作意向中的 |
| ExtraEncryptionAlgorithm |
用作意向中的 |
| ExtraEncryptionEnabled |
用作意向中的 |
| ExtraEncryptionStatus |
用作意向中的 |
| ExtraIsCoordinatedSetMember |
用作意向中的 |
| ExtraKeySize |
用作意向中的 |
| ExtraLeAppearance |
用作ACTION_FOUND、ACTION_LE_APPEARANCE_CHANGED意向和音频相关配置文件ACTION_*_CONNECTION_STATE_CHANGED意向中的整数额外字段。 |
| ExtraName |
用作字符串额外字段 |
| ExtraPairingAlgorithm |
用作意向中的 |
| ExtraPairingContext |
用作指示配对上下文的 int extra 字段 |
| ExtraPairingKey |
用作意向中的 |
| ExtraPairingVariant |
用作意向中的 |
| ExtraPreviousBondState |
用作意向中的 |
| ExtraRssi |
用作意向中的 |
| ExtraTransport |
用作 int extra 字段 |
| ExtraUuid |
包含 |
| ExtraUuidLe |
包含 |
| LeAppearanceUnknown |
指示设备的 LE 外观未知的值。 |
| PairingAlgorithmBredrLegacy |
已过时.
指示 BR/EDR 旧版配对算法的用法。 |
| PairingAlgorithmBredrSsp |
已过时.
指示 BR/EDR 安全简单配对 (SSP) 算法的用法。 |
| PairingAlgorithmLeLegacy |
已过时.
指示 LE 旧版配对算法的用法。 |
| PairingAlgorithmSc |
已过时.
指示安全连接配对算法的使用,适用于 BR/EDR 和 LE 传输。 |
| PairingContextRepairing |
向自治系统发起的重新配对过程发出信号。 |
| PairingContextUserApprovalRequested |
指示已启动配对过程,并请求用户批准以完成配对过程。 |
| PairingContextUserParticipationRequested |
指示用户参与以开始 LE 旧版配对过程的请求。 |
| PairingVariantPasskeyConfirmation |
系统将提示用户确认屏幕上显示的通行密钥,或者应用将确认用户的通行密钥。 |
| PairingVariantPin |
系统将提示用户输入 pin,或者应用将为用户输入 pin。 |
| PhyLeHdt |
已过时.
蓝牙 LE HDT PHY。 |
| PhyLeHdtMask |
已过时.
蓝牙 LE HDT PHY 掩码。 |
属性
| 名称 | 说明 |
|---|---|
| Address |
返回此 BluetoothDevice 的硬件地址。 |
| AddressType |
返回此 BluetoothDevice 的地址类型、其中 |
| Alias |
获取远程蓝牙设备的本地可修改名称(别名)。 |
| BluetoothClass |
获取远程设备的蓝牙类。 |
| BondState |
此 API 返回远程设备的绑定状态。 |
| Class |
返回此 |
| Creator | |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| IdentityAddressWithType |
返回此 BluetoothDevice 的标识地址和标识地址类型。 |
| JniIdentityHashCode |
获取互操作运行时分配给此Java对等的标识哈希代码。 (继承自 Object) |
| JniManagedPeerState |
表示远程蓝牙设备。 (继承自 JavaObject) |
| JniPeerMembers |
表示远程蓝牙设备。 |
| KeyMissingCount |
获取自上次成功加密连接以来为此设备引发意向的次数 |
| LeAppearance |
获取远程设备的蓝牙 LE 外观。 |
| Name |
获取远程设备的友好蓝牙名称。 |
| PeerReference |
获取此Java对等方的 JNI 对象引用。 (继承自 Object) |
| ThresholdClass |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 (继承自 Object) |
| ThresholdType |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 (继承自 Object) |
| Type |
获取远程设备的蓝牙设备类型。 |
方法
| 名称 | 说明 |
|---|---|
| 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) |
已过时.
表示远程蓝牙设备。 |
| ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, ScanSettingsPhy) |
已过时.
表示远程蓝牙设备。 |
| 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) |
使用 Uuid 的 SDP 查找创建一个 RFCOMM |
| CreateUsingSocketSettings(BluetoothSocketSettings) |
创建客户端套接字以使用指定的套接字设置 |
| DescribeContents() |
描述此 Parcelable 封送表示形式中包含的特殊对象类型。 |
| Disconnect() |
断开本地和远程设备之间所有连接的蓝牙配置文件的连接。 |
| DisconnectAcl(BluetoothTransports) |
断开此设备的 ACL 链接的连接。 |
| Dispose() |
释放此Java对等方持有的资源。 (继承自 Object) |
| Dispose(Boolean) |
释放此Java对等方持有的资源。 (继承自 Object) |
| DisposeUnlessReferenced() |
表示远程蓝牙设备。 (继承自 JavaObject) |
| Equals(Object) |
表示远程蓝牙设备。 (继承自 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) |
表示远程蓝牙设备。 (继承自 JavaObject) |
| SetPin(Byte[]) |
在配对方法为 |
| ToArray<T>() |
从此Java数组包装器创建托管数组。 (继承自 Object) |
| ToString() |
返回对象的字符串表示形式。 (继承自 Object) |
| UnregisterFromRuntime() |
从互操作运行时取消注册此Java对等。 (继承自 Object) |
| Wait() |
使当前线程等待,直到唤醒它,通常是通过 em 通知/em< 或 >em<interrupted>/em<。><> (继承自 Object) |
| Wait(Int64, Int32) |
使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64) |
使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。 (继承自 Object) |
| WriteToParcel(Parcel, ParcelableWriteFlags) |
将此对象平展到一个地块。 |
显式接口实现
| 名称 | 说明 |
|---|---|
| IJavaPeerable.Disposed() |
表示远程蓝牙设备。 (继承自 JavaObject) |
| IJavaPeerable.Finalized() |
表示远程蓝牙设备。 (继承自 JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
表示远程蓝牙设备。 (继承自 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
表示远程蓝牙设备。 (继承自 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
表示远程蓝牙设备。 (继承自 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
表示远程蓝牙设备。 (继承自 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
表示远程蓝牙设备。 |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
表示远程蓝牙设备。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |