BluetoothAdapter 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示本地设备蓝牙适配器。
[Android.Runtime.Register("android/bluetooth/BluetoothAdapter", DoNotGenerateAcw=true)]
public sealed class BluetoothAdapter : Java.Lang.Object
[<Android.Runtime.Register("android/bluetooth/BluetoothAdapter", DoNotGenerateAcw=true)>]
type BluetoothAdapter = class
inherit Object
- 继承
- 特性
注解
表示本地设备蓝牙适配器。 这样 BluetoothAdapter ,便可以执行基本的蓝牙任务,例如启动设备发现、查询已绑定(配对)设备列表、使用已知的 MAC 地址实例 BluetoothDevice 化、创建 BluetoothServerSocket 侦听来自其他设备的连接请求,并开始扫描蓝牙 LE 设备。
若要获取BluetoothAdapter表示本地蓝牙适配器,请打开BluetoothManager#getAdapter该BluetoothManager函数。 在JELLY_BEAN_MR1和下方,需要改用静态 #getDefaultAdapter 方法。
从根本上讲,这是所有蓝牙操作的起点。 获得本地适配器后,可以获取一组BluetoothDevice对象,表示所有配对设备#getBondedDevices();使用设备发现#startDiscovery()启动;或者创建一个BluetoothServerSocket侦听传入 RFComm 连接请求#listenUsingRfcommWithServiceRecord(String, UUID);侦听传入的 L2CAP 连接定向通道(CoC)连接请求#listenUsingL2capChannel();或者使用扫描程序BluetoothLeScanner#startScan(ScanCallback)开始扫描蓝牙 LE 设备#getBluetoothLeScanner()。
此类是线程安全的。 <div class=“special reference”>
<h3>开发人员指南</h3>
有关使用蓝牙的详细信息,请阅读 蓝牙 开发人员指南。 </div>
Java文档android.bluetooth.BluetoothAdapter。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
字段
| 名称 | 说明 |
|---|---|
| ActionConnectionStateChanged |
用于将本地蓝牙适配器的连接状态更改广播到远程设备的配置文件的意向。 |
| ActionDiscoveryFinished |
广播操作:本地蓝牙适配器已完成设备发现过程。 |
| ActionDiscoveryStarted |
广播操作:本地蓝牙适配器已启动远程设备发现过程。 |
| ActionLocalNameChanged |
广播操作:本地蓝牙适配器已更改其友好蓝牙名称。 |
| ActionRequestDiscoverable |
活动操作:显示请求可发现模式的系统活动。 |
| ActionRequestEnable |
活动操作:显示允许用户打开蓝牙的系统活动。 |
| ActionScanModeChanged |
广播操作:指示本地适配器的蓝牙扫描模式已更改。 |
| ActionStateChanged |
广播操作:本地蓝牙适配器的状态已更改。 |
| Error |
此类的 Sentinel 错误值。 |
| ExtraConnectionState |
额外使用者
|
| ExtraDiscoverableDuration |
用作意向中的 |
| ExtraLocalName |
用作意向中 |
| ExtraPreviousConnectionState |
额外使用者
|
| ExtraPreviousScanMode |
用作意向中 |
| ExtraPreviousState |
用作意向中 |
| ExtraScanMode |
用作意向中 |
| ExtraState |
用作意向中 |
属性
| 名称 | 说明 |
|---|---|
| Address |
返回本地蓝牙适配器的硬件地址。 |
| BluetoothLeAdvertiser |
返回 |
| BluetoothLeScanner |
返回 |
| BondedDevices |
将绑定(配对)的对象集 |
| Class |
返回此 |
| DefaultAdapter |
获取默认本地蓝牙适配器的句柄。 |
| DiscoverableTimeout |
获取SCAN_MODE_CONNECTABLE_DISCOVERABLE的超时持续时间。 |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| IsDiscovering |
如果本地蓝牙适配器当前处于设备发现过程中,则返回 true。 |
| IsEnabled |
如果蓝牙当前已启用且可供使用,则返回 true。 |
| IsLe2MPhySupported |
如果支持 LE 2M PHY 功能,则返回 true。 |
| IsLeCodedPhySupported |
如果支持 LE 编码 PHY 功能,则返回 true。 |
| IsLeExtendedAdvertisingSupported |
如果支持 LE 扩展广告功能,则返回 true。 |
| IsLePeriodicAdvertisingSupported |
如果支持 LE 定期广告功能,则返回 true。 |
| IsMultipleAdvertisementSupported |
如果芯片集支持多播发,则返回 true |
| IsOffloadedFilteringSupported |
如果支持卸载的筛选器,则返回 true |
| IsOffloadedScanBatchingSupported |
如果支持卸载的扫描批处理,则返回 true |
| JniIdentityHashCode |
获取互操作运行时分配给此Java对等的标识哈希代码。 (继承自 Object) |
| JniManagedPeerState |
获取运行时上次分配的状态标志。 (继承自 JavaObject) |
| JniPeerMembers |
获取用于访问此Java绑定成员的 JNI 元数据。 |
| LeMaximumAdvertisingDataLength |
如果支持 LE 扩展广告功能,则返回最大 LE 广告数据长度(以字节为单位),否则返回 0。 |
| MaxConnectedAudioDevices |
获取此设备的每个音频配置文件的最大连接设备数。 |
| Name |
获取本地蓝牙适配器的友好蓝牙名称。 |
| PeerReference |
获取此Java对等方的 JNI 对象引用。 (继承自 Object) |
| ScanMode |
获取本地蓝牙适配器的当前蓝牙扫描模式。 |
| State |
获取本地蓝牙适配器的当前状态。 |
| ThresholdClass |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 (继承自 Object) |
| ThresholdType |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 (继承自 Object) |
方法
| 名称 | 说明 |
|---|---|
| CancelDiscovery() |
取消当前设备发现过程。 |
| CheckBluetoothAddress(String) |
验证字符串蓝牙地址,例如“00:43:A8:23:10:F0” |
| Clone() |
创建并返回此对象的副本。 (继承自 Object) |
| CloseProfileProxy(ProfileType, IBluetoothProfile) |
关闭配置文件代理与服务的连接。 |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
将此对等方的构造委托给运行时的值管理器。 (继承自 JavaObject) |
| Disable() |
关闭本地蓝牙适配器—如果不使用显式用户操作即可关闭蓝牙。 |
| Dispose() |
释放此Java对等方持有的资源。 (继承自 Object) |
| Dispose(Boolean) |
释放此Java对等方持有的资源。 (继承自 Object) |
| DisposeUnlessReferenced() |
要求值管理器释放此对等方,除非其映射保留此相同的托管实例。 (继承自 JavaObject) |
| Enable() |
打开本地蓝牙适配器—如果不使用显式用户操作即可打开蓝牙。 |
| Equals(Object) |
测试另一个托管对等方是否引用同一Java对象。 (继承自 JavaObject) |
| Equals(Object) |
指示其他对象是否“等于”此对象。 (继承自 Object) |
| GetHashCode() |
返回对象的哈希代码值。 (继承自 Object) |
| GetProfileConnectionState(ProfileType) |
获取配置文件的当前连接状态。 |
| GetProfileProxy(Context, IBluetoothProfileServiceListener, ProfileType) |
获取与配置文件关联的配置文件代理对象。 |
| GetRemoteDevice(Byte[]) |
|
| GetRemoteDevice(String) |
|
| GetRemoteLeDevice(String, Int32) |
获取给定蓝牙硬件地址和 addressType 的 BluetoothDevice 对象。 |
| IsLeAudioBroadcastAssistantSupported() |
返回 |
| IsLeAudioBroadcastSourceSupported() |
返回 |
| IsLeAudioSupported() |
返回 |
| IsLeHighDataThroughputPhySupported() |
检查是否支持 LE 高数据吞吐量 (HDT) PHY。 |
| JavaFinalize() |
已过时.
当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。 (继承自 Object) |
| ListenUsingInsecureL2capChannel() |
创建不安全的 L2CAP 连接导向通道(CoC), |
| ListenUsingInsecureRfcommWithServiceRecord(String, UUID) |
使用服务记录创建侦听、不安全的 RFCOMM 蓝牙套接字。 |
| ListenUsingL2capChannel() |
创建安全的面向 L2CAP 连接的通道(CoC), |
| ListenUsingRfcommWithServiceRecord(String, UUID) |
使用服务记录创建侦听的安全 RFCOMM 蓝牙套接字。 |
| ListenUsingSocketSettings(BluetoothSocketSettings) |
使用指定的套接字设置 BluetoothSocketSettings 为蓝牙连接创建侦听服务器通道。 |
| Notify() |
唤醒正在等待此对象的监视器的单个线程。 (继承自 Object) |
| NotifyAll() |
唤醒正在等待此对象的监视器的所有线程。 (继承自 Object) |
| SetHandle(IntPtr, JniHandleOwnership) |
设置 Handle 属性。 (继承自 Object) |
| SetName(String) |
设置本地蓝牙适配器的友好蓝牙名称。 |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。 (继承自 JavaObject) |
| StartDiscovery() |
启动远程设备发现过程。 |
| StartLeScan(BluetoothAdapter+ILeScanCallback) |
已过时.
启动蓝牙 LE 设备的扫描。 |
| StartLeScan(UUID[], BluetoothAdapter+ILeScanCallback) |
已过时.
启动蓝牙 LE 设备的扫描。 |
| StopLeScan(BluetoothAdapter+ILeScanCallback) |
已过时.
停止正在进行的蓝牙 LE 设备扫描。 |
| ToArray<T>() |
从此Java数组包装器创建托管数组。 (继承自 Object) |
| ToString() |
返回对象的字符串表示形式。 (继承自 Object) |
| UnregisterFromRuntime() |
从互操作运行时取消注册此Java对等。 (继承自 Object) |
| Wait() |
导致当前线程等待,直到它被唤醒,通常是通过 通知 或 中断。 (继承自 Object) |
| Wait(Int64, Int32) |
使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64) |
使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。 (继承自 Object) |
显式接口实现
| 名称 | 说明 |
|---|---|
| IJavaPeerable.Disposed() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.Finalized() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.JniObjectReferenceControlBlock |
获取此对等方使用的本机控制块指针。 (继承自 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
存储运行时提供的标识哈希代码。 (继承自 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
替换存储的托管对等状态标志。 (继承自 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
更新对等引用,并在引用无效时释放已释放的对等方控制块。 (继承自 JavaObject) |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
重复使用兼容的托管对等,或获取请求类型的包装器。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |