FlutterBluetoothPluginPlatform class abstract

Flutter 蓝牙插件的平台接口。

面向平台实现者使用：各平台实现需要继承该类并覆盖对应 API。方法参数、默认值、 平台差异和推荐值与主入口 FlutterBluetoothPlugin 保持一致。

Inheritance
  • Object
  • PlatformInterface
  • FlutterBluetoothPluginPlatform
Implementers

Constructors

FlutterBluetoothPluginPlatform()
创建平台接口实例。

Properties

adapterState → Stream<BluetoothAdapterState>
监听蓝牙适配器状态变化。
no setter
advertisingState → Stream<BluetoothAdvertisingStateEvent>
监听 BLE 广播状态。
no setter
bondState → Stream<BluetoothBondStateEvent>
监听配对/绑定状态变化。
no setter
characteristicValues → Stream<BluetoothCharacteristicValue>
监听 GATT 特征通知、指示或读值更新。
no setter
classicConnectionState → Stream<BluetoothClassicConnectionEvent>
监听 Classic Bluetooth 连接状态。
no setter
classicData → Stream<BluetoothClassicDataEvent>
监听 Classic Bluetooth 收到的数据。
no setter
connectionState → Stream<BluetoothConnectionStateEvent>
监听 BLE 连接状态变化。
no setter
descriptorValues → Stream<BluetoothDescriptorValue>
监听 GATT 描述符值变化。
no setter
gattServerRequests → Stream<BluetoothGattServerRequest>
监听本地 GATT Server 请求和状态事件。
no setter
hashCode → int
The hash code for this object.
no setterinherited
mtuUpdates → Stream<BluetoothMtuEvent>
监听 MTU 更新事件。
no setter
phyUpdates → Stream<BluetoothPhyEvent>
监听 PHY 变化。
no setter
rssiUpdates → Stream<BluetoothRssiEvent>
监听 RSSI 读取结果。
no setter
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
scanResults → Stream<BluetoothScanResult>
监听扫描结果。
no setter

Methods

checkPermissions() → Future<Map<String, BluetoothPermissionStatus>>
检查蓝牙相关权限状态，不触发系统授权弹窗。
clearGattServerServices() → Future<void>
清空本地 GATT Server 服务列表。
connect(String deviceId, {bool autoConnect = false, Duration? timeout}) → Future<void>
连接 BLE 设备。
connectClassic({required String deviceId, required String serviceUuid, bool secure = true, Duration? timeout}) → Future<void>
连接 Android Classic Bluetooth RFCOMM 设备。
createBond(String deviceId) → Future<bool>
创建系统配对/绑定。
disconnect(String deviceId) → Future<void>
断开 BLE 连接。
disconnectClassic(String deviceId) → Future<void>
断开 Classic Bluetooth RFCOMM 连接。
discoverServices(String deviceId) → Future<List<BluetoothGattService>>
发现指定 BLE 设备的 GATT 服务。
getAdapterInfo() → Future<BluetoothAdapterInfo>
获取蓝牙适配器信息和平台能力。
getAdapterState() → Future<BluetoothAdapterState>
获取蓝牙适配器当前状态。
getBondedDevices() → Future<List<BluetoothDevice>>
获取已配对/已绑定设备列表。
getConnectedDevices({List<String> serviceUuids = const <String>[]}) → Future<List<BluetoothDevice>>
获取当前已连接设备列表。
getConnectionState(String deviceId) → Future<BluetoothConnectionState>
获取指定设备当前 BLE 连接状态。
getDevice(String deviceId) → Future<BluetoothDevice?>
根据设备 ID 获取设备信息。
getDevices(List<String> deviceIds) → Future<List<BluetoothDevice>>
批量根据设备 ID 获取设备信息。
getMaximumWriteLength(String deviceId, {bool withoutResponse = true}) → Future<int>
获取当前连接可写入的最大字节数。
getPlatformVersion() → Future<String?>
获取当前运行平台版本字符串。
isPeripheralSupported() → Future<bool>
判断当前平台是否支持 BLE 外设/广播模式。
isScanning() → Future<bool>
判断当前是否正在扫描。
isSupported() → Future<bool>
判断当前设备/平台是否支持蓝牙能力。
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
notifyGattServerCharacteristic({String? deviceId, required String serviceUuid, required String characteristicUuid, required List<int> value, bool confirm = false}) → Future<bool>
通过本地 GATT Server 主动通知/指示特征值。
openBluetoothSettings() → Future<void>
打开系统蓝牙相关设置页。
readCharacteristic({required String deviceId, required String serviceUuid, required String characteristicUuid}) → Future<List<int>>
读取 GATT 特征值。
readDescriptor({required String deviceId, required String serviceUuid, required String characteristicUuid, required String descriptorUuid}) → Future<List<int>>
读取 GATT 描述符值。
readPhy(String deviceId) → Future<BluetoothPhyEvent>
读取 BLE 当前 PHY。
readRssi(String deviceId) → Future<int>
读取远端设备 RSSI。
removeBond(String deviceId) → Future<bool>
移除系统配对/绑定。
requestConnectionPriority(String deviceId, BluetoothConnectionPriority priority) → Future<bool>
请求 Android BLE 连接优先级。
requestEnable() → Future<bool>
请求用户开启蓝牙。
requestMtu(String deviceId, int mtu) → Future<int>
请求或读取 BLE MTU/最大写入长度相关值。
requestPermissions() → Future<Map<String, BluetoothPermissionStatus>>
请求蓝牙相关权限。
setAdapterName(String name) → Future<bool>
设置本机蓝牙适配器名称。
setCharacteristicNotification({required String deviceId, required String serviceUuid, required String characteristicUuid, required bool enable}) → Future<void>
开启或关闭 GATT 特征通知/指示。
setGattServerServices(List<BluetoothGattService> services) → Future<void>
设置本地 GATT Server 服务列表。
setPreferredPhy({required String deviceId, required BluetoothPhy txPhy, required BluetoothPhy rxPhy, int phyOptions = 0}) → Future<void>
设置 BLE 连接优先 PHY。
startAdvertising({BluetoothAdvertisementData advertisementData = const BluetoothAdvertisementData(), BluetoothAdvertisementData? scanResponse, BluetoothAdvertisingSettings settings = const BluetoothAdvertisingSettings()}) → Future<void>
开始 BLE 广播。
startClassicServer({required String serviceUuid, String serviceName = 'FlutterBluetoothPlugin', bool secure = true}) → Future<void>
启动 Android Classic Bluetooth RFCOMM 服务端。
startScan({List<String> serviceUuids = const <String>[], Duration? timeout, bool allowDuplicates = false, BluetoothScanMode scanMode = BluetoothScanMode.ble}) → Future<void>
开始扫描附近设备。
stopAdvertising() → Future<void>
停止 BLE 广播。
stopClassicServer() → Future<void>
停止 Android Classic Bluetooth RFCOMM 服务端。
stopScan() → Future<void>
停止当前扫描。
toString() → String
A string representation of this object.
inherited
updateLocalCharacteristicValue({required String serviceUuid, required String characteristicUuid, required List<int> value}) → Future<void>
更新本地 GATT 特征缓存值。
writeCharacteristic({required String deviceId, required String serviceUuid, required String characteristicUuid, required List<int> value, BluetoothWriteType writeType = BluetoothWriteType.withResponse}) → Future<void>
写入 GATT 特征值。
writeClassic(String deviceId, List<int> value) → Future<void>
向 Classic Bluetooth RFCOMM 连接写入数据。
writeDescriptor({required String deviceId, required String serviceUuid, required String characteristicUuid, required String descriptorUuid, required List<int> value}) → Future<void>
写入 GATT 描述符值。

Operators

operator ==(Object other) → bool
The equality operator.
inherited

Static Properties

instance ↔ FlutterBluetoothPluginPlatform
当前使用的平台实现实例。
getter/setter pair