getPeripheralRssi

獲取當(dāng)前掃描到的所有外圍設(shè)備的 rssi

注意：

• 本接口僅支持iOS平臺，且僅在 iOS8（含）以上系統(tǒng)上使用。iOS7以下系統(tǒng)可在 Peripheral 的返回信息里獲得。
• 通過本接口獲取 rssi 必須先建立連接，蘋果的官方文檔說明如下：

While connected, retrieves the current RSSI of the link.

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

params

peripheralUUID：

• 類型：字符串
• 描述：要獲取rssi值的外圍設(shè)備的 UUID

callback(ret, err)

ret：

• 類型：JSON 對象
• 描述：獲取的rssi信息
• 內(nèi)部字段：

{
     status: true,       //布爾類型；是否成功獲取rssi，true|false
     rssi:''             //數(shù)字類型；rssi 值
}

err：

• 類型：JSON 對象
• 描述：獲取rssi失敗錯誤碼
• 內(nèi)部字段：

{
     code:1       //數(shù)字類型；錯誤碼，取值范圍如下：
                  //1：peripheralUUID不正確
                  //2： peripheral 不存在
                  //3：未知錯誤
}

示例代碼

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

可用性

iOS系統(tǒng)

可提供的1.0.0及更高版本