BLE
此插件可实现手机与蓝牙低功耗（BLE）外设之间的通信。
该插件为iOS和Android提供了一个简单的JavaScript API。
- 扫描外围设备
- 连接到外设
- 读取一个特征的值
- 将新值写入特征
- 特征值发生变化时收到通知
扫描外围设备时会返回广告信息。 连接到外围设备时返回服务，特性和属性信息。 所有访问都是通过服务和特征的UUID。 该插件在内部管理句柄。
支持与多个外设的同时连接。
Repo（备用）: https://github.com/don/cordova-plugin-ble-central
Installation（安装）
安装Cordova和Ionic原生插件:
$ ionic cordova plugin add cordova-plugin-ble-central
$ npm install --save @ionic-native/ble
2.添加插件到app's module
Supported platforms（支持平台）
Android
iOS
Usage（用法）
import { BLE } from '@ionic-native/ble';
constructor(private ble: BLE) { }
Peripheral Data（外设数据）
扫描和连接时，外设数据通过成功回调传递。 扫描时传递有限的数据。
{
'name': 'Battery Demo',
'id': '20:FF:D0:FF:D1:C0',
'advertising': [2,1,6,3,3,15,24,8,9,66,97,116,116,101,114,121],
'rssi': -55
}
连接后，外围对象还包括服务，特征和描述符信息。
{
'name': 'Battery Demo',
'id': '20:FF:D0:FF:D1:C0',
'advertising': [2,1,6,3,3,15,24,8,9,66,97,116,116,101,114,121],
'rssi': -55,
'services': [
'1800',
'1801',
'180f'
],
'characteristics': [
{
'service': '1800',
'characteristic': '2a00',
'properties': [
'Read'
]
},
{
'service': '1800',
'characteristic': '2a01',
'properties': [
'Read'
]
},
{
'service': '1801',
'characteristic': '2a05',
'properties': [
'Read'
]
},
{
'service': '180f',
'characteristic': '2a19',
'properties': [
'Read'
],
'descriptors': [
{
'uuid': '2901'
},
{
'uuid': '2904'
}
]
}
]
}
Advertising Data（广告数据）
蓝牙广告数据在扫描设备时返回。 格式因平台而异。 在Android广告数据将是原始广告字节。 iOS不允许访问原始广告数据，因此返回数据字典。
Android和iOS的广告信息似乎是广告数据和扫描响应数据的组合。
Android
{
'name': 'demo',
'id': '00:1A:7D:DA:71:13',
'advertising': ArrayBuffer,
'rssi': -37
}
将广告信息转换为Uint8Array进行处理。
var adData = new Uint8Array（peripheral.advertising）
iOS
请注意，iOS使用常量的字符串值 广告数据检索密钥. 这将来可能会发生变化。
{
'name': 'demo',
'id': 'D8479A4F-7517-BCD3-91B5-3302B2F81802',
'advertising': {
'kCBAdvDataChannel': 37,
'kCBAdvDataServiceData': {
'FED8': {
'byteLength': 7 // data not shown
}
},
'kCBAdvDataLocalName': 'demo',
'kCBAdvDataServiceUUIDs': ['FED8'],
'kCBAdvDataManufacturerData': {
'byteLength': 7 // data not shown
},
'kCBAdvDataTxPowerLevel': 32,
'kCBAdvDataIsConnectable': true
},
'rssi': -53
}
Typed Arrays（类型数组）
此插件使用类型的数组或ArrayBuffers发送和接收数据。
这意味着在发送和ArrayBuffers之前，您需要将数据转换为ArrayBuffers。
// ASCII only
function stringToBytes(string) {
var array = new Uint8Array(string.length);
for (var i = 0, l = string.length; i < l; i++) {
array[i] = string.charCodeAt(i);
}
return array.buffer;
}
// ASCII only
function bytesToString(buffer) {
return String.fromCharCode.apply(null, new Uint8Array(buffer));
}
您可以在这些文章中阅读有关类型数组的更多信息MDN 和 HTML5 Rocks.
UUIDs
UUID始终是字符串而不是数字。 一些16位UUID，例如“2220”看起来像整数，但它们不是。 （整数2220是十六进制0x8AC）128位UUID不是问题，因为它们看起来像字符串82b9e6e1-593a-456f-be9b-9215160ebcac。 所有16位UUID也应该作为字符串传递给方法。
Static Members（静态成员）
readRSSI(deviceId)
读取设备连接上的RSSI值。
| 参数 | 类型 | 详情 |
|---|---|---|
| deviceId | string | UUID或外设的MAC地址 |
****Returns:** Promise
Instance Members（实例成员）
scan(services, seconds)
在指定的时间内扫描并发现BLE外设。
| 参数 | 类型 | 详情 |
|---|---|---|
| services | string[] | 要发现的服务UUID列表，或[]查找所有设备 |
| seconds | number | 运行发现的秒数 |
****Returns:** Observable
返回在指定时间内通知每个外设的Observable。
startScan(services)
扫描并发现BLE外设直到调用stopScan。
| 参数 | 类型 | 详情 |
|---|---|---|
| services | string[] | 要发现的服务UUID列表，或[]查找所有设备 |
****Returns:** Observable
返回一个Observable来通知发现的每个外设。
startScanWithOptions(services, options)
扫描BLE设备。 该功能与startScan功能类似，但允许您指定额外的选项（例如允许重复的设备报告）。
| 参数 | 类型 | 详情 |
|---|---|---|
| services | string[] | 要发现的服务UUID列表，或[]查找所有设备 |
| options | any |
****Returns:** Observable
返回一个Observable来通知发现的每个外设。
stopScan()
停止由startScan启动的扫描.
****Returns:** returns a Promise.
connect(deviceId)
连接到外设。
| 参数 | 类型 | 详情 |
|---|---|---|
| deviceId | string | UUID或外设的MAC地址 |
****Returns:**
返回通知连接/断开连接的Observable。
disconnect(deviceId)
断开与外围设备的连接。
| 参数 | 类型 | 详情 |
|---|---|---|
| deviceId | string | UUID或外设的MAC地址 |
****Returns:** Returns a Promise
read(deviceId, serviceUUID, characteristicUUID)
读取一个特征的值。
| 参数 | 类型 | 详情 |
|---|---|---|
| deviceId | string | UUID或外设的MAC地址 |
| serviceUUID | string | 蓝牙服务的UUID |
| characteristicUUID | string | UUID的BLE特性 |
****Returns:** Returns a Promise
write(deviceId, serviceUUID, characteristicUUID, value)
写一个特征值。
| 参数 | 类型 | 详情 |
|---|
deviceId|string|UUID或外设的MAC地址
serviceUUID|string|蓝牙服务的UUID
characteristicUUID|string|UUID的BLE特性
value|ArrayBuffer|数据写入特性，作为ArrayBuffer。
****Returns:** Returns a Promise
writeWithoutResponse(deviceId, serviceUUID, characteristicUUID, value)
在不等待外设确认的情况下写入特性值。
| 参数 | 类型 | 详情 |
|---|---|---|
| deviceId | string | UUID或外设的MAC地址 |
| serviceUUID | string | 蓝牙服务的UUID |
| characteristicUUID | string | UUID的BLE特性 |
| value | ArrayBuffer | 数据写入特性，作为ArrayBuffer。 |
****Returns:** Returns a Promise
startNotification(deviceId, serviceUUID, characteristicUUID)
当特征值发生变化时注册通知。
| 参数 | 类型 | 详情 |
|---|---|---|
| deviceId | string | UUID或外设的MAC地址 |
| serviceUUID | string | 蓝牙服务的UUID |
| characteristicUUID | string | UUID的BLE特性 |
****Returns:**
返回通知特征变化的Observable。
stopNotification(deviceId, serviceUUID, characteristicUUID)
当特征值变化时，停止通知。
| 参数 | 类型 | 详情 |
|---|---|---|
| deviceId | string | UUID或外设的MAC地址 |
| serviceUUID | string | 蓝牙服务的UUID |
| characteristicUUID | string | UUID的BLE特性 |
****Returns:** Promise
isConnected(deviceId)
报告连接状态。
| 参数 | 类型 | 详情 |
|---|---|---|
| deviceId | string | UUID或外设的MAC地址 |
****Returns:** Promise
isEnabled()
报告蓝牙是否启用。
****Returns:** Promise
返回一个promise，resolves蓝牙是启用，rejects如果禁用。
showBluetoothSettings()
打开系统蓝牙设置（仅限Android）。
****Returns:** Promise
enable()
在设备上启用蓝牙（仅限Android）。
****Returns:** Promise