语言

BluetoothAdapter 类

定义

表示本地设备蓝牙适配器。

[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
特性

注解

表示本地设备蓝牙适配器。 这样 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

额外使用者 #ACTION_CONNECTION_STATE_CHANGED

        This extra represents the current connection state.
ExtraDiscoverableDuration

用作意向中的 #ACTION_REQUEST_DISCOVERABLE 可选 int 额外字段,以请求特定持续时间(以秒为单位)。

ExtraLocalName

用作意向中 #ACTION_LOCAL_NAME_CHANGED 用于请求本地蓝牙名称的字符串额外字段。

ExtraPreviousConnectionState

额外使用者 #ACTION_CONNECTION_STATE_CHANGED

        This extra represents the previous connection state.
ExtraPreviousScanMode

用作意向中 #ACTION_SCAN_MODE_CHANGED 用于请求上一扫描模式的 int extra 字段。

ExtraPreviousState

用作意向中 #ACTION_STATE_CHANGED 用于请求上一个电源状态的 int extra 字段。

ExtraScanMode

用作意向中 #ACTION_SCAN_MODE_CHANGED 用于请求当前扫描模式的 int extra 字段。

ExtraState

用作意向中 #ACTION_STATE_CHANGED 用于请求当前电源状态的 int extra 字段。

属性

名称 说明
Address

返回本地蓝牙适配器的硬件地址。

BluetoothLeAdvertiser

返回 BluetoothLeAdvertiser 蓝牙 LE 广告操作的对象。

BluetoothLeScanner

返回 BluetoothLeScanner 蓝牙 LE 扫描操作的对象。

BondedDevices

将绑定(配对)的对象集 BluetoothDevice 返回到本地适配器。

Class

返回此 Object的运行时类。

(继承自 Object)
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[])

BluetoothDevice获取给定蓝牙硬件地址的对象。

GetRemoteDevice(String)

BluetoothDevice获取给定蓝牙硬件地址的对象。

GetRemoteLeDevice(String, Int32)

获取给定蓝牙硬件地址和 addressType 的 BluetoothDevice 对象。

IsLeAudioBroadcastAssistantSupported()

返回 BluetoothStatusCodes#FEATURE_SUPPORTED 是否支持 LE 音频广播助手功能、 BluetoothStatusCodes#FEATURE_NOT_SUPPORTED 不支持该功能或错误代码。

IsLeAudioBroadcastSourceSupported()

返回 BluetoothStatusCodes#FEATURE_SUPPORTED 是否支持 LE 音频广播源功能、 BluetoothStatusCodes#FEATURE_NOT_SUPPORTED 不支持该功能或错误代码。

IsLeAudioSupported()

返回 BluetoothStatusCodes#FEATURE_SUPPORTED 是否支持 LE 音频功能、 BluetoothStatusCodes#FEATURE_NOT_SUPPORTED 不支持该功能或错误代码。

IsLeHighDataThroughputPhySupported()

检查是否支持 LE 高数据吞吐量 (HDT) PHY。

JavaFinalize()
已过时.

当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。

(继承自 Object)
ListenUsingInsecureL2capChannel()

创建不安全的 L2CAP 连接导向通道(CoC), BluetoothServerSocket 并分配动态 PSM 值。

ListenUsingInsecureRfcommWithServiceRecord(String, UUID)

使用服务记录创建侦听、不安全的 RFCOMM 蓝牙套接字。

ListenUsingL2capChannel()

创建安全的面向 L2CAP 连接的通道(CoC), BluetoothServerSocket 并分配动态协议/服务多路复用器(PSM)值。

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()

将此对等方标记为已释放,并将disposing调用Dispose设置为 true.

(继承自 JavaObject)
IJavaPeerable.Finalized()

将此对等方标记为已释放,并将disposing调用Dispose设置为 false.

(继承自 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

获取此对等方使用的本机控制块指针。

(继承自 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

存储运行时提供的标识哈希代码。

(继承自 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

替换存储的托管对等状态标志。

(继承自 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

更新对等引用,并在引用无效时释放已释放的对等方控制块。

(继承自 JavaObject)

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

获取实例 self类型的 JNI 名称。

JavaAs<TResult>(IJavaPeerable)

尝试强制self键入TResult,检查强制是否在Java端有效。

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

重复使用兼容的托管对等,或获取请求类型的包装器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

尝试强制self键入TResult,检查强制是否在Java端有效。

适用于