getPeripheral

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

getPeripheral(callback(ret))

callback(ret)

ret：

• 類型：JSON 對(duì)象
• 描述：每發(fā)現(xiàn)新設(shè)備便會(huì)回調(diào)當(dāng)前發(fā)現(xiàn)的所有藍(lán)牙4.0設(shè)備信息
• 注意：在 iOS 端，有兩個(gè) Name，一個(gè)是GAP name,另一個(gè)是 advertising name，設(shè)備沒有連接外設(shè)時(shí)，獲取的perpheral.name會(huì)是advertising name，然后當(dāng)設(shè)備第一次連接成功外設(shè)后，GAP name就會(huì)被緩存下來，以后在連接時(shí)，獲取的也都是GAP Name, 這樣就造成了修改名稱后蘋果設(shè)備不更新的問題
• 內(nèi)部字段：

{
    peripherals:[{          //數(shù)組類型；獲取到的當(dāng)前掃描到的藍(lán)牙4.0設(shè)備
      manufacturerData:'',  //字符串類型；藍(lán)牙廣播的數(shù)據(jù)；自定義數(shù)據(jù)，需硬件工程師設(shè)置，iOS上key值:CBAdvDataManufacturerData
      uuid: '',             //字符串類型；掃描到的藍(lán)牙設(shè)備的 UUID
      name: '',             //字符串類型；掃描到的藍(lán)牙設(shè)備的名字
      advertisingName: '',  //字符串類型；藍(lán)牙的廣告名，僅支持iOS平臺(tái)
      rssi:                 //數(shù)字類型；掃描到的藍(lán)牙設(shè)備的信號(hào)強(qiáng)度，在 iOS 平臺(tái)上已 deprecated，可通過 getPeripheralRssi 接口獲取
    },...]
}

示例代碼

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

可用性

iOS系統(tǒng)，Android系統(tǒng)

可提供的1.0.0及更高版本