openBluetoothAdapter初始化藍(lán)牙適配器的方法

這篇文章主要介紹“openBluetoothAdapter初始化藍(lán)牙適配器的方法”，在日常操作中，相信很多人在openBluetoothAdapter初始化藍(lán)牙適配器的方法問(wèn)題上存在疑惑，小編查閱了各式資料，整理出簡(jiǎn)單好用的操作方法，希望對(duì)大家解答”openBluetoothAdapter初始化藍(lán)牙適配器的方法”的疑惑有所幫助！接下來(lái)，請(qǐng)跟著小編一起來(lái)學(xué)習(xí)吧！

藍(lán)牙適配器接口

基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理

iOS 微信客戶(hù)端 6.5.6 版本開(kāi)始支持，Android 客戶(hù)端暫不支持

wx.openBluetoothAdapter(OBJECT)

基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理

初始化藍(lán)牙適配器

OBJECT參數(shù)說(shuō)明：

示例代碼：

wx.openBluetoothAdapter({
  success: function (res) {console.log(res)
  }
})

Bug & Tip

1. tip: 由于系統(tǒng)的問(wèn)題，目前僅在 mac 版的開(kāi)發(fā)工具上支持藍(lán)牙調(diào)試

2. tip: 基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理

wx.closeBluetoothAdapter(OBJECT)

基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理

關(guān)閉藍(lán)牙模塊。調(diào)用該方法將斷開(kāi)所有已建立的鏈接并釋放系統(tǒng)資源

OBJECT參數(shù)說(shuō)明：

示例代碼：

wx.closeBluetoothAdapter({
  success: function (res) {console.log(res)
  }
})

wx.getBluetoothAdapterState(OBJECT)

基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理

獲取本機(jī)藍(lán)牙適配器狀態(tài)

OBJECT參數(shù)說(shuō)明：

success返回參數(shù)：

示例代碼：

wx.getBluetoothAdapterState({
  success: function (res) {console.log(res)
  }
})

wx.onBluetoothAdapterStateChange(CALLBACK)

基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理

監(jiān)聽(tīng)藍(lán)牙適配器狀態(tài)變化事件

CALLBACK參數(shù)說(shuō)明：

示例代碼：

wx.onBluetoothAdapterStateChange(function(res) {  console.log(`adapterState changed, now is`, res)
})

wx.startBluetoothDevicesDiscovery(OBJECT)

基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理

開(kāi)始搜尋附近的藍(lán)牙外圍設(shè)備。注意，該操作比較耗費(fèi)系統(tǒng)資源，請(qǐng)?jiān)谒阉鞑⑦B接到設(shè)備后調(diào)用 stop 方法停止搜索。

OBJECT參數(shù)說(shuō)明：

services參數(shù)說(shuō)明：某些藍(lán)牙設(shè)備會(huì)廣播自己的主 service 的 uuid。如果這里傳入該數(shù)組，那么根據(jù)該 uuid 列表，只搜索有這個(gè)主服務(wù)的設(shè)備。

success返回參數(shù)：

示例代碼：

// 以微信硬件平臺(tái)的藍(lán)牙智能燈為例，主服務(wù)的 UUID 是 FEE7。傳入這個(gè)參數(shù)，只搜索主服務(wù) UUID 為 FEE7 的設(shè)備wx.startBluetoothDevicesDiscovery({
  services: ['FEE7'],
  success: function (res) {console.log(res)
  }
})

wx.stopBluetoothDevicesDiscovery(OBJECT)

基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理

停止搜尋附近的藍(lán)牙外圍設(shè)備。請(qǐng)?jiān)诖_保找到需要連接的設(shè)備后調(diào)用該方法停止搜索。

OBJECT參數(shù)說(shuō)明：

success返回參數(shù)：

adapterState

藍(lán)牙適配器狀態(tài)信息

示例代碼：

wx.stopBluetoothDevicesDiscovery({
  success: function (res) {console.log(res)
  }
})

wx.getBluetoothDevices(OBJECT)

基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理

獲取所有已發(fā)現(xiàn)的藍(lán)牙設(shè)備，包括已經(jīng)和本機(jī)處于連接狀態(tài)的設(shè)備

OBJECT參數(shù)說(shuō)明：

success返回參數(shù)：

device 對(duì)象

藍(lán)牙設(shè)備信息

示例代碼：

wx.getBluetoothDevices({
  success: function (res) {console.log(res)
  }
})

Bug & Tip

1. tip: Mac系統(tǒng)可能無(wú)法獲取advertisData及RSSI，請(qǐng)使用真機(jī)調(diào)試

2. tip: 開(kāi)發(fā)者工具和 Android 上獲取到的deviceId為設(shè)備 MAC 地址，iOS 上則為設(shè)備 uuid。因此deviceId不能硬編碼到代碼中

wx.getConnectedBluetoothDevices(OBJECT)

基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理

根據(jù) uuid 獲取處于已連接狀態(tài)的設(shè)備

OBJECT參數(shù)說(shuō)明：

success返回參數(shù)：

device對(duì)象

藍(lán)牙設(shè)備信息

示例代碼：

wx.getConnectedBluetoothDevices({
  success: function (res) {console.log(res)
  }
})

Bug & Tip

1. tip: 開(kāi)發(fā)者工具和 Android 上獲取到的deviceId為設(shè)備 MAC 地址，iOS 上則為設(shè)備 uuid。因此deviceId不能硬編碼到代碼中

wx.onBluetoothDeviceFound(CALLBACK)

基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理

監(jiān)聽(tīng)尋找到新設(shè)備的事件

CALLBACK參數(shù)說(shuō)明：

device對(duì)象

示例代碼：

wx.onBluetoothDeviceFound(function(devices) {  console.log('new device list has founded')  console.dir(devices)
})

Bug & Tip

1. tip: Mac系統(tǒng)可能無(wú)法獲取advertisData及RSSI，請(qǐng)使用真機(jī)調(diào)試

2. tip: 開(kāi)發(fā)者工具和 Android 上獲取到的deviceId為設(shè)備 MAC 地址，iOS 上則為設(shè)備 uuid。因此deviceId不能硬編碼到代碼中

低功耗藍(lán)牙接口

wx.createBLEConnection(OBJECT)

基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理

連接低功耗藍(lán)牙設(shè)備

OBJECT參數(shù)說(shuō)明：

success返回參數(shù)：

示例代碼：

wx.createBLEConnection({  // 這里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中獲取
  deviceId: deviceId,
  success: function (res) {console.log(res)
  }
})

wx.closeBLEConnection(OBJECT)

基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理

斷開(kāi)與低功耗藍(lán)牙設(shè)備的連接

OBJECT參數(shù)說(shuō)明：

success返回參數(shù)：

示例代碼：

wx.closeBLEConnection({
  success: function (res) {console.log(res)
  }
})

wx.getBLEDeviceServices(OBJECT)

基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理

獲取藍(lán)牙設(shè)備所有 service（服務(wù)）

OBJECT參數(shù)說(shuō)明：

success返回參數(shù)：

service對(duì)象

藍(lán)牙設(shè)備service(服務(wù))信息

示例代碼：

wx.getBLEDeviceServices({  // 這里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中獲取
  deviceId: deviceId,
  success: function (res) {console.log('device services:', res.services)
  }
})

wx.getBLEDeviceCharacteristics(OBJECT)

基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理

獲取藍(lán)牙設(shè)備所有 characteristic（特征值）

OBJECT參數(shù)說(shuō)明：

success返回參數(shù)：

characteristic對(duì)象

藍(lán)牙設(shè)備characteristic(特征值)信息

properties對(duì)象

示例代碼：

wx.getBLEDeviceCharacteristics({  // 這里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中獲取
  deviceId: deviceId,  // 這里的 serviceId 需要在上面的 getBLEDeviceServices 接口中獲取
  serviceId: serviceId,
  success: function (res) {console.log('device getBLEDeviceCharacteristics:', res.characteristics)
  }
})

wx.readBLECharacteristicValue(OBJECT)

基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理

讀取低功耗藍(lán)牙設(shè)備的特征值的二進(jìn)制數(shù)據(jù)值。注意：必須設(shè)備的特征值支持read才可以成功調(diào)用，具體參照 characteristic 的 properties 屬性

OBJECT參數(shù)說(shuō)明：

success返回參數(shù)：

characteristic對(duì)象

藍(lán)牙設(shè)備characteristic(特征值)信息

示例代碼：

// 必須在這里的回調(diào)才能獲取wx.onBLECharacteristicValueChange(function(characteristic) {  console.log('characteristic value comed:', characteristic)
})

wx.readBLECharacteristicValue({  // 這里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中獲取
  deviceId: deviceId,  // 這里的 serviceId 需要在上面的 getBLEDeviceServices 接口中獲取
  serviceId: serviceId,  // 這里的 characteristicId 需要在上面的 getBLEDeviceCharacteristics 接口中獲取
  characteristicId: characteristicId,
  success: function (res) {console.log('readBLECharacteristicValue:', res.characteristic.value)
  }
})

Bug & Tip

1. tip: 并行調(diào)用多次讀寫(xiě)接口存在讀寫(xiě)失敗的可能性。

2. tip:read接口讀取到的信息需要在onBLECharacteristicValueChange方法注冊(cè)的回調(diào)中獲取。

wx.writeBLECharacteristicValue(OBJECT)

基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理

向低功耗藍(lán)牙設(shè)備特征值中寫(xiě)入二進(jìn)制數(shù)據(jù)。注意：必須設(shè)備的特征值支持write才可以成功調(diào)用，具體參照 characteristic 的 properties 屬性

tips: 并行調(diào)用多次讀寫(xiě)接口存在讀寫(xiě)失敗的可能性

OBJECT參數(shù)說(shuō)明：

success返回參數(shù)：

示例代碼：

// 這里的回調(diào)可以獲取到 write 導(dǎo)致的特征值改變wx.onBLECharacteristicValueChange(function(characteristic) {  console.log('characteristic value changed:', characteristic)
})// 向藍(lán)牙設(shè)備發(fā)送一個(gè)0x00的16進(jìn)制數(shù)據(jù)let buffer = new ArrayBuffer(1)let dataView = new DataView(buffer)
dataView.setUint8(0, 0)

wx.writeBLECharacteristicValue({  // 這里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中獲取
  deviceId: deviceId,  // 這里的 serviceId 需要在上面的 getBLEDeviceServices 接口中獲取
  serviceId: serviceId,  // 這里的 characteristicId 需要在上面的 getBLEDeviceCharacteristics 接口中獲取
  characteristicId: characteristicId,  // 這里的value是ArrayBuffer類(lèi)型
  value: buffer,
  success: function (res) {console.log('writeBLECharacteristicValue success', res.errMsg)
  }
})

wx.notifyBLECharacteristicValueChanged(OBJECT)

基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理

啟用低功耗藍(lán)牙設(shè)備特征值變化時(shí)的 notify 功能。注意：必須設(shè)備的特征值支持notify才可以成功調(diào)用，具體參照 characteristic 的 properties 屬性

另外，必須先啟用notify才能監(jiān)聽(tīng)到設(shè)備 characteristicValueChange 事件

OBJECT參數(shù)說(shuō)明：

success返回參數(shù)：

示例代碼：

wx.notifyBLECharacteristicValueChanged({
  state: true, // 啟用 notify 功能
  // 這里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中獲取
  deviceId: deviceId,  // 這里的 serviceId 需要在上面的 getBLEDeviceServices 接口中獲取
  serviceId: serviceId,  // 這里的 characteristicId 需要在上面的 getBLEDeviceCharacteristics 接口中獲取
  characteristicId: characteristicId,
  success: function (res) {console.log('notifyBLECharacteristicValueChanged success', res.errMsg)
  }
})

wx.onBLEConnectionStateChanged(CALLBACK)

基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理

監(jiān)聽(tīng)低功耗藍(lán)牙連接的錯(cuò)誤事件，包括設(shè)備丟失，連接異常斷開(kāi)等等。

CALLBACK參數(shù)說(shuō)明：

示例代碼：

wx.onBLEConnectionStateChanged(function(res) {  // 該方法回調(diào)中可以用于處理連接意外斷開(kāi)等異常情況
  console.log(`device ${res.deviceId} state has changed, connected: ${res.connected}`)
})

wx.onBLECharacteristicValueChange(CALLBACK)

基礎(chǔ)庫(kù)版本 1.1.0 開(kāi)始支持，低版本需做兼容處理

監(jiān)聽(tīng)低功耗藍(lán)牙設(shè)備的特征值變化。必須先啟用notify接口才能接收到設(shè)備推送的notification。

CALLBACK參數(shù)說(shuō)明：

示例代碼：

wx.onBLECharacteristicValueChange(function(res) {  console.log(`characteristic ${res.characteristicId} has changed, now is ${res.value}`)
})

到此，關(guān)于“openBluetoothAdapter初始化藍(lán)牙適配器的方法”的學(xué)習(xí)就結(jié)束了，希望能夠解決大家的疑惑。理論與實(shí)踐的搭配能更好的幫助大家學(xué)習(xí)，快去試試吧！若想繼續(xù)學(xué)習(xí)更多相關(guān)知識(shí)，請(qǐng)繼續(xù)關(guān)注億速云網(wǎng)站，小編會(huì)繼續(xù)努力為大家?guī)?lái)更多實(shí)用的文章！