discoverDescriptorsForCharacteristic

2022-06-20 11:42 更新

根据指定的外围设备 UUID 及其服务 UUID 和特征 UUID 获取该外围设备的所有描述符(Descriptor)

discoverDescriptorsForCharacteristic({params}, callback(ret, err))

params

peripheralUUID:

  • 类型:字符串
  • 描述:指定的蓝牙外围设备的 UUID

serviceUUID

  • 类型:字符串
  • 描述:指定的服务的 UUID

characteristicUUID

  • 类型:字符串
  • 描述:指定的特征的 UUID

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:

{
     status: true ,      //布尔类型;是否读取成功,true|false
     descriptors:[{      //数组类型;获取的所有描述符信息的集合
        uuid: '',        //字符串类型;描述符的 UUID 
        serviceUUID: '', //字符串类型;服务的 UUID 
        characteristicUUID:'',//字符串类型;特征的 UUID 
        decode: ,        //布尔类型;描述符的值是否是二进制类型数据
        value:           //字符串类型;描述符的值,若 decode 为 true,则该值为转码后的值
     }]      
}

err:

  • 类型:JSON 对象
  • 内部字段:

{
     code: 1          //数字类型;连接失败时返回错误码,取值范围如下:
                      //-1:未知错误
                      //1:peripheralUUID 为空
                      //2:serviceUUID 为空
                      //3:characteristicUUID 为空
                      //4:未找到指定特征(characteristic)
                      //5:未找到指定服务(service)
                      //6:尚未搜索到该蓝牙设备
}

示例代码

var ble = api.require('ble');
ble.discoverDescriptorsForCharacteristic({
    peripheralUUID: '',
    serviceUUID: '',
    characteristicUUID: ''
}, function(ret) {
    if (ret) {
        api.alert({ msg: JSON.stringify(ret) });
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号