Flutter蓝牙LE OTS管理插件flutter_ble_ots的使用

Flutter蓝牙LE OTS管理插件flutter_ble_ots的使用

特性

• 使用OTS协议简化与蓝牙设备的复杂交互。
• 可以与多种BLE包（如flutter_reactive_ble或flutter_blue_plus）配合使用。
• 提供了简便的方法来读取、写入和执行设备ID上的操作。
• 在底层处理元数据检索和通信细节。

使用方法

1. 导入该包：

   import 'package:flutter_ble_ots/flutter_ble_ots.dart';
   

2. 实现BleDeviceInteractor接口。例如，使用flutter_reactive_ble。查看示例文件夹中的示例实现。

   import 'package:flutter_ble_ots/flutter_ble_ots.dart';
   import 'package:flutter_reactive_ble/flutter_reactive_ble.dart';
   
   class BleDeviceInteractorImpl extends BleDeviceInteractor {
     final FlutterReactiveBle _ble;
   
     BleDeviceInteractorImpl(this._ble);
   
     QualifiedCharacteristic _getReactiveCharacteristicFromCommon(CommonCharacteristic char) => 
       QualifiedCharacteristic(
         characteristicId: Uuid(char.characteristicId),
         serviceId: Uuid(char.serviceId),
         deviceId: char.deviceId,
       );
   
     ConnectionPriority _getReactivePriorityFromCommon(CommonConnectionPriority prio) {
       switch (prio) {
         case CommonConnectionPriority.balanced:
           return ConnectionPriority.balanced;
         case CommonConnectionPriority.highPerformance:
           return ConnectionPriority.highPerformance;
         case CommonConnectionPriority.lowPower:
           return ConnectionPriority.lowPower;
       }
     }
   
     @override
     Future<List<int>> readCharacteristic(CommonCharacteristic characteristic) => 
       _ble.readCharacteristic(_getReactiveCharacteristicFromCommon(characteristic));
   
     @override
     Future<void> requestConnectionPriority(CommonConnectionPriority priority, String deviceId) => 
       _ble.requestConnectionPriority(deviceId: deviceId, priority: _getReactivePriorityFromCommon(priority));
   
     @override
     Future<int> requestMtu(int mtu, String deviceId) => _ble.requestMtu(deviceId: deviceId, mtu: mtu);
   
     @override
     Stream<List<int>> subscribeToCharacteristic(CommonCharacteristic characteristic) => 
       _ble.subscribeToCharacteristic(_getReactiveCharacteristicFromCommon(characteristic));
   
     @override
     Future<void> writeCharacteristicWithResponse(CommonCharacteristic characteristic, List<int> value) => 
       _ble.writeCharacteristicWithResponse(_getReactiveCharacteristicFromCommon(characteristic), value: value);
   
     @override
     Future<void> writeCharacteristicWithoutResponse(CommonCharacteristic characteristic, List<int> value) => 
       _ble.writeCharacteristicWithoutResponse(_getReactiveCharacteristicFromCommon(characteristic), value: value);
   }
   

3. 创建一个BleOtsWrapper实例：

   final bleWrapper = BleOtsWrapper(
     deviceId,
     bleDeviceInteractor,
     logMessageCallback,
     metaDataUuids,
     getNameFromUuidCallback,
   );
   

4. 初始化包装器，调用init()方法：

   await bleWrapper.init();
   

5. 开始使用包提供的简化方法：

   final supportedUuids = await bleWrapper.getListOfSupportedUuids();
   final data = await bleWrapper.readDataFromId(id);
   final success = await bleWrapper.writeDataToId(id, value);
   final result = await bleWrapper.executeId(id);
   

元数据UUIDs

为了使用OTS协议与蓝牙设备通信，你需要提供设备的元数据UUIDs。这些UUIDs应由蓝牙设备制造商定义，并可以作为MetaDataUuids实例提供：

MetaDataUuids(
    featureDiscoveryUuid: Uuid.parse('2abd').data,
    oacpUuid: Uuid.parse('2ac5').data,
    objectIdUuid: Uuid.parse('2ac3').data,
    objectNameUuid: Uuid.parse('2abe').data,
    objectPropertiesUuid: Uuid.parse('2ac4').data,
    objectSizeUuid: Uuid.parse('2ac0').data,
    olcpUuid: Uuid.parse('2ac6').data,
    otsUuid: Uuid.parse('1825').data,
    transmissionUuid: Uuid.parse('3bc9').data,
)