getPeripheralRssi

获取当前扫描到的所有外围设备的 rssi

注意：

• 本接口仅支持iOS平台，且仅在 iOS8（含）以上系统上使用。iOS7以下系统可在 Peripheral 的返回信息里获得。
• 通过本接口获取 rssi 必须先建立连接，苹果的官方文档说明如下：

While connected, retrieves the current RSSI of the link.

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

params

peripheralUUID：

• 类型：字符串
• 描述：要获取rssi值的外围设备的 UUID

callback(ret, err)

ret：

• 类型：JSON 对象
• 描述：获取的rssi信息
• 内部字段：

{
     status: true,       //布尔类型；是否成功获取rssi，true|false
     rssi:''             //数字类型；rssi 值
}

err：

• 类型：JSON 对象
• 描述：获取rssi失败错误码
• 内部字段：

{
     code:1       //数字类型；错误码，取值范围如下：
                  //1：peripheralUUID不正确
                  //2： peripheral 不存在
                  //3：未知错误
}

示例代码

var ble = api.require('ble');
ble.getPeripheralRssi(function(ret) {
    if (ret.status) {
        api.alert({ msg: JSON.stringify(ret) });
    }
});

可用性

iOS系统

可提供的1.0.0及更高版本