FastBle:
BLE藍(lán)牙開發(fā)框架
https://github.com/Jasonchenlijian/FastBle
藍(lán)牙的種類
藍(lán)牙分經(jīng)典藍(lán)牙和低功耗藍(lán)牙,這里介紹的是低功耗藍(lán)牙也就是BLE藍(lán)牙開發(fā)。
初始化
Application.class
BleManager.getInstance().init(getApplication());
BleManager.getInstance()
.enableLog(true)
.setReConnectCount(1, 5000)//重連次數(shù)以及間隔時(shí)間
.setSplitWriteNum(20)//拆分寫入數(shù)
.setConnectOverTime(10000)//連接超時(shí)時(shí)間
.setOperateTimeout(5000);//操作超時(shí)時(shí)間
搜索
val scanRuleConfig = BleScanRuleConfig.Builder()
// .setDeviceName(true, DEVICE_NAME) // 只掃描指定廣播名的設(shè)備,可選
.setAutoConnect(true) // 連接時(shí)的autoConnect參數(shù),可選,默認(rèn)false
.setScanTimeOut(10000) // 掃描超時(shí)時(shí)間,可選,默認(rèn)10秒
.build()
BleManager.getInstance().initScanRule(scanRuleConfig)
BleManager.getInstance().scan(object : BleScanCallback() {
override fun onScanFinished(scanResultList: MutableList<BleDevice>?) {
//搜索完成,scanResultList搜索到的所有設(shè)備
}
override fun onScanStarted(success: Boolean) {
//開始搜索
}
override fun onScanning(bleDevice: BleDevice?) {
//bleDevice:搜索到的設(shè)備
if (bleDevice?.name == DEVICE_NAME) {
//搜索到對(duì)應(yīng)設(shè)備后停止搜索并連接
stopScan()
BleManager.getInstance().connect(bleDevice, bleGattCallback)
}
}
});
//停止搜索
private fun stopScan() {
if (BleManager.getInstance().scanSate == BleScanState.STATE_SCANNING) {//判斷是否正在搜索
BleManager.getInstance().cancelScan()
}
}
連接
BleManager.getInstance().connect(bleDevice, bleGattCallback)
private val bleGattCallback = object : BleGattCallback() {
override fun onStartConnect() {
//開始連接
}
override fun onDisConnected(isActiveDisConnected: Boolean,device: BleDevice?,gatt: BluetoothGatt?,status: Int) {
//斷開連接
}
override fun onConnectSuccess(bleDevice: BleDevice?, gatt: BluetoothGatt?, status: Int) {
//連接成功
}
override fun onConnectFail(bleDevice: BleDevice?, exception: BleException?) {
//連接失敗
}
}
之前連接過的設(shè)備可以把設(shè)備mac儲(chǔ)存起來,下次直接調(diào)用下面代碼可以直接連接,速度會(huì)比重新搜索連接快很多
val deviceMac = SharedUtil.read(SP_DEVICE_MAC, null)
if (deviceMac != null) {
val device = BleManager.getInstance().bluetoothAdapter.getRemoteDevice(deviceMac)
if (device != null && device.name == DEVICE_NAME) {//判斷是否是正確的設(shè)備
stopScan()
BleManager.getInstance().connect(BleDevice(device), bleGattCallback)
}
}
獲取通知
設(shè)備連接成功后,調(diào)用下面代碼即可創(chuàng)建通知的監(jiān)聽,其中如果獲取到的Byte數(shù)組過大時(shí),返回的數(shù)據(jù)是進(jìn)行分包處理的,需要自行將其連接才是一段完整的數(shù)據(jù)
BleManager.getInstance().notify(BleDevice bleDevice,
String uuid_service,
String uuid_notify,
BleNotifyCallback callback)
這里我的設(shè)備的uuid_service為0000ffe0-0000-1000-8000-00805f9b34fb
uuid_notify為0000ffe1-0000-1000-8000-00805f9b34fb
uuid_write為0000ffe2-0000-1000-8000-00805f9b34fb
但是可能有的設(shè)備不一樣,這時(shí)候可以調(diào)用gatt!!.services獲取到所有服務(wù),查找到你所需要的uuid_service,uuid_notify則可以通過 gatt!!.getService(uuid_service).characteristics里獲取
其中有一個(gè)坑是在FastBle框架中,創(chuàng)建通知監(jiān)聽的時(shí)候會(huì)出現(xiàn)this characteristic not support notify!這個(gè)錯(cuò)誤,這個(gè)是因?yàn)榭蚣軆?nèi)部過早調(diào)用gatt.discoverServices()后導(dǎo)致gatt.getService()時(shí)為空導(dǎo)致的。所以下面中,我會(huì)先進(jìn)行判空,如果為空的話則延遲一秒調(diào)用gatt.discoverServices()。之后內(nèi)部會(huì)再次調(diào)用BleGattCallback中onConnectSuccess回調(diào),在確保service不為空才進(jìn)行調(diào)用BleManager.getInstance().notify()
//在BleGattCallback中onConnectSuccess回調(diào)調(diào)用
if (gatt!!.getService(UUID.fromString("0000ffe0-0000-1000-8000-00805f9b34fb")) == null) {
//判斷service是否為空
Handler(Looper.getMainLooper()).postDelayed({
gatt.discoverServices()
}, 1000)
return
}
//獲取通知
BleManager.getInstance()
.notify(
bleDevice,
"0000ffe0-0000-1000-8000-00805f9b34fb",//uuidService
"0000ffe1-0000-1000-8000-00805f9b34fb",//uuidNotify
object : BleNotifyCallback() {
override fun onCharacteristicChanged(data: ByteArray?) {
//獲取到的數(shù)據(jù)
if (data != null) {
getResult(data)
}
}
override fun onNotifyFailure(exception: BleException?) {
//錯(cuò)誤
}
override fun onNotifySuccess() {
//成功
}
})
其他
表明、寫入、讀取也是類似的調(diào)用,這里就不詳細(xì)寫了
//表明
BleManager.getInstance().indicate(
BleDevice bleDevice,
String uuid_service,
String uuid_indicate,
BleIndicateCallback callback)
//寫入
BleManager.getInstance().write(
BleDevice bleDevice,
String uuid_service,
String uuid_write,
byte[] data,
BleWriteCallback callback)
//讀取
BleManager.getInstance().read(
BleDevice bleDevice,
String uuid_service,
String uuid_read,
BleReadCallback callback)
釋放資源
BleManager.getInstance().destroy()