简介
wx-ble 是一个基于微信小程序的封装库，用于进行 BLE（Bluetooth Low Energy）通信。微信小程序与 BLE 通信的 API 比较底层，使用起来不是特别方便，因此 wx-ble 封装了 BLE 通信常用操作，提供了更加简便的 API 接口供开发者使用。
wx-ble 主要特点：
- 封装了 BLE 通信的常用操作，提供了方便的 API 接口。
- 可以方便地实现连接、搜索、接收数据以及发送数据等操作。
- 简单易用，适用于初学者和高级开发者。
使用教程
安装 wx-ble
在微信小程序开发工具的控制台中执行以下命令进行安装：
npm install wx-ble
初始化 wx-ble
在小程序的 app.js 文件中引入 wx-ble，并在 onLaunch 生命周期中进行初始化：
const wxBle = require('wx-ble')
App({
onLaunch() {
wxBle.init();
}
})扫描设备
使用 startScan 方法开始扫描设备，该方法接受一个参数 options，用于指定需要扫描的设备类型和扫描周期等参数：
// 扫描指定设备类型，周期为 2 秒
wxBle.startScan({
services: ['0000fff0-0000-1000-8000-00805f9b34fb'],
duration: 2000
}).subscribe(device => {
console.log('扫描到设备：', device)
})连接设备
使用 connect 方法连接指定设备，该方法会返回一个可观察对象，当设备连接成功或失败时会分别触发 next 和 error 事件：
// 连接指定设备
wxBle.connect(deviceId).subscribe(
() => console.log('连接成功'),
(err) => console.log('连接失败：', err)
)发送数据
使用 write 方法向设备发送数据，该方法会返回一个 Promise，当数据发送成功或失败时会 resolve 或 reject 该 Promise：
const data = new Uint8Array([0x00, 0x01, 0x02, 0x03])
// 向已连接的设备写入数据
wxBle.write(deviceId, serviceId, characteristicId, data).then(
() => console.log('发送成功'),
(err) => console.log('发送失败：', err)
)接收数据
使用 notify 方法订阅设备发来的数据，该方法会返回一个可观察对象，当设备发来数据时会触发 next 事件：
// 订阅设备通知
wxBle.notify(deviceId, serviceId, characteristicId).subscribe(data => {
console.log('设备发来数据：', data)
})示例代码
下面是一个完整的示例代码，演示了如何使用 wx-ble 进行设备扫描、连接、数据读取和写入等操作：
-- -------------------- ---- -------
----- ----- - -----------------
------
----- -
--------- ---
----------- ---
--------- ---
--------- ---
---------- ---
------------ -----
--
-- ------
----------- -
-----------------
--------- -----------------------------------------
--------- ----
------------------- -- -
--------------------- -------
--------------
--------- ----------------
----------- ----------------
--
----------------
--
--
-- ----
--------- -
---------------- ------ --------- ----- ---- --
--------------------------------------------
-- -- -
-------------------
----------------
-------------- ------------ ---- --
------------------
--
----- -- -
-------------------- ----
----------------
-------------- ------ ------- ----- ------- --
-
-
--
-- ------
------------ -
------------------------------------------
-- -- -
---------------------
--------------
------------ ------
--------- ---
--------- ---
---------- --
--
--
----- -- ---------------------- ----
-
--
-- ---------
------------- -
-------------------------------------------------------- -- -
--------------------- ---------
-------------- -------- --
--
--
-- -------------
--------------------- -
----- --------- - ---------------------------------
-------------------------------------------- ---------------------
--------------- -- ---------------------- -----------------
--- -- ----------------------- ----
-
--
-- --------
--------------------- -
----- --------- - ---------------------------------
----- ---------------- - ----------------------------------------
------------------------------ ---------- -----------------------
---- -- -------------- --------- ------------------ ---
--- -- ---------------------- ----
-
--
-- -------
---------------------- -
----- --------- - ---------------------------------
----- ---------------- - ----------------------------------------
----- ---- - ---------------------------------
------------------------------- ---------- ----------------- -----------
-- -- --------------------
--- -- -------------------- ----
-
-
--总结
wx-ble 是一个非常实用的小程序蓝牙库，其封装了 BLE 通信常用操作，使用起来非常方便。本文通过一步步学习 wx-ble 的使用方式，掌握它的使用技巧，并通过示例代码来帮助读者更好地理解和运用 wx-ble。相信读者在阅读本文后，能够更好地掌握 wx-ble 的使用，并在实际开发中能够更加灵活地应用 wx-ble，提高自己的开发效率。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600671158dd3466f61ffe610