轉(zhuǎn)載請(qǐng)注明出處 :?http://blog.csdn.net/shulianghan/article/details/50515359

參考 :?

-- 官方文檔 : https://developer.android.com/guide/topics/connectivity/bluetooth-le.html;

1. 概述

BLE 概述 :?

-- 版本支持 :?Android 4.3 (API Level 18) 內(nèi)置框架引入了 藍(lán)牙低功耗方案 (Bluetooth Low Energy, BLE) 支持;?

-- 角色支持 : Android 手機(jī)只能作為 主設(shè)備 (central role), 開發(fā)者開發(fā)的 APP 可以使用其提供的 API 接口, 用于 發(fā)現(xiàn)設(shè)備, 遍歷服務(wù) (services), ?讀寫服務(wù)中的特性 (characteristics).?

-- 傳統(tǒng)藍(lán)牙對(duì)比 : 與傳統(tǒng)的藍(lán)牙對(duì)比, 藍(lán)牙低功耗方案 (Bluetooth Low Energy) 是出于更低的電量消耗考慮而設(shè)計(jì)的. 這可以使 Android 應(yīng)用可以與 BLE 設(shè)備進(jìn)行交流, 這些設(shè)備需要很低的電量, 如 近距離傳感器, 心率測量設(shè)備, 健康設(shè)備 等等.

2. 關(guān)鍵術(shù)語 和 概念

(1) Generic Attribute Profile (GATT) 通用屬性規(guī)范

Generic Attribute Profile (GATT) 通用屬性規(guī)范?:?

-- GATT 作用 : GATT 規(guī)范是一個(gè)針對(duì) 在 BLE 連接上的, 發(fā)送 和 接收 少量數(shù)據(jù)的一個(gè)規(guī)范, 所有的現(xiàn)有的低功耗應(yīng)用的規(guī)范都是基于這個(gè) GATT 規(guī)范制定的.

-- 制定者 : 藍(lán)牙技術(shù)聯(lián)盟 (Bluetooth SIG) 為低功耗設(shè)備定義了許多規(guī)范, 一個(gè) 規(guī)范 (Profile) 就是 設(shè)備如何在特定的應(yīng)用中工作的詳述.?

-- 設(shè)備規(guī)范對(duì)應(yīng)關(guān)系 : 此外, 一個(gè)設(shè)備可以實(shí)現(xiàn)多個(gè)規(guī)范, 如 : 一個(gè)設(shè)備可以包含一個(gè)心率檢測器, 和 電量檢測器.

(2) Attribute Protocol?(ATT) 屬性協(xié)議

Attribute Protocol (ATT) 屬性協(xié)議 :?

-- ATT 與 GATT 關(guān)系 : GATT 規(guī)范是建立在 ATT 的上一層的, 這套改改通常被稱為 GATT/ATT.?

-- ATT 作用 : ATT 被用于優(yōu)化 BLE 設(shè)備的運(yùn)行, 為了這個(gè)目的, ATT (屬性協(xié)議) 使用盡可能少的字節(jié).?

-- ATT 唯一標(biāo)識(shí) : ATT 中的每個(gè)屬性都被 一個(gè) UUID (Universally Unique Identifier) 獨(dú)一無二的進(jìn)行標(biāo)識(shí), UUID 是一個(gè) 128 比特的標(biāo)準(zhǔn)的字符串 ID, 用于信息的唯一標(biāo)識(shí).?

-- ATT 屬性 : ATT 中定義的屬性就是 Charicteristics (特性) 和 Services (服務(wù));

(3) Characteristic 特性

Characteristic 特性 :?

-- Characteristic 概念 : 一個(gè) Characteristic 特性包含了一個(gè)值 和 多個(gè) Descriptor (描述符) 用于描述這個(gè)特性的值.?

-- 本質(zhì) : 一個(gè)特性可以被認(rèn)為是一個(gè)類型, 類似于一個(gè)類.

(4) Descriptor 描述符

Descriptor 描述符 :?

-- 作用 : 描述符 被定義為一些屬性, 這些屬性用于描述 Characteristic (特性) 的值.?

-- 示例 : 例如, 一個(gè) 描述符 可以說明一個(gè) 可讀的描述, 一個(gè) 特性值的可接受范圍, 或者 一個(gè)特性值的測量單元.

(5) Service 服務(wù)

Service 服務(wù) :?

-- 服務(wù)本質(zhì) : 服務(wù)是 Characteristic (特性) 的集合.?

-- 示例 : 如, 你可以有一個(gè) 名稱為 "Heart Rate?Monitor (心率監(jiān)控)" 的服務(wù), 包含了特性 "Heart Rate Measurement (心率測量)".?

-- 參考資料 : 你可以在 bluetooth.org 官網(wǎng)查詢到一個(gè)基于 GATT 服務(wù) 和 規(guī)范的列表.

3. 角色 和 職責(zé)

(1) 四種角色

Android 設(shè)備 與 BLE 設(shè)備互動(dòng)時(shí), 設(shè)備的角色 和 職責(zé) :?

-- 中心設(shè)備 和 外圍設(shè)備 : 這個(gè)角色體系適用于 BLE 連接. 中心設(shè)備角色 可以掃描, 查找廣播. 外圍設(shè)備角色 發(fā)送廣播.

-- GATT 服務(wù)器 和 GATT 客戶端 : 這個(gè)決定了兩個(gè)設(shè)備之間, 一旦建議連接后, 如何進(jìn)行互相通信.

(2) 中心設(shè)備 和 外圍設(shè)備

BLE 連接需要兩種設(shè)備都存在 : 為了理解其中的區(qū)別, 想象一下 你有一個(gè) Android 設(shè)備 和 一個(gè)激活的 智能腕表?藍(lán)牙設(shè)備. 手機(jī)支持作為 中心設(shè)備 角色, 智能腕表 藍(lán)牙設(shè)備支持作為外圍設(shè)備角色, 為了建立 BLE 連接, 只有外圍設(shè)備 或者 只有 中心設(shè)備 都不能建立 BLE?連接.

(3) GATT 服務(wù)器 和 GATT 客戶端

GATT 服務(wù)器 和 GATT 客戶端 簡介 :?

-- GATT 服務(wù)器 和 GATT 客戶端 角色不是固定的 : 一旦手機(jī) 和 智能腕表 設(shè)備建立了 BLE 連接, 它們開始互相交換 GATT 元數(shù)據(jù). 根據(jù)它們之間傳輸?shù)臄?shù)據(jù)類型, 其中的一個(gè)會(huì)扮演 GATT 服務(wù)器的角色.?

-- 角色改變示例 : 如果 智能腕表 設(shè)備想要向手機(jī)報(bào)告?zhèn)鞲衅鲾?shù)據(jù), 那么智能腕表必須當(dāng)做 GATT 服務(wù)器. 如果智能腕表 想要從手機(jī)上接受更新數(shù)據(jù), 那么 Android 手機(jī)就是 GATT 服務(wù)器.

-- 手機(jī) 和 設(shè)備 都可以作為 GATT 服務(wù)器 和 客戶端 : 在本文檔中使用的示例代碼, 在 Android 設(shè)備上運(yùn)行的 Android APP 就是 GATT 客戶端, BLE 外圍設(shè)備?就是 GATT 服務(wù)器. Android APP 從 GATT 服務(wù)器上獲取數(shù)據(jù), 服務(wù)器的 BLE "heart rate monitor (心率監(jiān)測)" 支持 "Heart Rate Profile (心率規(guī)范 - 一種 BLE 藍(lán)牙標(biāo)準(zhǔn)規(guī)范)". Android APP 也可以作為 GATT 服務(wù)器;

4. BLE 權(quán)限

(1) 藍(lán)牙權(quán)限簡介

Android 藍(lán)牙權(quán)限簡介 :?

-- 權(quán)限作用 : 為了在應(yīng)用中使用藍(lán)牙功能, 必須在 AndroidManifest.xml?中 聲明藍(lán)牙權(quán)限. 所有的藍(lán)牙通信操作都需要 藍(lán)牙權(quán)限 來允許執(zhí)行, 例如 搜索藍(lán)牙, 藍(lán)牙連接, 數(shù)據(jù)交互等操作.

-- 搜索設(shè)置藍(lán)牙權(quán)限 : 如果 APP 要發(fā)起設(shè)備搜索 或者 管理 藍(lán)牙設(shè)置, 需要 提前聲明 BLUETOOTH_ADMIN 權(quán)限.?

-- 注意 : 使用 BLUETOOTH_ADMIN 權(quán)限的前提是 必須聲明 BLUETOOTH 權(quán)限.

(2) 藍(lán)牙權(quán)限簡介

藍(lán)牙權(quán)限示例 :?

-- AndroidManifest.xml 聲明藍(lán)牙權(quán)限示例 :?

<uses-permission android:name="android.permission.BLUETOOTH"/> <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
-- 充當(dāng) BLE 設(shè)備權(quán)限 : 如果你的 APP 只需要?jiǎng)偃?BLE 設(shè)備的工作, 只需要如下配置 :?

<uses-feature android:name="android.hardware.bluetooth_le" android:required="true"/>

(3) 動(dòng)態(tài)控制 BLE 功能是否使用

動(dòng)態(tài)控制 BLE 是否可用 : 不管怎樣, 如果你想要讓你的 APP 可以當(dāng)做 BLE 設(shè)備, 但是手機(jī)不支持這個(gè)操作, 你仍然可以進(jìn)行如下配置, 只是將其中的 android:required 設(shè)置成 false. 此時(shí)在運(yùn)行時(shí), 你可以使用 "PackageManager.hasSystemFeature()" 方法決定 BLE 是否可用.

//使用下面的函數(shù)決定 設(shè)備上的 BLE 功能 是否可用 //此時(shí)你可以選擇性的關(guān)閉 BLE 相關(guān)的功能 if (!getPackageManager().hasSystemFeature(PackageManager.FEATURE_BLUETOOTH_LE)) {Toast.makeText(this, R.string.ble_not_supported, Toast.LENGTH_SHORT).show();finish(); }

5. 創(chuàng)建 BLE

(1) 創(chuàng)建 BLE 簡介

創(chuàng)建 BLE 簡介 :?

-- 驗(yàn)證 BLE 功能 : 在應(yīng)用可以通過 BLE 交互之前, 你需要驗(yàn)證設(shè)備是否支持 BLE 功能, 如果支持, 確定它是可以使用的.?

-- 注意 : 這個(gè)檢查只有在 下面的配置 設(shè)置為 false 時(shí)才是必須的;

<uses-feature android:name="android.hardware.bluetooth_le" android:required="true"/>
-- 不支持 BLE 關(guān)閉相關(guān)功能 : 如果 Android 手機(jī)不支持 BLE 功能, 你應(yīng)該優(yōu)雅的 關(guān)閉 BLE 相關(guān)功能.?

-- 支持 BLE 打開藍(lán)牙 : 如果 BLE 支持 BLE 功能, 但是設(shè)備的藍(lán)牙是關(guān)閉的, 你可以在應(yīng)用中請(qǐng)求打開設(shè)備的藍(lán)牙模塊.?

-- 步驟總結(jié) : 創(chuàng)建 BLE 藍(lán)牙的過程分成兩個(gè)步驟, 1. 獲取 BluetoothAdapter, 2. 打開 設(shè)備的藍(lán)牙模塊.

(2) 獲取 BluetoothAdapter (藍(lán)牙適配器)

獲取 BluetoothAdapter 藍(lán)牙適配器 :?

-- BluetoothAdapter 類作用 : 所有的藍(lán)牙活動(dòng)都需要 BluetoothAdapter, BluetoothAdapter 代表了設(shè)備本身的藍(lán)牙適配器 (藍(lán)牙無線設(shè)備). 整個(gè)系統(tǒng)中只有一個(gè) 藍(lán)牙適配器, 應(yīng)用可以使用 BluetoothAdapter 對(duì)象與 藍(lán)牙適配器硬件進(jìn)行交互.?

-- 獲取 BluetoothAdapter 代碼示例 :?

// 初始化藍(lán)牙適配器 final BluetoothManager bluetoothManager =(BluetoothManager) getSystemService(Context.BLUETOOTH_SERVICE); mBluetoothAdapter = bluetoothManager.getAdapter();

-- 注意 : 這個(gè)方法使用了 getSystemService() 方法, 返回了一個(gè) BluetoothManager 實(shí)例對(duì)象, 從 BluetoothManager 實(shí)例對(duì)象中可以獲取 BluetoothAdapter 對(duì)象;

(3) 打開藍(lán)牙功能

打開藍(lán)牙 :?

-- 檢查是否可用 : 為了保證 藍(lán)牙功能是打開的, 調(diào)用 BluetoothAdapter 的 isEnable() 方法, 檢查藍(lán)牙在當(dāng)前是否可用. 如果返回 false, 說明當(dāng)前藍(lán)牙不可用.?

-- 示例代碼 :?

private BluetoothAdapter mBluetoothAdapter; ... // 確認(rèn)當(dāng)前設(shè)備的藍(lán)牙是否可用, // 如果不可用, 彈出一個(gè)對(duì)話框, 請(qǐng)求打開設(shè)備的藍(lán)牙模塊 if (mBluetoothAdapter == null || !mBluetoothAdapter.isEnabled()) {Intent enableBtIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT); }

6. 查找 BLE 設(shè)備

(1) 查找所有的?BLE 設(shè)備

查找 BLE 設(shè)備 :?

-- 查找方法參數(shù) : 為了搜索到?BLE 設(shè)備, 調(diào)用 BluetoothAdapter 的 startLeScan() 方法, 該方法需要一個(gè) BluetoothAdapter.LeScanCallback 類型的參數(shù). 你必須實(shí)現(xiàn)這個(gè) LeScanCallback 接口, 因?yàn)?BLE 藍(lán)牙設(shè)備掃描結(jié)果在這個(gè)接口中返回.?

-- 查找策略 : 藍(lán)牙搜索是非常耗電的, 你需要遵守以下的 中斷策略 和 不循環(huán)策略.

-- 中斷策略 : 只要一發(fā)現(xiàn)藍(lán)牙設(shè)備, 馬上中斷掃描.

-- 不循環(huán)策略 : 不要循環(huán)掃描, 設(shè)置一個(gè)掃描的最大時(shí)間限制. 一個(gè)設(shè)備在之前可用, 繼續(xù)掃描可能會(huì)使設(shè)備不可用, 此外繼續(xù)掃描會(huì)持續(xù)浪費(fèi)電池電量.

-- 源碼示例 :?

/*** 搜索 和 展示 可用的藍(lán)牙設(shè)備 的 Activity 界面*/ public class DeviceScanActivity extends ListActivity {private BluetoothAdapter mBluetoothAdapter;private boolean mScanning;private Handler mHandler;// 10 秒后停止搜索private static final long SCAN_PERIOD = 10000;...private void scanLeDevice(final boolean enable) {if (enable) {// 在一個(gè)預(yù)先定義的時(shí)間段后停止掃描.mHandler.postDelayed(new Runnable() {@Overridepublic void run() {mScanning = false;//開始掃描mBluetoothAdapter.stopLeScan(mLeScanCallback);}}, SCAN_PERIOD);mScanning = true;mBluetoothAdapter.startLeScan(mLeScanCallback);} else {mScanning = false;mBluetoothAdapter.stopLeScan(mLeScanCallback);}...} ... }

(2) 查找特定?BLE 設(shè)備

查找特定 BLE 設(shè)備 :?

-- 方法調(diào)用 : 查找特定類型的外圍設(shè)備, 可以調(diào)用下面的方法, 這個(gè)方法需要提供一個(gè) UUID 對(duì)象數(shù)組, 這個(gè) UUID 數(shù)組是 APP 支持的 GATT 服務(wù)的特殊標(biāo)識(shí).

-- 示例 :?

startLeScan(UUID[], BluetoothAdapter.LeScanCallback)

(3) BluetoothAdapter.LeScanCallback 回調(diào)接口

掃描回調(diào)接口 :?

-- 接口作用 : BluetoothAdapter.LeScanCallback 實(shí)現(xiàn)類, 在這個(gè)實(shí)現(xiàn)類的接口中返回 BLE 設(shè)備掃描結(jié)果;

-- 源碼示例 :?

private LeDeviceListAdapter mLeDeviceListAdapter; ... // 設(shè)備掃描回調(diào)接口 private BluetoothAdapter.LeScanCallback mLeScanCallback =new BluetoothAdapter.LeScanCallback() {@Overridepublic void onLeScan(final BluetoothDevice device, int rssi,byte[] scanRecord) {runOnUiThread(new Runnable() {@Overridepublic void run() {mLeDeviceListAdapter.addDevice(device);mLeDeviceListAdapter.notifyDataSetChanged();}});} };

(4) 設(shè)備掃描類型

設(shè)備掃描類型 : 藍(lán)牙設(shè)備掃描 在同一個(gè)時(shí)間掃描時(shí), 只能掃描 BLE 設(shè)備 或者 SPP 設(shè)備中的一種, 不能同時(shí)掃描兩種設(shè)備.

7. 連接到 GATT 服務(wù)

(1) 連接指定 BluetoothDevice 藍(lán)牙設(shè)備

連接指定設(shè)備 :?

-- 連接到 GATT 服務(wù) : 與 BLE 設(shè)備交互的第一步是 連接到 BLE 設(shè)備中的 GATT 服務(wù).?

-- 實(shí)現(xiàn)方法 : 調(diào)用 BluetoothDevice 的 connectGatt() 方法可以連接到 BLE 設(shè)備的 GATT 服務(wù).?

-- 參數(shù)解析 : connectGatt() 方法需要三個(gè)參數(shù), 參數(shù)一 Context 上下文對(duì)象, 參數(shù)二 boolean autoConnect 是否自動(dòng)連接掃描到的藍(lán)牙設(shè)備, 參數(shù)三 BluetoothGattCallback 接口實(shí)現(xiàn)類.?

-- 用法示例 :?

mBluetoothGatt = device.connectGatt(this, false, mGattCallback);

-- 獲取 BluetoothGatt 對(duì)象 : 調(diào)用 connectGatt() 方法可以連接到 BLE 設(shè)備上的 GATT 服務(wù), 返回一個(gè) BluetoothGatt 實(shí)例對(duì)象, 你可以使用這個(gè)對(duì)象去 管理 GATT 客戶端操作.?

-- GATT 客戶端操作 : Android APP 可以調(diào)用 GATT Client (客戶端). BluetoothGattCallback 可以用于傳遞結(jié)果到 GATT 客戶端, 如 連接狀態(tài) 和 更進(jìn)一步的 GATT Client 操作.

(2) GATT 數(shù)據(jù)交互示例

BLE 藍(lán)牙數(shù)據(jù)交互 :?

-- 界面 : 在下面的示例中, BLE 應(yīng)用提供了一個(gè) Activity 界面, 該 Activity 界面用于 連接, 展示數(shù)據(jù), 展示 GATT 服務(wù) 和 設(shè)備支持的特性.?

-- BLE 藍(lán)牙服務(wù)類 : 基于用戶的輸入, 這個(gè) Activity 界面可以與一個(gè) BluetoothLeService 的服務(wù)進(jìn)行交流, 該交流的本質(zhì)就是 BLE 設(shè)備的 GATT 服務(wù) 與 Android 的 BLE API 進(jìn)行交流.

-- BLE 藍(lán)牙服務(wù)類 示例代碼 :?

// BLE 設(shè)備可以通過該服務(wù) 與 Android 的 BLE API 進(jìn)行互動(dòng) public class BluetoothLeService extends Service {private final static String TAG = BluetoothLeService.class.getSimpleName();private BluetoothManager mBluetoothManager;private BluetoothAdapter mBluetoothAdapter;private String mBluetoothDeviceAddress;private BluetoothGatt mBluetoothGatt;private int mConnectionState = STATE_DISCONNECTED;private static final int STATE_DISCONNECTED = 0;private static final int STATE_CONNECTING = 1;private static final int STATE_CONNECTED = 2;public final static String ACTION_GATT_CONNECTED ="com.example.bluetooth.le.ACTION_GATT_CONNECTED";public final static String ACTION_GATT_DISCONNECTED ="com.example.bluetooth.le.ACTION_GATT_DISCONNECTED";public final static String ACTION_GATT_SERVICES_DISCOVERED ="com.example.bluetooth.le.ACTION_GATT_SERVICES_DISCOVERED";public final static String ACTION_DATA_AVAILABLE ="com.example.bluetooth.le.ACTION_DATA_AVAILABLE";public final static String EXTRA_DATA ="com.example.bluetooth.le.EXTRA_DATA";public final static UUID UUID_HEART_RATE_MEASUREMENT =UUID.fromString(SampleGattAttributes.HEART_RATE_MEASUREMENT);// BLE API 中定義的不同的回調(diào)方法.private final BluetoothGattCallback mGattCallback =new BluetoothGattCallback() {@Override// BLE 設(shè)備的狀態(tài)改變 連接 斷開public void onConnectionStateChange(BluetoothGatt gatt, int status,int newState) {String intentAction;if (newState == BluetoothProfile.STATE_CONNECTED) {intentAction = ACTION_GATT_CONNECTED;mConnectionState = STATE_CONNECTED;broadcastUpdate(intentAction);Log.i(TAG, "連接到了 GATT 服務(wù).");Log.i(TAG, "嘗試搜索服務(wù):" +mBluetoothGatt.discoverServices());} else if (newState == BluetoothProfile.STATE_DISCONNECTED) {intentAction = ACTION_GATT_DISCONNECTED;mConnectionState = STATE_DISCONNECTED;Log.i(TAG, "于 GATT 服務(wù)斷開連接.");broadcastUpdate(intentAction);}}@Override// BLE 設(shè)備中 新的 GATT 服務(wù)被發(fā)現(xiàn)public void onServicesDiscovered(BluetoothGatt gatt, int status) {if (status == BluetoothGatt.GATT_SUCCESS) {broadcastUpdate(ACTION_GATT_SERVICES_DISCOVERED);} else {Log.w(TAG, "發(fā)現(xiàn) GATT 服務(wù) : " + status);}}@Override// 特性讀取操作返回的數(shù)據(jù)public void onCharacteristicRead(BluetoothGatt gatt,BluetoothGattCharacteristic characteristic,int status) {if (status == BluetoothGatt.GATT_SUCCESS) {broadcastUpdate(ACTION_DATA_AVAILABLE, characteristic);}}...}; ... }

-- 廣播發(fā)送 : 當(dāng)一個(gè)特定的回調(diào)被觸發(fā), 它調(diào)用適當(dāng)?shù)?broadcastUpdate() 幫助方法, 將其當(dāng)做一個(gè) Action 操作傳遞出去.?

-- 注意藍(lán)牙心率?: 這部分的數(shù)據(jù)解析 與 藍(lán)牙心率測量 是一起被執(zhí)行的.

-- 廣播發(fā)送 示例代碼 :?

private void broadcastUpdate(final String action) {final Intent intent = new Intent(action);sendBroadcast(intent); }private void broadcastUpdate(final String action,final BluetoothGattCharacteristic characteristic) {final Intent intent = new Intent(action);// This is special handling for the Heart Rate Measurement profile. Data// parsing is carried out as per profile specifications.// 心率監(jiān)測規(guī)范的特殊處理// 數(shù)據(jù)解析在每個(gè)規(guī)范中完成if (UUID_HEART_RATE_MEASUREMENT.equals(characteristic.getUuid())) {int flag = characteristic.getProperties();int format = -1;if ((flag & 0x01) != 0) {format = BluetoothGattCharacteristic.FORMAT_UINT16;Log.d(TAG, "心率格式 UINT16.");} else {format = BluetoothGattCharacteristic.FORMAT_UINT8;Log.d(TAG, "心率格式 UINT8.");}final int heartRate = characteristic.getIntValue(format, 1);Log.d(TAG, String.format("接收到心跳檢測 : %d", heartRate));intent.putExtra(EXTRA_DATA, String.valueOf(heartRate));} else {// 對(duì)于其它的規(guī)范, 寫出 HEX 十六進(jìn)制格式的數(shù)據(jù)final byte[] data = characteristic.getValue();if (data != null && data.length > 0) {final StringBuilder stringBuilder = new StringBuilder(data.length);for(byte byteChar : data)stringBuilder.append(String.format("%02X ", byteChar));intent.putExtra(EXTRA_DATA, new String(data) + "\n" +stringBuilder.toString());}}sendBroadcast(intent); }
-- 處理廣播事件 : 在 DeviceControlActivity 中處理廣播事件, 示例代碼 :?

// 處理 Service 發(fā)起的的不同事件 // ACTION_GATT_CONNECTED: 連接到 GATT 服務(wù). // ACTION_GATT_DISCONNECTED: 與 GATT 服務(wù)斷開. // ACTION_GATT_SERVICES_DISCOVERED: 發(fā)現(xiàn) GATT 服務(wù). // ACTION_DATA_AVAILABLE: 從 BLE 設(shè)備中接收數(shù)據(jù), 數(shù)據(jù)可以是 read 或者 notification 操作的結(jié)果. private final BroadcastReceiver mGattUpdateReceiver = new BroadcastReceiver() {@Overridepublic void onReceive(Context context, Intent intent) {final String action = intent.getAction();if (BluetoothLeService.ACTION_GATT_CONNECTED.equals(action)) {mConnected = true;updateConnectionState(R.string.connected);invalidateOptionsMenu();} else if (BluetoothLeService.ACTION_GATT_DISCONNECTED.equals(action)) {mConnected = false;updateConnectionState(R.string.disconnected);invalidateOptionsMenu();clearUI();} else if (BluetoothLeService.ACTION_GATT_SERVICES_DISCOVERED.equals(action)) {// 在用戶界面 顯示所有支持的服務(wù) 和 特性. displayGattServices(mBluetoothLeService.getSupportedGattServices());} else if (BluetoothLeService.ACTION_DATA_AVAILABLE.equals(action)) {displayData(intent.getStringExtra(BluetoothLeService.EXTRA_DATA));}} };

8. 讀取 BLE 屬性

讀寫屬性簡介 :?

-- 讀寫屬性前提 : Android 應(yīng)用連接到了 設(shè)備中的?GATT 服務(wù), 并且發(fā)現(xiàn)了 各種服務(wù) (特性集合), 可以讀寫其中的屬性.?

-- 讀寫屬性代碼示例?: 遍歷服務(wù) (特性集合) 和 特性, 將其展示在 UI 界面中.

public class DeviceControlActivity extends Activity {...// 示范如何通過其所支持的 GATT 遍歷 服務(wù) (Services) 和 特性 (Characteristics)// 在這個(gè)示例中, 我們將查詢出的數(shù)據(jù)填充到 UI 界面中的 ExpandableListView 中private void displayGattServices(List<BluetoothGattService> gattServices) {if (gattServices == null) return;String uuid = null;String unknownServiceString = getResources().getString(R.string.unknown_service);String unknownCharaString = getResources().getString(R.string.unknown_characteristic);ArrayList<HashMap<String, String>> gattServiceData =new ArrayList<HashMap<String, String>>();ArrayList<ArrayList<HashMap<String, String>>> gattCharacteristicData= new ArrayList<ArrayList<HashMap<String, String>>>();mGattCharacteristics =new ArrayList<ArrayList<BluetoothGattCharacteristic>>();// 遍歷 GATT 服務(wù)for (BluetoothGattService gattService : gattServices) {HashMap<String, String> currentServiceData =new HashMap<String, String>();uuid = gattService.getUuid().toString();currentServiceData.put(LIST_NAME, SampleGattAttributes.lookup(uuid, unknownServiceString));currentServiceData.put(LIST_UUID, uuid);gattServiceData.add(currentServiceData);ArrayList<HashMap<String, String>> gattCharacteristicGroupData =new ArrayList<HashMap<String, String>>();// 獲取服務(wù)中的特性集合List<BluetoothGattCharacteristic> gattCharacteristics =gattService.getCharacteristics();ArrayList<BluetoothGattCharacteristic> charas =new ArrayList<BluetoothGattCharacteristic>();// 循環(huán)遍歷特性集合for (BluetoothGattCharacteristic gattCharacteristic :gattCharacteristics) {charas.add(gattCharacteristic);HashMap<String, String> currentCharaData =new HashMap<String, String>();uuid = gattCharacteristic.getUuid().toString();currentCharaData.put(LIST_NAME, SampleGattAttributes.lookup(uuid,unknownCharaString));currentCharaData.put(LIST_UUID, uuid);gattCharacteristicGroupData.add(currentCharaData);}mGattCharacteristics.add(charas);gattCharacteristicData.add(gattCharacteristicGroupData);}...} ... }

9. 接收 GATT 通知

GATT 通知簡介 :?

-- 特性改變通知 : 當(dāng) BLE 設(shè)備中的一些特殊的特性改變, 需要通知與之連接的 Android BLE 應(yīng)用.

-- 代碼示例 : 使用?setCharacteristicNotification() 方法為特性設(shè)置通知.

private BluetoothGatt mBluetoothGatt; BluetoothGattCharacteristic characteristic; boolean enabled; ... // 設(shè)置是否監(jiān)聽某個(gè)特性改變 mBluetoothGatt.setCharacteristicNotification(characteristic, enabled); ... BluetoothGattDescriptor descriptor = characteristic.getDescriptor(UUID.fromString(SampleGattAttributes.CLIENT_CHARACTERISTIC_CONFIG)); descriptor.setValue(BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE); mBluetoothGatt.writeDescriptor(descriptor);
-- 特性改變回調(diào)?: 一但特性開啟了改變通知監(jiān)聽, 如果特性發(fā)生了改變, 就會(huì)回調(diào) BluetoothGattCallback 接口中的?onCharacteristicChanged() 方法.

@Override // 特性通知 public void onCharacteristicChanged(BluetoothGatt gatt,BluetoothGattCharacteristic characteristic) {broadcastUpdate(ACTION_DATA_AVAILABLE, characteristic); }

10. 關(guān)閉 APP 中的 BLE 連接

關(guān)閉 BLE 設(shè)備連接 :?

-- 關(guān)閉方法 : 一旦結(jié)束了 BLE 設(shè)備的使用, 調(diào)用 BluetoothGatt 的 close() 方法, 關(guān)閉 BLE 連接, 釋放相關(guān)的資源.

-- 關(guān)閉示例 :?

public void close() {if (mBluetoothGatt == null) {return;}mBluetoothGatt.close();mBluetoothGatt = null; }

轉(zhuǎn)載請(qǐng)注明出處?:?http://blog.csdn.net/shulianghan/article/details/50515359

《新程序員》：云原生和全面數(shù)字化實(shí)踐50位技術(shù)專家共同創(chuàng)作，文字、視頻、音頻交互閱讀

總結(jié)

以上是生活随笔為你收集整理的【Android应用开发】Android 蓝牙低功耗 (BLE) ( 第一篇 . 概述 . 蓝牙低功耗文档 翻译)的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。