（蓝牙低功耗）BLE

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<any>

Instance Members（实例成员）

scan(services, seconds)

在指定的时间内扫描并发现BLE外设。

参数	类型	详情
services	string[]	要发现的服务UUID列表，或[]查找所有设备
seconds	number	运行发现的秒数

****Returns:** Observable<any>
返回在指定时间内通知每个外设的Observable。

startScan(services)

扫描并发现BLE外设直到调用stopScan。

参数	类型	详情
services	string[]	要发现的服务UUID列表，或[]查找所有设备

****Returns:** Observable<any>
返回一个Observable来通知发现的每个外设。

startScanWithOptions(services, options)

扫描BLE设备。 该功能与startScan功能类似，但允许您指定额外的选项（例如允许重复的设备报告）。

参数	类型	详情
services	string[]	要发现的服务UUID列表，或[]查找所有设备
options	any

****Returns:** Observable<any>
返回一个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<any>

isConnected(deviceId)

报告连接状态。

参数	类型	详情
deviceId	string	UUID或外设的MAC地址

****Returns:** Promise<any>

isEnabled()

报告蓝牙是否启用。
****Returns:** Promise<void>
返回一个promise，resolves蓝牙是启用，rejects如果禁用。

showBluetoothSettings()

打开系统蓝牙设置（仅限Android）。
****Returns:** Promise<any>

enable()

在设备上启用蓝牙（仅限Android）。
****Returns:** Promise<any>