ywble

来自于:AC模块工作室立即使用

概述

本模块封装了云里物里移动开发蓝牙功能

注意:本模块 iOS 平台上最低适配系统版本为 iOS 8.0

说明:由于iOS系统限制,应用层无法获取到设备的Mac地址,所以只能以identifier来代替mac地址作为识别码,需要注意的是,即使是同一个设备,每次重新扫描数据时,它的identifier都是不一样的

模块接口

isBleOpen

判断当前蓝牙是否开启(仅android支持)

isBleOpen(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
  status:,         //布尔类型;蓝牙是否开启                
}

示例代码

var ywble = api.require('ywble');
ywble.isBleOpen(function(ret, err) {
   alert(JSON.stringify(ret));
});

可用性

Android系统

可提供的1.0.0及更高版本

openBle

开启蓝牙(仅android支持)

openBle()

示例代码

var ywble = api.require('ywble');
ywble.openBle();

可用性

Android系统

可提供的1.0.0及更高版本

scan

扫描蓝牙

scan(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status:,         //布尔类型;蓝牙是否开启,仅支持iOS,Android通过openBle接口判断
    modules:[{  //json类型;蓝牙设备列表
        identifier:'',//字符串;设备的识别码(仅iOS支持)
        mac:'',   //字符串;设备的Mac地址   
        name:'',  //字符串;设备的蓝牙名称
        lastUpdate:,//数字类型;设备最后一次被扫描到的时间戳
        connection:,//数字类型;设备的连接状态
                    //取值范围:
                    //0:Disconnected
                    //1:Connected
                    //2:Connecting
                    //3:Validating
        rssi:,//数字类型;设备的RSSI
        uuids:{},//json对象类型;设备的读写服务UUID
        infos:{},//json对象类型;设备信息
    }]                
}

示例代码

var ywble = api.require('ywble');
ywble.scan(function(ret, err) {
   alert(JSON.stringify(ret));
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

stopScan

停止扫描蓝牙

stopScan()

示例代码

var ywble = api.require('ywble');
ywble.stopScan();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

connect

连接蓝牙

connect({params}, callback(ret))

params

id:

  • 类型:字符类型
  • 描述:scan接口返回(iOS为identifier,Android为mac)

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    connection:0, //数字类型;连接状态
                  //取值范围:
                  //0:Disconnected
                  //1:Connected
                  //2:Connecting
                  //3:Validating
}

示例代码

var ywble = api.require('ywble');
ywble.connect({
  id:''
}, function(ret, err) {
   alert(JSON.stringify(ret));
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

disconnect

断开连接

disconnect()

callback(ret)

示例代码

var ywble = api.require('ywble');
ywble.disconnect();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

writeData

向设备写入数据

writeData({params}, callback(ret))

params

data:

  • 类型:字符类型
  • 描述:写入的数据(base64字符串)

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status:true,                //布尔类型;是否成功
}

err:

  • 类型:JSON 对象
  • 内部字段:
{
  msg:'',                        //字符串类型;错误信息
}

示例代码

var ywble = api.require('ywble');
ywble.writeData({
  data:''
}, function(ret, err) {
   alert(JSON.stringify(ret));
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

addDataListener

收到数据监听

addDataListener(callback(ret, err))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    data: ''    //字符串类型;接收的数据(base64字符串)
}

示例代码

var ywble = api.require('ywble');
ywble.addDataListener(function(ret) {
    api.alert({ msg:JSON.stringify(ret)});
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本