基础库版本 >= 3.73.0 支持。
获取蓝牙低功耗设备所有服务 (service)。
参数说明
Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 | 版本 |
|---|
| deviceId | string | | 是 | 蓝牙设备 id。需要已经通过 bl.createBLEConnection 建立连接 | 3.73.0 |
| success | function | | 否 | 接口调用成功的回调函数 | 3.73.0 |
| fail | function | | 否 | 接口调用失败的回调函数 | 3.73.0 |
| complete | function | | 否 | 接⼝调⽤结束的回调函数（调⽤成功、失败都会执⾏） | 3.73.0 |
success参数说明
Object res
| 属性 | 类型 | 说明 | 版本 |
|---|
| services | Array. <Object> | 设备服务列表 | |
Object services
| 属性 | 类型 | 说明 | 版本 |
|---|
| uuid | string | 蓝牙设备服务的 UUID | |
| isPrimary | boolean | 该服务是否为主服务 | |
示例代码
bl.getBLEDeviceServices({
deviceId,
success (res) {
console.log('device services:', res.services)
}
})
错误异常
| 错误码 | 错误信息 | 场景 |
|---|
| 0 | ok | 正常 |
| -1 | already connect | 已连接 |
| 10000 | not init | 未初始化蓝牙适配器 |
| 10001 | not available | 当前蓝牙适配器不可用 |
| 10002 | no device | 没有找到指定设备 |
| 10003 | connection fail | 连接失败 |
| 10004 | no service | 没有找到指定服务 |
| 10005 | no characteristic | 没有找到指定特征 |
| 10006 | no connection | 当前连接已断开 |
| 10007 | property not support | 当前特征不支持此操作 |
| 10008 | system error | 其余所有系统上报的异常 |
| 10009 | system not support | Android 系统特有，系统版本低于 4.3 不支持 BLE |
| 10012 | operate time out | 连接超时 |
| 10013 | invalid_data | 连接 deviceId 为空或者是格式不正确 |
| 10014 | invalid param | 参数不正确 |
