1.接入流程

1.1 支持环境

环境

兼容范围

备注

软件系统

iOS 11.0以上

支持BLE功能

固件SDK

BR23-watch-SDK, BR28-watch-SDK等

建议咨询SDK负责人

开发工具

Xcode15.0以上

建议使用最新版本

1.2 库导入

1.2.1 依赖库

  1. ZipZap.framework ：加压缩文件

1.2.2 导入库

  1. JL_BLEKit.framework : 蓝牙功能库

  2. JLDialUnit.framework : 手表操作

  3. JL_OTALib.framework : OTA升级业务库

  4. JL_AdvParse.framework : 杰理蓝牙设备广播包解析业务库

  5. JL_HashPair.framework ： 设备认证业务库

1.2.3 必要权限

//使用蓝牙权限
    Privacy - Bluetooth Peripheral Usage Description
Privacy - Bluetooth Always Usage Description

1.2.4 Xcode 配置

由于库里包含了扩展类的属性，需要在使用时配置 Other linker Flags

需要在工程的 Build Settings 中的 Other Linker Flags 添加 -ObjC。

../../_images/otherlinkerflags.jpg

1.3 SDK配置

1.3.1 蓝牙中心类初始化

//1、外部的引用
@property(strong,nonatomic) JL_BLEMultiple  *mBleMultiple;
@property(weak  ,nonatomic) JL_EntityM      *mBleEntityM;    //需要Weak引用，断开设备重新搜索，SDK需释放。(作为当前正在操作的设备使用)
@property(strong,nonatomic) NSString        *mBleUUID;
@property(weak  ,nonatomic) NSArray         *mFoundArray; //需要Weak引用，扫描到的设备。
@property(weak  ,nonatomic) NSArray         *mConnectedArray;//需要Weak引用，已连接的设备。

//2、实例化SDK
self.mBleMultiple = [[JL_BLEMultiple alloc] init];
self.mBleMultiple.BLE_FILTER_ENABLE = YES;    //过滤设备使能
self.mBleMultiple.BLE_PAIR_ENABLE = YES;      //配对使能
self.mBleMultiple.BLE_TIMEOUT = 7;            //连接超时时间

//3、选择需要搜索设备类型
self.mBleMultiple.bleDeviceTypeArr = @[@(JL_DeviceTypeWatch)];//只选Watch

//4、SDK搜索到的设备，点击连接后，会加入bleConnectedArr数组中。
//5、调用[self.mBleMultiple scanStart]会释放掉blePeripheralArr的JL_EntityM。
self.mFoundArray = self.mBleMultiple.blePeripheralArr;

//6、SDk已连接上的设备，断开连接后，会加入blePeripheralArr数组中。
self.mConnectedArray = self.mBleMultiple.bleConnectedArr;

//7、用mBleEntityM弱引用mConnectedArray中已连接的一个JL_EntityM设备，此后会用mBleEntity到内的【JL_ManagerM】发命令。

1.3.2 连接设备

//从已发现的设备列表里连接一个。
JL_EntityM *entity = self.mFoundArray[indexPath.row];
/**
 连接设备
@param entity 蓝牙设备类
 */
[self.mBleMultiple connectEntity:entity
                          Result:^(JL_EntityM_Status status) {
    [JL_Tools mainTask:^{
    /*【status】错误码与错误原因
    JL_EntityM_StatusBleOFF         = 0,    //BLE蓝牙未开启
    JL_EntityM_StatusConnectFail    = 1,    //BLE连接失败
    JL_EntityM_StatusConnecting     = 2,    //BLE正在连接
    JL_EntityM_StatusConnectRepeat  = 3,    //BLE重复连接
    JL_EntityM_StatusConnectTimeout = 4,    //BLE连接超时
    JL_EntityM_StatusConnectRefuse  = 5,    //BLE被拒绝
    JL_EntityM_StatusPairFail       = 6,    //配对失败
    JL_EntityM_StatusPairTimeout    = 7,    //配对超时
    JL_EntityM_StatusPaired         = 8,    //已配对
    JL_EntityM_StatusMasterChanging = 9,    //正在主从切换
    JL_EntityM_StatusDisconnectOk   = 10,   //已断开成功
    JL_EntityM_StatusNull           = 11,   //Entity为空 */

     if (status == JL_EntityM_StatusPaired) {
        NSString *txt = [NSString stringWithFormat:@"连接成功:%@",deviceName];
     }else{
        NSString *txt = [NSString stringWithFormat:@"连接失败:%@",deviceName];
     }
    }];
}];

/*--- 注意事项
//mBleEntityM在文档1.3.1里有介绍；
//连接成功后必须先获取设备信息；
[self.mBleEntityM.mCmdManager cmdTargetFeatureResult:^(NSArray *array) {
    JL_CMDStatus st = [array[0] intValue];
    if (st == JL_CMDStatusSuccess) {
          /*--- 设备信息的model ---*/
    JLModel_Device *model = [self.mBleEntityM.mCmdManager outputDeviceModel];
          NSLog(@"获取成功。");
    }else{
          NSLog(@"获取失败。");
    }
}];

1.3.3 断开设备

/**
 连接设备
 @param entity 蓝牙设备类
 */
[self.mBleMultiple disconnectEntity:entity Result:^(JL_EntityM_Status status) {
[JL_Tools mainTask:^{
    if (status == JL_EntityM_StatusDisconnectOk) {
           NSString *txt = [NSString stringWithFormat:@"已断开:%@",deviceName];
    }
 }];
}];

1.3.4 MAC地址回连设备

[self.mBleMultiple connectEntityForMac:@"Mac地址" Result:^(JL_EntityM_Status status) {
   [JL_Tools mainTask:^{
      if (status == JL_EntityM_StatusPaired) {
          NSLog(@"----> 回连设备成功。");
      }else{
          NSLog(@"----> 回连设备成功失败。");
          }
    }];
  }];

1.3.5 UUID回连设备

//根据UUID找到对应的JL_EntityM连接。
JL_EntityM *entity = [bleMp makeEntityWithUUID:@"UUID-xxxx-xxxx-xxxx-xxxx"];

/*--- 1、直接UUID连接设备 ---*/
[self.mBleMultiple connectEntity:entity Result:^(JL_EntityM_Status status){
    [JL_Tools mainTask:^{
        if (status == JL_EntityM_StatusPaired) {
            NSLog(@"----> UUID回连设备成功。");
        }else{
            NSLog(@"----> 回连设备成功失败。");
        }
    }];
}];

1.3.6 蓝牙连接成功后的初始化

//收到kJL_BLE_M_ENTITY_CONNECTED通知,做以下处理:
/*--- 关闭耳机信息推送 ---*/
[self.mBleEntityM.mCmdManager.mTwsManager cmdHeadsetAdvEnable:NO];

/*--- 同步时间戳 ---*/
NSDate *date = [NSDate new];
JL_SystemTime *systemTime = self.mBleEntityM.mCmdManager.mSystemTime;
[systemTime cmdSetSystemTime:date];

/*--- 清理设备音乐缓存 ---*/
[self.mBleEntityM.mCmdManager.mFileManager cmdCleanCacheType:JL_CardTypeUSB];
[self.mBleEntityM.mCmdManager.mFileManager cmdCleanCacheType:JL_CardTypeSD_0];
[self.mBleEntityM.mCmdManager.mFileManager cmdCleanCacheType:JL_CardTypeSD_1];

__weak typeof(self) wSelf = self;
/*--- 获取设备信息 ---*/
[self.mBleEntityM.mCmdManager cmdTargetFeatureResult:^(JL_CMDStatus status,uint8_t sn,NSData *_Nullable data){
        JL_CMDStatus st = status;
        if(st == JL_CMDStatusSuccess){
            [wSelf startTimeout];

          JLModel_Device *model = [wSelf.mBleEntityM.mCmdManager outputDeviceModel];
         JL_OtaStatus upSt = model.otaStatus;
         if(upSt == JL_OtaStatusForce){
             wSelf.mBleEntityM.mBLE_NEED_OTA = YES;
             return;
}else{
   if(model.otaHeadset == JL_OtaHeadsetYES){
     wSelf.mBleEntityM.mBLE_NEED_OTA = YES;
     return;
}
}
wSelf.mBleEntityM.mBLE_NEED_OTA = NO;

/*--- 共有信息 ---*/
        [wSelf.mBleEntityM.mCmdManager cmdGetSystemInfo:JL_FunctionCodeCOMMON Result:^(JL_CMDStatus status,uint8_t sn,NSData *_Nullable data){
            [wSelf.mBleEntityM.mCmdManager cmdGetSystemInfo:JL_FunctionCodeBT Result:^(JL_CMDStatus status,uint8_t sn,NSData *_Nullable data){

        }];
     }];
   }
}];

1.3.7 监听发现、连接、断开、蓝牙状态等通知回调

extern NSString *kJL_BLE_M_FOUND;               //1、发现设备
extern NSString *kJL_BLE_M_FOUND_SINGLE;        //2、发现单个设备
extern NSString *kJL_BLE_M_ENTITY_CONNECTED;    //3、设备连接
extern NSString *kJL_BLE_M_ENTITY_DISCONNECTED; //4、设备断开
extern NSString *kJL_BLE_M_ON;                  //5、BLE开启
extern NSString *kJL_BLE_M_OFF;                 //6、BLE关闭
extern NSString *kJL_BLE_M_EDR_CHANGE;          //7、经典蓝牙输出通道变化
//监听第1、3、4点通知，查看mBleMultiple.blePeripheralArr数组元素变化，更新UI界面。
//监听第5点通知，则知道当前经典蓝牙连接的变化，回调经典蓝牙信息：
            @{@"ADDRESS":@"7c9a1da7330e",      //经典蓝牙地址
            @"TYPE"   :@"BluetoothA2DPOutput", //类型
            @"NAME"   :@"earphone"}            //名字