scan

掃描附近藍(lán)牙設(shè)備，會(huì)自動(dòng)停止

scan(callback(ret))

callback(ret)

ret：

• 類型：JSON對(duì)象
• 內(nèi)部字段：

{
    status: 'FOUND' , // 符串類型；藍(lán)牙設(shè)備掃描狀態(tài)，取值范圍如下：
                      //BLUTTOOTH_DISABLED：藍(lán)牙設(shè)備不可用
                       //START_DISCOVERY_FAILED：?jiǎn)?dòng)掃描失敗
                      //FOUND：發(fā)現(xiàn)設(shè)備
                      //DISCOVERY_FINISHED：掃描完成
                      //DISCOVERY_STARTED：開(kāi)始掃描
    device :'', //字符串類型；掃描到的設(shè)備，當(dāng)狀態(tài)為FOUND時(shí)候，會(huì)有該字段，該字段為json格式的字符串，包含name，address，bondState（12：已經(jīng)綁定；11：正在綁定；10：未綁定）三個(gè)屬性，
    devicesNum : 2 ,//數(shù)字類型；掃描到的設(shè)備數(shù)量，當(dāng)狀態(tài)為DISCOVERY_FINISHED時(shí)候會(huì)有該字段
    devices:''//數(shù)組類型；包含本次掃描所有掃描到的設(shè)備；
}

示例代碼

var spp = api.require('spputil');
spp.scan(function(ret) {
    if (ret.status == "BLUTTOOTH_DISABLED") {
        api.alert({
            title: '錯(cuò)誤',
            msg: '藍(lán)牙未啟用，請(qǐng)啟用藍(lán)牙設(shè)備',
        });
    } else if (ret.status == "FOUND") {
        console.log("發(fā)現(xiàn)新設(shè)備：" + ret.device);
        var device = JSON.parse(ret.device);
        //do something with device;
    } else if (ret.status == "DISCOVERY_FINISHED") {
        console.log("掃描完成，共發(fā)現(xiàn)" + ret.devicesNum + "個(gè)設(shè)備");
    } else if (ret.status == "DISCOVERY_STARTED") {
        console.log("開(kāi)始掃描");
    }
});

可用性

Android系統(tǒng)

可提供的1.0.0及更高版本