write 向设备写入数据 APP开发实现手机设备蓝牙通信的能力

发表于2022年12月29日由yimen

用做网页的技术做APP！
一门提供标准化的jsbridge-mini.js库，您只需要在页面引用并执行JS即可实现各种原生APP、原生PC的功能能力。

==================APP端==================
【APP端】（安卓版&苹果版）目前提供200+原生功能，2000+JS映射接口，用做网站的技术即可实现各种原生APP能力、APP demo地址https://www.yimenapp.com/doc/demo.cshtml下载教程：
♦ JS-SDK 引用方式：
♦ 普通网页 script 方式加载：下载最新版，请在页面上调用 jsBridge 接口之前引用 jsbridge-mini.js 库；
♦ js module 方式引用：npm install ym-jsbridge 具体请参考 npm package

一门APP开发平台通用JS

• 每有数据回发都会触发回调函数；

核心代码示例，详情参阅demo

waiting();
jsBridge.ble.write({
  //必须，字符串，设备的 uuid（MAC 地址）
  uuid       : "E4:19:C1:BC:0B:60",
  //必须，字符串，服务 uuid，调用 discoverServices 可获取
  serviceUUID: "00001800-0000-1000-8000-00805f9b34fb",
  //必须，字符串，特征 uuid，调用 discoverCharacteristics 可获取
  characteristicUUID: "00002a00-0000-1000-8000-00805f9b34fb",
  //可选，字符串，可指定描述符 uuid，如果提供了则写入 descriptor，否则写入 characteristic
  descriptorUUID    : "",
  //必须，请将需要写入的 byte 流转换为 Hex 16进制串
  value             : "48656C6C6F20776F726C64"
}, function(succ, data) {
  showData({
    succ: succ,
    data: data
  });
});
/**
data 为 json 对象：
  写入 characteristic 请参考 discoverCharacteristics 返回的 data 类型说明
  写入 descriptor 请参考 discoverDescriptors 返回的 data 类型说明
**/

A标签执行JS示例代码

<a href="javascript:void(0)" onclick="zhixing()">执行</a> 
<!-- 写入一个A标签href值为"javascript:void(0)"，定义点击事件onclick；-->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- 在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接；-->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
waiting();
jsBridge.ble.write({
  //必须，字符串，设备的 uuid（MAC 地址）
  uuid       : "E4:19:C1:BC:0B:60",
  //必须，字符串，服务 uuid，调用 discoverServices 可获取
  serviceUUID: "00001800-0000-1000-8000-00805f9b34fb",
  //必须，字符串，特征 uuid，调用 discoverCharacteristics 可获取
  characteristicUUID: "00002a00-0000-1000-8000-00805f9b34fb",
  //可选，字符串，可指定描述符 uuid，如果提供了则写入 descriptor，否则写入 characteristic
  descriptorUUID    : "",
  //必须，请将需要写入的 byte 流转换为 Hex 16进制串
  value             : "48656C6C6F20776F726C64"
}, function(succ, data) {
  showData({
    succ: succ,
    data: data
  });
});
/**
data 为 json 对象：
  写入 characteristic 请参考 discoverCharacteristics 返回的 data 类型说明
  写入 descriptor 请参考 discoverDescriptors 返回的 data 类型说明
**/

}
</script>
<!--执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可；-->

按钮执行JS示例代码

<button onclick="zhixing()" >执行</button>
<!-- //写一个按钮，定义点击执行事件； -->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- //在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接； -->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
waiting();
jsBridge.ble.write({
  //必须，字符串，设备的 uuid（MAC 地址）
  uuid       : "E4:19:C1:BC:0B:60",
  //必须，字符串，服务 uuid，调用 discoverServices 可获取
  serviceUUID: "00001800-0000-1000-8000-00805f9b34fb",
  //必须，字符串，特征 uuid，调用 discoverCharacteristics 可获取
  characteristicUUID: "00002a00-0000-1000-8000-00805f9b34fb",
  //可选，字符串，可指定描述符 uuid，如果提供了则写入 descriptor，否则写入 characteristic
  descriptorUUID    : "",
  //必须，请将需要写入的 byte 流转换为 Hex 16进制串
  value             : "48656C6C6F20776F726C64"
}, function(succ, data) {
  showData({
    succ: succ,
    data: data
  });
});
/**
data 为 json 对象：
  写入 characteristic 请参考 discoverCharacteristics 返回的 data 类型说明
  写入 descriptor 请参考 discoverDescriptors 返回的 data 类型说明
**/

}
</script>
<!-- //执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可； -->

read 从设备上读取数据 APP开发实现手机设备蓝牙通信的能力

发表于2022年12月29日由yimen

一门APP开发平台通用JS

read 从设备上读取数据 APP开发实现手机设备蓝牙通信的能力

• 每有数据回发都会触发回调函数；

核心代码示例，详情参阅demo

waiting();
jsBridge.ble.read({
  //必须，字符串，设备的 uuid（MAC 地址）
  uuid       : "E4:19:C1:BC:0B:60",
  //必须，字符串，服务 uuid，调用 discoverServices 可获取
  serviceUUID: "00001800-0000-1000-8000-00805f9b34fb",
  //必须，字符串，特征 uuid，调用 discoverCharacteristics 可获取
  characteristicUUID: "00002a00-0000-1000-8000-00805f9b34fb",
  //可选，字符串，可指定描述符 uuid，如果提供了则读取 descriptor，否则读取 characteristic
  descriptorUUID    : ""
}, function(succ, data) {
  showData({
    succ: succ,
    data: data
  });
});
/**
data 为 json 对象：
  读取 characteristic 请参考 discoverCharacteristics 返回的 data 类型说明
  读取 descriptor 请参考 discoverDescriptors 返回的 data 类型说明
**/

A标签执行JS示例代码

<a href="javascript:void(0)" onclick="zhixing()">执行</a> 
<!-- 写入一个A标签href值为"javascript:void(0)"，定义点击事件onclick；-->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- 在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接；-->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
waiting();
jsBridge.ble.read({
  //必须，字符串，设备的 uuid（MAC 地址）
  uuid       : "E4:19:C1:BC:0B:60",
  //必须，字符串，服务 uuid，调用 discoverServices 可获取
  serviceUUID: "00001800-0000-1000-8000-00805f9b34fb",
  //必须，字符串，特征 uuid，调用 discoverCharacteristics 可获取
  characteristicUUID: "00002a00-0000-1000-8000-00805f9b34fb",
  //可选，字符串，可指定描述符 uuid，如果提供了则读取 descriptor，否则读取 characteristic
  descriptorUUID    : ""
}, function(succ, data) {
  showData({
    succ: succ,
    data: data
  });
});
/**
data 为 json 对象：
  读取 characteristic 请参考 discoverCharacteristics 返回的 data 类型说明
  读取 descriptor 请参考 discoverDescriptors 返回的 data 类型说明
**/

}
</script>
<!--执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可；-->

按钮执行JS示例代码

<button onclick="zhixing()" >执行</button>
<!-- //写一个按钮，定义点击执行事件； -->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- //在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接； -->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
waiting();
jsBridge.ble.read({
  //必须，字符串，设备的 uuid（MAC 地址）
  uuid       : "E4:19:C1:BC:0B:60",
  //必须，字符串，服务 uuid，调用 discoverServices 可获取
  serviceUUID: "00001800-0000-1000-8000-00805f9b34fb",
  //必须，字符串，特征 uuid，调用 discoverCharacteristics 可获取
  characteristicUUID: "00002a00-0000-1000-8000-00805f9b34fb",
  //可选，字符串，可指定描述符 uuid，如果提供了则读取 descriptor，否则读取 characteristic
  descriptorUUID    : ""
}, function(succ, data) {
  showData({
    succ: succ,
    data: data
  });
});
/**
data 为 json 对象：
  读取 characteristic 请参考 discoverCharacteristics 返回的 data 类型说明
  读取 descriptor 请参考 discoverDescriptors 返回的 data 类型说明
**/

}
</script>
<!-- //执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可； -->

setNotify 监听指定设备特征的数据回发 APP开发实现手机蓝牙通信功能

发表于2022年12月29日由yimen

一门APP开发平台通用JS

setNotify 监听指定设备特征的数据回发 APP开发实现手机蓝牙通信功能

• 每有数据回发都会触发回调函数；

• 调用 disconnect 断开连接则自动停止监听；

核心代码示例，详情参阅demo

waiting();
jsBridge.ble.setNotify({
  //必须，字符串，设备的 uuid（MAC 地址）
  uuid       : "E4:19:C1:BC:0B:60",
  //必须，字符串，服务 uuid，调用 discoverServices 可获取
  serviceUUID: "00001800-0000-1000-8000-00805f9b34fb",
  //必须，字符串，特征 uuid，调用 discoverCharacteristics 可获取
  characteristicUUID: "00002a00-0000-1000-8000-00805f9b34fb"
}, function(succ, data) {
  showData({
    succ: succ,
    data: data
  });
});
/**
data 为 json 对象，请参考 discoverCharacteristics 返回的 data 类型说明
**/

A标签执行JS示例代码

<a href="javascript:void(0)" onclick="zhixing()">执行</a> 
<!-- 写入一个A标签href值为"javascript:void(0)"，定义点击事件onclick；-->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- 在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接；-->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
waiting();
jsBridge.ble.setNotify({
  //必须，字符串，设备的 uuid（MAC 地址）
  uuid       : "E4:19:C1:BC:0B:60",
  //必须，字符串，服务 uuid，调用 discoverServices 可获取
  serviceUUID: "00001800-0000-1000-8000-00805f9b34fb",
  //必须，字符串，特征 uuid，调用 discoverCharacteristics 可获取
  characteristicUUID: "00002a00-0000-1000-8000-00805f9b34fb"
}, function(succ, data) {
  showData({
    succ: succ,
    data: data
  });
});
/**
data 为 json 对象，请参考 discoverCharacteristics 返回的 data 类型说明
**/

}
</script>
<!--执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可；-->

按钮执行JS示例代码

<button onclick="zhixing()" >执行</button>
<!-- //写一个按钮，定义点击执行事件； -->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- //在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接； -->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
waiting();
jsBridge.ble.setNotify({
  //必须，字符串，设备的 uuid（MAC 地址）
  uuid       : "E4:19:C1:BC:0B:60",
  //必须，字符串，服务 uuid，调用 discoverServices 可获取
  serviceUUID: "00001800-0000-1000-8000-00805f9b34fb",
  //必须，字符串，特征 uuid，调用 discoverCharacteristics 可获取
  characteristicUUID: "00002a00-0000-1000-8000-00805f9b34fb"
}, function(succ, data) {
  showData({
    succ: succ,
    data: data
  });
});
/**
data 为 json 对象，请参考 discoverCharacteristics 返回的 data 类型说明
**/

}
</script>
<!-- //执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可； -->

discoverDescriptors 获取指定设备特征的所有描述符（Descriptor） APP开发实现

发表于2022年12月29日由yimen

一门APP开发平台通用JS

discoverDescriptors 获取指定设备特征的所有描述符（Descriptor） APP开发实现

核心代码示例，详情参阅demo

waiting();
jsBridge.ble.discoverDescriptors({
  //必须，字符串，设备的 uuid（MAC 地址）
  uuid       : "E4:19:C1:BC:0B:60",
  //必须，字符串，服务 uuid，调用 discoverServices 可获取
  serviceUUID: "00001800-0000-1000-8000-00805f9b34fb",
  //必须，字符串，特征 uuid，调用 discoverCharacteristics 可获取
  characteristicUUID: "00002a00-0000-1000-8000-00805f9b34fb"
}, function(succ, data) {
  showData({
    succ: succ,
    data: data
  });
});
/**
data 为 json 数组类型，返回所有描述符集
[
  {
    uuid              : '', //字符串，设备 uuid（MAC 地址）
    serviceUUID       : '', //字符串，服务的 UUID 
    characteristicUUID: '', //字符串，特征的 UUID
    descriptorUUID    : '', //字符串，特征的 UUID
    value             : '', //字符串，Hex 16进制值字符串（请自行转换为 byte 流）
  },
  ...
] 
**/

A标签执行JS示例代码

<a href="javascript:void(0)" onclick="zhixing()">执行</a> 
<!-- 写入一个A标签href值为"javascript:void(0)"，定义点击事件onclick；-->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- 在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接；-->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
waiting();
jsBridge.ble.discoverDescriptors({
  //必须，字符串，设备的 uuid（MAC 地址）
  uuid       : "E4:19:C1:BC:0B:60",
  //必须，字符串，服务 uuid，调用 discoverServices 可获取
  serviceUUID: "00001800-0000-1000-8000-00805f9b34fb",
  //必须，字符串，特征 uuid，调用 discoverCharacteristics 可获取
  characteristicUUID: "00002a00-0000-1000-8000-00805f9b34fb"
}, function(succ, data) {
  showData({
    succ: succ,
    data: data
  });
});
/**
data 为 json 数组类型，返回所有描述符集
[
  {
    uuid              : '', //字符串，设备 uuid（MAC 地址）
    serviceUUID       : '', //字符串，服务的 UUID 
    characteristicUUID: '', //字符串，特征的 UUID
    descriptorUUID    : '', //字符串，特征的 UUID
    value             : '', //字符串，Hex 16进制值字符串（请自行转换为 byte 流）
  },
  ...
] 
**/

}
</script>
<!--执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可；-->

按钮执行JS示例代码

<button onclick="zhixing()" >执行</button>
<!-- //写一个按钮，定义点击执行事件； -->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- //在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接； -->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
waiting();
jsBridge.ble.discoverDescriptors({
  //必须，字符串，设备的 uuid（MAC 地址）
  uuid       : "E4:19:C1:BC:0B:60",
  //必须，字符串，服务 uuid，调用 discoverServices 可获取
  serviceUUID: "00001800-0000-1000-8000-00805f9b34fb",
  //必须，字符串，特征 uuid，调用 discoverCharacteristics 可获取
  characteristicUUID: "00002a00-0000-1000-8000-00805f9b34fb"
}, function(succ, data) {
  showData({
    succ: succ,
    data: data
  });
});
/**
data 为 json 数组类型，返回所有描述符集
[
  {
    uuid              : '', //字符串，设备 uuid（MAC 地址）
    serviceUUID       : '', //字符串，服务的 UUID 
    characteristicUUID: '', //字符串，特征的 UUID
    descriptorUUID    : '', //字符串，特征的 UUID
    value             : '', //字符串，Hex 16进制值字符串（请自行转换为 byte 流）
  },
  ...
] 
**/

}
</script>
<!-- //执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可； -->

discoverCharacteristics 获取指定设备服务的所有特征（Characteristic） APP开发实现手机设备蓝牙通信的能力

发表于2022年12月29日由yimen

一门APP开发平台通用JS

discoverCharacteristics 获取指定设备服务的所有特征（Characteristic） APP开发实现手机设备蓝牙通信的能力

核心代码示例，详情参阅demo

waiting();
jsBridge.ble.discoverCharacteristics({
  //必须，字符串，设备的 uuid（MAC 地址）
  uuid       : "E4:19:C1:BC:0B:60",
  //必须，字符串，服务 uuid，调用 discoverServices 可获取
  serviceUUID: "00001800-0000-1000-8000-00805f9b34fb"
}, function(succ, data) {
  showData({
    succ: succ,
    data: data
  });
});
/**
data 为 json 数组类型，返回所有特征集
[
  {
    uuid              : '', //字符串，设备 uuid（MAC 地址）
    serviceUUID       : '', //字符串，服务的 UUID 
    characteristicUUID: '', //字符串，特征的 UUID
    permissions       : '', //字符串，特征的权限，可能值：
                        //readable
                        //writeable
                        //readEncryptionRequired
                        //writeEncryptionRequired
                        //其他（数字代码串）
    properties         : '', //字符串，特征的属性，可能值：
                        //broadcast
                        //read
                        //writeWithoutResponse
                        //write
                        //notify
                        //indicate
                        //authenticatedSignedWrites
                        //extendedProperties
                        //notifyEncryptionRequired
                        //indicateEncryptionRequired
                        //其他（数字代码串）
    value              : '' //字符串，Hex 16进制值字符串（请自行转换为 byte 流）
  },
  ...
] 
**/

A标签执行JS示例代码

<a href="javascript:void(0)" onclick="zhixing()">执行</a> 
<!-- 写入一个A标签href值为"javascript:void(0)"，定义点击事件onclick；-->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- 在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接；-->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
waiting();
jsBridge.ble.discoverCharacteristics({
  //必须，字符串，设备的 uuid（MAC 地址）
  uuid       : "E4:19:C1:BC:0B:60",
  //必须，字符串，服务 uuid，调用 discoverServices 可获取
  serviceUUID: "00001800-0000-1000-8000-00805f9b34fb"
}, function(succ, data) {
  showData({
    succ: succ,
    data: data
  });
});
/**
data 为 json 数组类型，返回所有特征集
[
  {
    uuid              : '', //字符串，设备 uuid（MAC 地址）
    serviceUUID       : '', //字符串，服务的 UUID 
    characteristicUUID: '', //字符串，特征的 UUID
    permissions       : '', //字符串，特征的权限，可能值：
                        //readable
                        //writeable
                        //readEncryptionRequired
                        //writeEncryptionRequired
                        //其他（数字代码串）
    properties         : '', //字符串，特征的属性，可能值：
                        //broadcast
                        //read
                        //writeWithoutResponse
                        //write
                        //notify
                        //indicate
                        //authenticatedSignedWrites
                        //extendedProperties
                        //notifyEncryptionRequired
                        //indicateEncryptionRequired
                        //其他（数字代码串）
    value              : '' //字符串，Hex 16进制值字符串（请自行转换为 byte 流）
  },
  ...
] 
**/

}
</script>
<!--执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可；-->

按钮执行JS示例代码

<button onclick="zhixing()" >执行</button>
<!-- //写一个按钮，定义点击执行事件； -->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- //在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接； -->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
waiting();
jsBridge.ble.discoverCharacteristics({
  //必须，字符串，设备的 uuid（MAC 地址）
  uuid       : "E4:19:C1:BC:0B:60",
  //必须，字符串，服务 uuid，调用 discoverServices 可获取
  serviceUUID: "00001800-0000-1000-8000-00805f9b34fb"
}, function(succ, data) {
  showData({
    succ: succ,
    data: data
  });
});
/**
data 为 json 数组类型，返回所有特征集
[
  {
    uuid              : '', //字符串，设备 uuid（MAC 地址）
    serviceUUID       : '', //字符串，服务的 UUID 
    characteristicUUID: '', //字符串，特征的 UUID
    permissions       : '', //字符串，特征的权限，可能值：
                        //readable
                        //writeable
                        //readEncryptionRequired
                        //writeEncryptionRequired
                        //其他（数字代码串）
    properties         : '', //字符串，特征的属性，可能值：
                        //broadcast
                        //read
                        //writeWithoutResponse
                        //write
                        //notify
                        //indicate
                        //authenticatedSignedWrites
                        //extendedProperties
                        //notifyEncryptionRequired
                        //indicateEncryptionRequired
                        //其他（数字代码串）
    value              : '' //字符串，Hex 16进制值字符串（请自行转换为 byte 流）
  },
  ...
] 
**/

}
</script>
<!-- //执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可； -->

discoverServices 获取指定设备的所有服务 APP开发实现手机蓝牙设备权限和通信的能力

发表于2022年12月29日由yimen

一门APP开发平台通用JS

discoverServices 获取指定设备的所有服务 APP开发实现手机蓝牙设备权限和通信的能力

核心代码示例，详情参阅demo

waiting();
jsBridge.ble.discoverServices({
  //必须，字符串，设备的 uuid（MAC 地址）
  uuid: "E4:19:C1:BC:0B:60"
}, function(succ, data) {
  showData({
    succ: succ,
    data: data
  });
});
/**
data 为 json 字符串数组类型，返回此设备所有服务的 UUID (serviceUUID) 集
[
  "",  //字符串，服务 UUID (serviceUUID)
  ...
]
**/

A标签执行JS示例代码

<a href="javascript:void(0)" onclick="zhixing()">执行</a> 
<!-- 写入一个A标签href值为"javascript:void(0)"，定义点击事件onclick；-->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- 在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接；-->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
waiting();
jsBridge.ble.discoverServices({
  //必须，字符串，设备的 uuid（MAC 地址）
  uuid: "E4:19:C1:BC:0B:60"
}, function(succ, data) {
  showData({
    succ: succ,
    data: data
  });
});
/**
data 为 json 字符串数组类型，返回此设备所有服务的 UUID (serviceUUID) 集
[
  "",  //字符串，服务 UUID (serviceUUID)
  ...
]
**/

}
</script>
<!--执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可；-->

按钮执行JS示例代码

<button onclick="zhixing()" >执行</button>
<!-- //写一个按钮，定义点击执行事件； -->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- //在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接； -->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
waiting();
jsBridge.ble.discoverServices({
  //必须，字符串，设备的 uuid（MAC 地址）
  uuid: "E4:19:C1:BC:0B:60"
}, function(succ, data) {
  showData({
    succ: succ,
    data: data
  });
});
/**
data 为 json 字符串数组类型，返回此设备所有服务的 UUID (serviceUUID) 集
[
  "",  //字符串，服务 UUID (serviceUUID)
  ...
]
**/

}
</script>
<!-- //执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可； -->

stopScan 停止扫描搜索附近设备 APP开发实现手机蓝牙通信能力

发表于2022年12月29日由yimen

一门APP开发平台通用JS

stopScan 停止扫描搜索附近设备 APP开发实现手机蓝牙通信能力

核心代码示例，详情参阅demo

jsBridge.ble.stopScan(function(yes) {
  alert(yes);
});
/**
yes 布尔类型，是否已停止
**/

A标签执行JS示例代码

<a href="javascript:void(0)" onclick="zhixing()">执行</a> 
<!-- 写入一个A标签href值为"javascript:void(0)"，定义点击事件onclick；-->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- 在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接；-->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
jsBridge.ble.stopScan(function(yes) {
  alert(yes);
});
/**
yes 布尔类型，是否已停止
**/

}
</script>
<!--执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可；-->

按钮执行JS示例代码

<button onclick="zhixing()" >执行</button>
<!-- //写一个按钮，定义点击执行事件； -->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- //在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接； -->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
jsBridge.ble.stopScan(function(yes) {
  alert(yes);
});
/**
yes 布尔类型，是否已停止
**/

}
</script>
<!-- //执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可； -->

scan 开始扫描搜索附近的蓝牙4.0设备 APP开发实现手机设备蓝牙通信能力

发表于2022年12月29日由yimen

一门APP开发平台通用JS

scan 开始扫描搜索附近的蓝牙4.0设备 APP开发实现手机设备蓝牙通信能力

• 系统会不断的扫描更新附近的蓝牙4.0设备信息，反复通过回调函数通知您，也可以调用 getPeripheral 接口获取搜索到的设备；

• 调用此接口会先清空已经搜索到的设备；

• 最长连续扫描30秒钟会自动停止，调用 stopScan 手动停止扫描；

• 搜索到需要的设备后应尽快停止扫描，以降低电量消耗；

核心代码示例，详情参阅demo

waiting();
jsBridge.ble.scan(function(succ, data) {
  showData({
    succ: succ,
    data: data
  });
});
/**
data 为 json 数组
[
  {
    uuid: "",  //字符串，设备 uuid（MAC 地址）
    name: "",  //字符串，设备名称
    rssi: -50  //数字，信号强度
  },
  ...
]
**/

A标签执行JS示例代码

<a href="javascript:void(0)" onclick="zhixing()">执行</a> 
<!-- 写入一个A标签href值为"javascript:void(0)"，定义点击事件onclick；-->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- 在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接；-->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
waiting();
jsBridge.ble.scan(function(succ, data) {
  showData({
    succ: succ,
    data: data
  });
});
/**
data 为 json 数组
[
  {
    uuid: "",  //字符串，设备 uuid（MAC 地址）
    name: "",  //字符串，设备名称
    rssi: -50  //数字，信号强度
  },
  ...
]
**/

}
</script>
<!--执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可；-->

按钮执行JS示例代码

<button onclick="zhixing()" >执行</button>
<!-- //写一个按钮，定义点击执行事件； -->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- //在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接； -->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
waiting();
jsBridge.ble.scan(function(succ, data) {
  showData({
    succ: succ,
    data: data
  });
});
/**
data 为 json 数组
[
  {
    uuid: "",  //字符串，设备 uuid（MAC 地址）
    name: "",  //字符串，设备名称
    rssi: -50  //数字，信号强度
  },
  ...
]
**/

}
</script>
<!-- //执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可； -->

getPeripheral 获取当前扫描到的所有设备信息 APP开发实现扫码手机蓝牙设备权限的能力

发表于2022年12月29日由yimen

一门APP开发平台通用JS

getPeripheral 获取当前扫描到的所有设备信息 APP开发实现扫码手机蓝牙设备权限的能力

核心代码示例，详情参阅demo

waiting();
jsBridge.ble.getPeripheral(function(data) {
  showData(data);
});
/**
data 为 json 数组
[
  {
    uuid: "",  //字符串，设备 uuid（MAC 地址）
    name: "",  //字符串，设备名称
    rssi: -50  //数字，信号强度
  },
  ...
]
**/

A标签执行JS示例代码

<a href="javascript:void(0)" onclick="zhixing()">执行</a> 
<!-- 写入一个A标签href值为"javascript:void(0)"，定义点击事件onclick；-->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- 在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接；-->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
waiting();
jsBridge.ble.getPeripheral(function(data) {
  showData(data);
});
/**
data 为 json 数组
[
  {
    uuid: "",  //字符串，设备 uuid（MAC 地址）
    name: "",  //字符串，设备名称
    rssi: -50  //数字，信号强度
  },
  ...
]
**/

}
</script>
<!--执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可；-->

按钮执行JS示例代码

<button onclick="zhixing()" >执行</button>
<!-- //写一个按钮，定义点击执行事件； -->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- //在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接； -->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
waiting();
jsBridge.ble.getPeripheral(function(data) {
  showData(data);
});
/**
data 为 json 数组
[
  {
    uuid: "",  //字符串，设备 uuid（MAC 地址）
    name: "",  //字符串，设备名称
    rssi: -50  //数字，信号强度
  },
  ...
]
**/

}
</script>
<!-- //执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可； -->

getName 获取本机蓝牙设备名称 APP开发实现APP启用手机蓝牙通信权限的能力

发表于2022年12月29日由yimen

一门APP开发平台通用JS

getName 获取本机蓝牙设备名称 APP开发实现APP启用手机蓝牙通信权限的能力

核心代码示例，详情参阅demo

jsBridge.ble.getName(function(name) {
  alert(name);
});

A标签执行JS示例代码

<a href="javascript:void(0)" onclick="zhixing()">执行</a> 
<!-- 写入一个A标签href值为"javascript:void(0)"，定义点击事件onclick；-->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- 在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接；-->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
jsBridge.ble.getName(function(name) {
  alert(name);
});

}
</script>
<!--执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可；-->

按钮执行JS示例代码

<button onclick="zhixing()" >执行</button>
<!-- //写一个按钮，定义点击执行事件； -->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- //在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接； -->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
jsBridge.ble.getName(function(name) {
  alert(name);
});

}
</script>
<!-- //执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可； -->

requestPermission 请求蓝牙权限 APP开发实现蓝牙通信获取手机蓝牙使用权限

发表于2022年12月29日由yimen

一门APP开发平台通用JS

requestPermission 请求蓝牙权限 APP开发实现蓝牙通信获取手机蓝牙使用权限

核心代码示例，详情参阅demo

//请在调用其他接口之前请求蓝牙权限
//获得权限之后再调用业务接口，否则可能出现闪退现象
jsBridge.ble.requestPermission(function(granted) {
  alert(granted ? "已授权" : "未授权");
});

A标签执行JS示例代码

<a href="javascript:void(0)" onclick="zhixing()">执行</a> 
<!-- 写入一个A标签href值为"javascript:void(0)"，定义点击事件onclick；-->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- 在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接；-->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
//请在调用其他接口之前请求蓝牙权限
//获得权限之后再调用业务接口，否则可能出现闪退现象
jsBridge.ble.requestPermission(function(granted) {
  alert(granted ? "已授权" : "未授权");
});

}
</script>
<!--执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可；-->

按钮执行JS示例代码

<button onclick="zhixing()" >执行</button>
<!-- //写一个按钮，定义点击执行事件； -->
<script src="您的服务器URL/jsbridge-mini.js"></script>
<!-- //在您的服务器引入一门JS地址，请下载jsbridge-mini.js上传您自己的服务器获取链接； -->
<script type="text/javascript">
function zhixing() {


<!--这里可以直接复制JS核心代码到此{}括号内-->
//请在调用其他接口之前请求蓝牙权限
//获得权限之后再调用业务接口，否则可能出现闪退现象
jsBridge.ble.requestPermission(function(granted) {
  alert(granted ? "已授权" : "未授权");
});

}
</script>
<!-- //执行核心代码；
//如果需要进入页面就执行，去掉点击事件即可； -->

APP开发

开发APP从一门开始

标签归档：手机蓝牙

write 向设备写入数据 APP开发实现手机设备蓝牙通信的能力

read 从设备上读取数据 APP开发实现手机设备蓝牙通信的能力

setNotify 监听指定设备特征的数据回发 APP开发实现手机蓝牙通信功能

discoverDescriptors 获取指定设备特征的所有描述符（Descriptor） APP开发实现

discoverCharacteristics 获取指定设备服务的所有特征（Characteristic） APP开发实现手机设备蓝牙通信的能力

discoverServices 获取指定设备的所有服务 APP开发实现手机蓝牙设备权限和通信的能力

stopScan 停止扫描搜索附近设备 APP开发实现手机蓝牙通信能力

scan 开始扫描搜索附近的蓝牙4.0设备 APP开发实现手机设备蓝牙通信能力

getPeripheral 获取当前扫描到的所有设备信息 APP开发实现扫码手机蓝牙设备权限的能力

getName 获取本机蓝牙设备名称 APP开发实现APP启用手机蓝牙通信权限的能力

requestPermission 请求蓝牙权限 APP开发实现蓝牙通信获取手机蓝牙使用权限