快捷導(dǎo)航

Android藍牙庫FastBle的基礎(chǔ)入門使用

更新時間：2018年07月05日 17:05:51 作者：kindem

這篇文章主要給大家介紹了關(guān)于Android藍牙庫FastBle的基礎(chǔ)入門使用的相關(guān)資料，文中通過示例代碼介紹的非常詳細，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

前言

最近在做物聯(lián)網(wǎng)課設(shè)，過程中需要用到Android的藍牙API，奈何原生的藍牙API使用有點麻煩。于是上網(wǎng)搜索看有沒有好用的Android藍牙庫，然后發(fā)現(xiàn)了這個寶貝，給大家分享一下。

FastBle VS 原生Android藍牙API

原生Android的藍牙API使用有點麻煩，要先獲取設(shè)備的藍牙適配器，接著注冊廣播來接受藍牙設(shè)備信息，用完了還需要將廣播給注銷，相對來說有點麻煩。

不好封裝，可以說是原生Android最讓人痛苦的地方，這是因為原生Android的代碼不是很獨立，與Activity、廣播等相雜糅。市面上的藍牙庫也是少之又少，先看了看BleLib，感覺還是換湯不換藥，用起來一點也不簡潔。

但是FastLib封裝的就很技巧，基本上能把一個操作的粒度控制在一行內(nèi)，另外，代碼也無需與線程、通知之類的打交道，庫中已經(jīng)幫我們把這些復(fù)雜的東西都做完了。

FastBle的Github項目地址在這，大家可以看看：[FastBle - GitHub](https://github.com/Jasonchenlijian/FastBle （本地下載）

它的文檔也相對比較完整，大家可以查看官方文檔來使用它：FastBle - Document

FastBle的使用

0x00 申明權(quán)限

只要使用到了藍牙，申明權(quán)限是必不可少的，F(xiàn)astBle需要的權(quán)限如下:

<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

這里要注意一點，如果Android版本高于6.0，用戶還需要打開位置信息(不光要位置權(quán)限，還需要打開位置信息)才能通過藍牙進行掃描。

0x01 初始化與全局配置

初始化需要在庫中任何函數(shù)被調(diào)用前執(zhí)行，由于庫使用的是單例模式，只需要初始化一次，在哪里都能使用，建議在onCreate里執(zhí)行初始化代碼：

BleManager.getInstance().init(getApplication());

全局配置可以緊跟初始化之后執(zhí)行，當然如果不進行配置也沒有任何關(guān)系，每一個選項都有默認值：

BleManager.getInstance()
 .enableLog(true)
 .setReConnectCount(1, 5000)
 .setSplitWriteNum(20)
 .setConnectOverTime(10000)
 .setOperateTimeout(5000);

每一項的詳細信息你都能在官方文檔中找到說明

0x02 打開藍牙

使用FastBle中的BleManager類有很多種方式來打開藍牙，這里推薦使用下面這種方式，這種方式會使線程被阻塞，如果用戶不選擇是否打開藍牙，線程將會暫停執(zhí)行：

BleManager.getInstance().enableBluetooth();

0x03 掃描設(shè)備

打開藍牙之后即可掃描設(shè)備，在正式掃描之前，可以自定義掃描規(guī)則，像這樣：

BleScanRuleConfig scanRuleConfig = new BleScanRuleConfig.Builder()
 .setServiceUuids(serviceUuids) // 只掃描指定的服務(wù)的設(shè)備，可選
 .setDeviceName(true, names)  // 只掃描指定廣播名的設(shè)備，可選
 .setDeviceMac(mac)   // 只掃描指定mac的設(shè)備，可選
 .setAutoConnect(isAutoConnect) // 連接時的autoConnect參數(shù)，可選，默認false
 .setScanTimeOut(10000)  // 掃描超時時間，可選，默認10秒；小于等于0表示不限制掃描時間
 .build();

BleManager.getInstance().initScanRule(scanRuleConfig);

在設(shè)置規(guī)則后，即可開始掃描，像這樣

BleManager.getInstance().scan(new BleScanCallBack() {
 @Override
 public void onScanStarted(boolean success) {
 // 開始掃描的回調(diào)
 }

 @Override
 public void onScanning(BleDevice bleDevice) {
 // 掃描到一個之前沒有掃到過的設(shè)備的回調(diào)
 }

 @Override
 public void onScanFinished(List<BleDevice> scanResultList) {
 // 掃描完成的回調(diào)，列表里將不會有重復(fù)的設(shè)備
 }
});

這幾個回調(diào)都是安全的，將會自動返回主線程，所以可以放心使用。

當然，在任何地方，任何時候，你都可以直接使用取消掃描這個函數(shù)來停止掃描:

BleManager.getInstance().cancelScan();

0x04 連接設(shè)備

在掃描之后，你已經(jīng)獲取到了一個或多個BleDevice對象，你可以直接使用這些對象向目標設(shè)備發(fā)起連接，像這樣：

BleManager.getInstance().connect(bleDevice, new BleGattCallback() {
 @Override
 public void onStartConnect() {
 // 開始連接
 }

 @Override
 public void onConnectFail(BleDevice bleDevice, BleException exception) {
  // 連接失敗
 }

 @Override
 public void onConnectSuccess(BleDevice bleDevice, BluetoothGatt gatt, int status) {
  // 連接成功，BleDevice即為所連接的BLE設(shè)備
 }

 @Override
 public void onDisConnected(boolean isActiveDisConnected, BleDevice bleDevice, BluetoothGatt gatt, int status) {
  // 連接中斷，isActiveDisConnected表示是否是主動調(diào)用了斷開連接方法
 }
});

當然，在官方文檔中還有很多詳細的說明，這里只是簡單介紹了一下FastBle的基本使用，了解詳情還請看官方文檔。

總結(jié)

以上就是這篇文章的全部內(nèi)容了，希望本文的內(nèi)容對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，如果有疑問大家可以留言交流，謝謝大家對腳本之家的支持。

您可能感興趣的文章: