scan

扫描附近蓝牙设备，会自动停止

scan(callback(ret))

callback(ret)

ret：

• 类型：JSON对象
• 内部字段：

{
    status: 'FOUND' , // 符串类型；蓝牙设备扫描状态，取值范围如下：
                      //BLUTTOOTH_DISABLED：蓝牙设备不可用
                       //START_DISCOVERY_FAILED：启动扫描失败
                      //FOUND：发现设备
                      //DISCOVERY_FINISHED：扫描完成
                      //DISCOVERY_STARTED：开始扫描
    device :'', //字符串类型；扫描到的设备，当状态为FOUND时候，会有该字段，该字段为json格式的字符串，包含name，address，bondState（12：已经绑定；11：正在绑定；10：未绑定）三个属性，
    devicesNum : 2 ,//数字类型；扫描到的设备数量，当状态为DISCOVERY_FINISHED时候会有该字段
    devices:''//数组类型；包含本次扫描所有扫描到的设备；
}

示例代码

var spp = api.require('spputil');
spp.scan(function(ret) {
    if (ret.status == "BLUTTOOTH_DISABLED") {
        api.alert({
            title: '错误',
            msg: '蓝牙未启用，请启用蓝牙设备',
        });
    } else if (ret.status == "FOUND") {
        console.log("发现新设备：" + ret.device);
        var device = JSON.parse(ret.device);
        //do something with device;
    } else if (ret.status == "DISCOVERY_FINISHED") {
        console.log("扫描完成，共发现" + ret.devicesNum + "个设备");
    } else if (ret.status == "DISCOVERY_STARTED") {
        console.log("开始扫描");
    }
});

可用性

Android系统

可提供的1.0.0及更高版本