retrievePeripheral

根据 UUID 找到所有匹配的蓝牙外围设备信息Android 平台暂不支持本接口

retrievePeripheral({params}, callback(ret))

params

peripheralUUIDs：

• 类型：字符串
• 描述：指定的蓝牙外围设备的 UUID 组成的数组

callback(ret)

ret：

• 类型：JSON 对象
• 描述：若没有则返回空
• 内部字段：

{
    peripherals:[{ //数组类型；获取到的蓝牙外围设备信息
      uuid: '',    //字符串类型；获取到的蓝牙设备的uuid
      name: '',    //字符串类型；获取到的蓝牙设备的名字
      rssi:  ,     //数字类型；获取到的蓝牙设备的信号强度，在 iOS 平台上已 deprecated，可通过 getPeripheralRssi 接口获取
      services:[]  //数组类型；获取到的蓝牙设备的所有服务 UUID 的集合
    },...]
}

示例代码

var ble = api.require('ble');
ble.retrievePeripheral({
    peripheralUUIDs: ['', '']
}, function(ret) {
    if (ret) {
        api.alert({ msg: JSON.stringify(ret) });
    }
});

可用性

iOS系统

可提供的1.0.0及更高版本