一门app蓝牙功能js调用语法说明

[复制链接]
曾清Lv.2 显示全部楼层 发表于 2020-2-14 14:03:43 |阅读模式 打印 上一主题 下一主题
苹果上架
一门app蓝牙功能js调用语法说明
♦ 要求 iPhone 4s / iOS6.0 以上,Android 4.3 以上;
♦ 需硬件支持 蓝牙 4.0,即 BLE(BluetoothLowEnergy);

demo地址:https://www.yimenapp.com/doc/demo_ble.cshtml
具体调用参数
1,getState 获取蓝牙设备状态
  1. jsBridge.ble.getState(function(state) {
  2.   alert(state);
  3. });
  4. /**
  5. state 整数类型
  6. 1: poweredOn 设备开启状态 -- 可用状态
  7. 2: poweredOff 设备关闭状态
  8. 3: resetting 正在重置状态
  9. 4: unauthorized 设备未授权状态
  10. 5: unknown 初始的时候是未知的
  11. 6: unsupported 设备不支持
  12. **/
复制代码


2.getPeripheral 获取当前扫描到的所有设备信息
  1. waiting();
  2. jsBridge.ble.getPeripheral(function(data) {
  3.   showData(data);
  4. });
  5. /**
  6. data 为 json 数组
  7. [
  8.   {
  9.     uuid: "",  //字符串,设备 uuid(MAC 地址)
  10.     name: "",  //字符串,设备名称
  11.     rssi: -50  //数字,信号强度
  12.   },
  13.   ...
  14. ]
  15. **/
复制代码


3.isScanning 判断是否正在扫描中
  1. jsBridge.ble.isScanning(function(yes) {
  2.   alert(yes);
  3. });
  4. /**
  5. yes 布尔类型,是否正在扫描中
  6. **/
复制代码


4.isConnected 判断与指定设备是否处于已连接状态
  1. jsBridge.ble.isConnected({
  2.   uuid: "E4:19:C1:BC:0B:60"  //必须,字符串类型,目标设备的 uuid(MAC 地址)
  3. }, function(yes) {
  4.   alert(yes);
  5. });
  6. /**
  7. yes 布尔类型,是否已连接
  8. **/
复制代码


5.scan 开始扫描搜索附近的蓝牙4.0设备
• 系统会不断的扫描更新附近的蓝牙4.0设备信息,反复通过回调函数通知您,也可以调用 getPeripheral 接口获取搜索到的设备;
• 调用此接口会先清空已经搜索到的设备;
• 调用 stopScan 接口停止扫描搜索;
• 搜索到需要的设备后应尽快停止扫描,以降低电量消耗;
  1. waiting();
  2. jsBridge.ble.scan(function(succ, data) {
  3.   showData({
  4.     succ: succ,
  5.     data: data
  6.   });
  7. });
  8. /**
  9. data 为 json 数组
  10. [
  11.   {
  12.     uuid: "",  //字符串,设备 uuid(MAC 地址)
  13.     name: "",  //字符串,设备名称
  14.     rssi: -50  //数字,信号强度
  15.   },
  16.   ...
  17. ]
  18. **/
复制代码

6.stopScan 停止扫描搜索附近设备
  1. jsBridge.ble.stopScan(function(yes) {
  2.   alert(yes);
  3. });
  4. /**
  5. yes 布尔类型,是否已停止
  6. **/
复制代码

7.connect 连接指定设备
  1. jsBridge.ble.connect({
  2.   uuid: "E4:19:C1:BC:0B:60"  //必须,字符串,目标设备的 uuid(MAC 地址)
  3. }, function(succ, err) {
  4.   if (succ) {
  5.     alert("连接成功");
  6.   } else {
  7.     alert(err);
  8.   }
  9. });
复制代码

8.disconnect 断开与指定设备的连接
  1. jsBridge.ble.disconnect({
  2.   uuid: "E4:19:C1:BC:0B:60"  //必须,字符串,目标设备的 uuid(MAC 地址)
  3. }, function(succ, err) {
  4.   if (succ) {
  5.     alert("断开成功");
  6.   } else {
  7.     alert(err);
  8.   }
  9. });
复制代码

9.discoverServices 获取指定设备的所有服务
  1. waiting();
  2. jsBridge.ble.discoverServices({
  3.   //必须,字符串,设备的 uuid(MAC 地址)
  4.   uuid: "E4:19:C1:BC:0B:60"
  5. }, function(succ, data) {
  6.   showData({
  7.     succ: succ,
  8.     data: data
  9.   });
  10. });
  11. /**
  12. data 为 json 字符串数组类型,返回此设备所有服务的 UUID (serviceUUID) 集
  13. [
  14.   "",  //字符串,服务 UUID (serviceUUID)
  15.   ...
  16. ]
  17. **/
复制代码

10.discoverCharacteristics 获取指定设备服务的所有特征(Characteristic)
  1. waiting();
  2. jsBridge.ble.discoverCharacteristics({
  3.   //必须,字符串,设备的 uuid(MAC 地址)
  4.   uuid       : "E4:19:C1:BC:0B:60",
  5.   //必须,字符串,服务 uuid,调用 discoverServices 可获取
  6.   serviceUUID: "00001800-0000-1000-8000-00805f9b34fb"
  7. }, function(succ, data) {
  8.   showData({
  9.     succ: succ,
  10.     data: data
  11.   });
  12. });
  13. /**
  14. data 为 json 数组类型,返回所有特征集
  15. [
  16.   {
  17.     uuid              : '', //字符串,设备 uuid(MAC 地址)
  18.     serviceUUID       : '', //字符串,服务的 UUID
  19.     characteristicUUID: '', //字符串,特征的 UUID
  20.     permissions       : '', //字符串,特征的权限,可能值:
  21.                         //readable
  22.                         //writeable
  23.                         //readEncryptionRequired
  24.                         //writeEncryptionRequired
  25.                         //其他(数字代码串)
  26.     properties         : '', //字符串,特征的属性,可能值:
  27.                         //broadcast
  28.                         //read
  29.                         //writeWithoutResponse
  30.                         //write
  31.                         //notify
  32.                         //indicate
  33.                         //authenticatedSignedWrites
  34.                         //extendedProperties
  35.                         //notifyEncryptionRequired
  36.                         //indicateEncryptionRequired
  37.                         //其他(数字代码串)
  38.     value              : '' //字符串,Hex 16进制值字符串(请自行转换为 byte 流)
  39.   },
  40.   ...
  41. ]
  42. **/
复制代码

11.discoverDescriptors 获取指定设备特征的所有描述符(Descriptor)

  1. waiting();
  2. jsBridge.ble.discoverDescriptors({
  3.   //必须,字符串,设备的 uuid(MAC 地址)
  4.   uuid       : "E4:19:C1:BC:0B:60",
  5.   //必须,字符串,服务 uuid,调用 discoverServices 可获取
  6.   serviceUUID: "00001800-0000-1000-8000-00805f9b34fb",
  7.   //必须,字符串,特征 uuid,调用 discoverCharacteristics 可获取
  8.   characteristicUUID: "00002a00-0000-1000-8000-00805f9b34fb"
  9. }, function(succ, data) {
  10.   showData({
  11.     succ: succ,
  12.     data: data
  13.   });
  14. });
  15. /**
  16. data 为 json 数组类型,返回所有描述符集
  17. [
  18.   {
  19.     uuid              : '', //字符串,设备 uuid(MAC 地址)
  20.     serviceUUID       : '', //字符串,服务的 UUID
  21.     characteristicUUID: '', //字符串,特征的 UUID
  22.     descriptorUUID    : '', //字符串,特征的 UUID
  23.     value             : '', //字符串,Hex 16进制值字符串(请自行转换为 byte 流)
  24.   },
  25.   ...
  26. ]
  27. **/
复制代码


12.setNotify 监听指定设备特征的数据回发
• 每有数据回发都会触发回调函数;
• 调用 disconnect 断开连接则自动停止监听;
  1. waiting();
  2. jsBridge.ble.setNotify({
  3.   //必须,字符串,设备的 uuid(MAC 地址)
  4.   uuid       : "E4:19:C1:BC:0B:60",
  5.   //必须,字符串,服务 uuid,调用 discoverServices 可获取
  6.   serviceUUID: "00001800-0000-1000-8000-00805f9b34fb",
  7.   //必须,字符串,特征 uuid,调用 discoverCharacteristics 可获取
  8.   characteristicUUID: "00002a00-0000-1000-8000-00805f9b34fb"
  9. }, function(succ, data) {
  10.   showData({
  11.     succ: succ,
  12.     data: data
  13.   });
  14. });
  15. /**
  16. data 为 json 对象,请参考 discoverCharacteristics 返回的 data 类型说明
  17. **/
复制代码


13.read 从设备上读取数据
• 每有数据回发都会触发回调函数;
  1. waiting();
  2. jsBridge.ble.read({
  3.   //必须,字符串,设备的 uuid(MAC 地址)
  4.   uuid       : "E4:19:C1:BC:0B:60",
  5.   //必须,字符串,服务 uuid,调用 discoverServices 可获取
  6.   serviceUUID: "00001800-0000-1000-8000-00805f9b34fb",
  7.   //必须,字符串,特征 uuid,调用 discoverCharacteristics 可获取
  8.   characteristicUUID: "00002a00-0000-1000-8000-00805f9b34fb",
  9.   //可选,字符串,可指定描述符 uuid,如果提供了则读取 descriptor,否则读取 characteristic
  10.   descriptorUUID    : ""
  11. }, function(succ, data) {
  12.   showData({
  13.     succ: succ,
  14.     data: data
  15.   });
  16. });
  17. /**
  18. data 为 json 对象:
  19.   读取 characteristic 请参考 discoverCharacteristics 返回的 data 类型说明
  20.   读取 descriptor 请参考 discoverDescriptors 返回的 data 类型说明
  21. **/
复制代码


14.write 向设备写入数据
• 每有数据回发都会触发回调函数;
  1. waiting();
  2. jsBridge.ble.write({
  3.   //必须,字符串,设备的 uuid(MAC 地址)
  4.   uuid       : "E4:19:C1:BC:0B:60",
  5.   //必须,字符串,服务 uuid,调用 discoverServices 可获取
  6.   serviceUUID: "00001800-0000-1000-8000-00805f9b34fb",
  7.   //必须,字符串,特征 uuid,调用 discoverCharacteristics 可获取
  8.   characteristicUUID: "00002a00-0000-1000-8000-00805f9b34fb",
  9.   //可选,字符串,可指定描述符 uuid,如果提供了则写入 descriptor,否则写入 characteristic
  10.   descriptorUUID    : "",
  11.   //必须,请将需要写入的 byte 流转换为 Hex 16进制串
  12.   value             : "48656C6C6F20776F726C64"
  13. }, function(succ, data) {
  14.   showData({
  15.     succ: succ,
  16.     data: data
  17.   });
  18. });
  19. /**
  20. data 为 json 对象:
  21.   写入 characteristic 请参考 discoverCharacteristics 返回的 data 类型说明
  22.   写入 descriptor 请参考 discoverDescriptors 返回的 data 类型说明
  23. **/
复制代码







回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

一门APP打包致力于H5混合APP基础框架领域的前沿探索,专注轻便的移动应用解决方案 提供基于HTML前端页面在各种应用层级的端延展。
  • 官方手机版

  • 微信公众号

  • 微信客服

  • Powered by Discuz! X3.4 | Copyright © 2001-2020, 一门APP. | 一门APP开发平台|热门标签
  • 蜀ICP备17005078号-4 | 川公网安备 51019002001185号 | |成都七扇门科技有限公司