1## BLE蓝牙使用说明文档
2
3​		本文档主要介绍了蓝牙专项测试程序的BLE蓝牙部分的功能使用说明。
4
5#### 从主界面跳转到BLE蓝牙部分
6
7![主界面与BLE跳转1](主界面与BLE跳转1.png)
8
9---
10
11#### setting界面
12
13点击"switch"按钮 <img src="switch.png" alt="switch" style="zoom: 50%;" />，设置本设备的BLE参数与配置。
14
15![BLE与BleFilter跳转](BLE与BleFilter跳转.png)
16
17>"BLE扫描过滤参数"，"BLE扫描配置" 默认都为true，是勾选的；值也是默认填好的。**如果不需要更改，无需打开BleFilter界面**。
18>
19>外设MAC地址填了默认值，可根据自己的连接需求更改。
20>
21>BLE扫描过滤参数包括：
22>
23>- 本机MAC地址。
24>- 本机name。
25>- 本机的serviceUUid。
26>
27>BLE扫描配置包括：
28>
29>- interval值 （默认值：0）
30>
31>- dutyMode：(默认值：LOW_POWER )
32>
33>  > - LOW_POWER
34>  > - BALANCED
35>  > - LOW_LATENCY
36>
37>- matchMode:(默认值: MATCH_MODE_AGGRESSIVE)
38>
39>  >- MATCH_MODE_AGGRESSIVE
40>  >- MATCH_MODE_STICKY
41>
42
43
44
45#### BLE蓝牙的主要接口
46
47|    method名称     |        API名称         |                      所需参数                       |    返回值     | 备注 |
48| :---------------: | :--------------------: | :-------------------------------------------------: | :-----------: | :--: |
49|    开始BLE扫描    |      startBLEScan      | (filters: Array<ScanFilter>, options?: ScanOptions) |     void      |      |
50|    停止BLE扫描    |      stopBLEScan       |                         ()                          |     void      |      |
51|  BLE设备查找变化  |   on. BLEDeviceFind    |     (deviceItems: Array<bluetooth.ScanResult>)      |     void      |      |
52| 获取连接的BLE设备 | getConnectedBLEDevices |                         ()                          | Array<string> |      |
53
54注：此处的"创建Gatt服务器"，"创建Gatt客户端"功能只是写了个壳子，其主要功能在Gatt界面中。
55
56
57
58#### 功能
59
60**"蓝牙打开"是其他功能测试的前提**
61
621. 开始/停止BLE扫描
63
64   - 使用指导：
65
66     > 开始BLE扫描：
67     >
68     > - 开始扫描具有筛选器的指定BLE设备。
69     > - filters表示用于筛选出指定设备的筛选器列表。
70     > - options指示扫描的参数，如果用户未指定值，将使用默认值。
71     >
72     > 停止BLE扫描。
73
74   - 限制条件：只能扫描到指定BLE设备。
75
76   - 验证方法：根据弹窗消息查看已扫描到的BLE
77
782. BLE设备查找变化
79
80   - 使用指导：为回调函数，用来监听相关类型事件的变化，并弹窗显示信息。
81     - 订阅BLE扫描结果。
82     - type为要侦听的扫描结果事件的类型。
83     - callback回调用于侦听扫描结果事件。
84   - 限制条件：需要在相关类型事件发生改变前，开启监听。
85   - 验证方法：在事件变化后，查看是否有弹窗信息显示。
86
873. 获取连接的BLE设备
88
89   - 使用指导：点击后，可获取到处于连接状态的设备列表。
90   - 限制条件：开始BLE扫描，并发现了可连接的设备，连接后，才可以获取此设备的相关信息。
91   - 验证方法：在设备设置中，查看已经连接的设备。
92
93
94
95
96
97
98
99
100
101
102
103