ywble

isBleOpen

openBle

scan

stopScan

connect

disconnect

writeData

addDataListener

概述

本插件封装了云里物里移动开发蓝牙功能

注意：本插件 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) {
   api.alert({
            msg: 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) {
   api.alert({
            msg: 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) {
   api.alert({
            msg: 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) {
   api.alert({
            msg: 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及更高版本

是否仍需要帮助？ 请保持联络！
最后更新于 2024/11/18