openBluetoothAdapter初始化藍牙適配器的方法

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

藍牙適配器接口

基礎庫版本 1.1.0 開始支持，低版本需做兼容處理

iOS 微信客戶端 6.5.6 版本開始支持，Android 客戶端暫不支持

wx.openBluetoothAdapter(OBJECT)

基礎庫版本 1.1.0 開始支持，低版本需做兼容處理

初始化藍牙適配器

OBJECT參數說明：

示例代碼：

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

Bug & Tip

1. tip: 由于系統的問題，目前僅在 mac 版的開發工具上支持藍牙調試

2. tip: 基礎庫版本 1.1.0 開始支持，低版本需做兼容處理

wx.closeBluetoothAdapter(OBJECT)

基礎庫版本 1.1.0 開始支持，低版本需做兼容處理

關閉藍牙模塊。調用該方法將斷開所有已建立的鏈接并釋放系統資源

OBJECT參數說明：

示例代碼：

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

wx.getBluetoothAdapterState(OBJECT)

基礎庫版本 1.1.0 開始支持，低版本需做兼容處理

獲取本機藍牙適配器狀態

OBJECT參數說明：

success返回參數：

示例代碼：

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

wx.onBluetoothAdapterStateChange(CALLBACK)

基礎庫版本 1.1.0 開始支持，低版本需做兼容處理

監聽藍牙適配器狀態變化事件

CALLBACK參數說明：

示例代碼：

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

wx.startBluetoothDevicesDiscovery(OBJECT)

基礎庫版本 1.1.0 開始支持，低版本需做兼容處理

開始搜尋附近的藍牙外圍設備。注意，該操作比較耗費系統資源，請在搜索并連接到設備后調用 stop 方法停止搜索。

OBJECT參數說明：

services參數說明：某些藍牙設備會廣播自己的主 service 的 uuid。如果這里傳入該數組，那么根據該 uuid 列表，只搜索有這個主服務的設備。

success返回參數：

示例代碼：

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

wx.stopBluetoothDevicesDiscovery(OBJECT)

基礎庫版本 1.1.0 開始支持，低版本需做兼容處理

停止搜尋附近的藍牙外圍設備。請在確保找到需要連接的設備后調用該方法停止搜索。

OBJECT參數說明：

success返回參數：

adapterState

藍牙適配器狀態信息

示例代碼：

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

wx.getBluetoothDevices(OBJECT)

基礎庫版本 1.1.0 開始支持，低版本需做兼容處理

獲取所有已發現的藍牙設備，包括已經和本機處于連接狀態的設備

OBJECT參數說明：

success返回參數：

device 對象

藍牙設備信息

示例代碼：

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

Bug & Tip

1. tip: Mac系統可能無法獲取advertisData及RSSI，請使用真機調試

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

wx.getConnectedBluetoothDevices(OBJECT)

基礎庫版本 1.1.0 開始支持，低版本需做兼容處理

根據 uuid 獲取處于已連接狀態的設備

OBJECT參數說明：

success返回參數：

device對象

藍牙設備信息

示例代碼：

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

Bug & Tip

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

wx.onBluetoothDeviceFound(CALLBACK)

基礎庫版本 1.1.0 開始支持，低版本需做兼容處理

監聽尋找到新設備的事件

CALLBACK參數說明：

device對象

示例代碼：

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

Bug & Tip

1. tip: Mac系統可能無法獲取advertisData及RSSI，請使用真機調試

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

低功耗藍牙接口

wx.createBLEConnection(OBJECT)

基礎庫版本 1.1.0 開始支持，低版本需做兼容處理

連接低功耗藍牙設備

OBJECT參數說明：

success返回參數：

示例代碼：

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

wx.closeBLEConnection(OBJECT)

基礎庫版本 1.1.0 開始支持，低版本需做兼容處理

斷開與低功耗藍牙設備的連接

OBJECT參數說明：

success返回參數：

示例代碼：

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

wx.getBLEDeviceServices(OBJECT)

基礎庫版本 1.1.0 開始支持，低版本需做兼容處理

獲取藍牙設備所有 service（服務）

OBJECT參數說明：

success返回參數：

service對象

藍牙設備service(服務)信息

示例代碼：

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

wx.getBLEDeviceCharacteristics(OBJECT)

基礎庫版本 1.1.0 開始支持，低版本需做兼容處理

獲取藍牙設備所有 characteristic（特征值）

OBJECT參數說明：

success返回參數：

characteristic對象

藍牙設備characteristic(特征值)信息

properties對象

示例代碼：

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

wx.readBLECharacteristicValue(OBJECT)

基礎庫版本 1.1.0 開始支持，低版本需做兼容處理

讀取低功耗藍牙設備的特征值的二進制數據值。注意：必須設備的特征值支持read才可以成功調用，具體參照 characteristic 的 properties 屬性

OBJECT參數說明：

success返回參數：

characteristic對象

藍牙設備characteristic(特征值)信息

示例代碼：

// 必須在這里的回調才能獲取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: 并行調用多次讀寫接口存在讀寫失敗的可能性。

2. tip:read接口讀取到的信息需要在onBLECharacteristicValueChange方法注冊的回調中獲取。

wx.writeBLECharacteristicValue(OBJECT)

基礎庫版本 1.1.0 開始支持，低版本需做兼容處理

向低功耗藍牙設備特征值中寫入二進制數據。注意：必須設備的特征值支持write才可以成功調用，具體參照 characteristic 的 properties 屬性

tips: 并行調用多次讀寫接口存在讀寫失敗的可能性

OBJECT參數說明：

success返回參數：

示例代碼：

// 這里的回調可以獲取到 write 導致的特征值改變wx.onBLECharacteristicValueChange(function(characteristic) {  console.log('characteristic value changed:', characteristic)
})// 向藍牙設備發送一個0x00的16進制數據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類型
  value: buffer,
  success: function (res) {console.log('writeBLECharacteristicValue success', res.errMsg)
  }
})

wx.notifyBLECharacteristicValueChanged(OBJECT)

基礎庫版本 1.1.0 開始支持，低版本需做兼容處理

啟用低功耗藍牙設備特征值變化時的 notify 功能。注意：必須設備的特征值支持notify才可以成功調用，具體參照 characteristic 的 properties 屬性

另外，必須先啟用notify才能監聽到設備 characteristicValueChange 事件

OBJECT參數說明：

success返回參數：

示例代碼：

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)

基礎庫版本 1.1.0 開始支持，低版本需做兼容處理

監聽低功耗藍牙連接的錯誤事件，包括設備丟失，連接異常斷開等等。

CALLBACK參數說明：

示例代碼：

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

wx.onBLECharacteristicValueChange(CALLBACK)

基礎庫版本 1.1.0 開始支持，低版本需做兼容處理

監聽低功耗藍牙設備的特征值變化。必須先啟用notify接口才能接收到設備推送的notification。

CALLBACK參數說明：

示例代碼：

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

到此，關于“openBluetoothAdapter初始化藍牙適配器的方法”的學習就結束了，希望能夠解決大家的疑惑。理論與實踐的搭配能更好的幫助大家學習，快去試試吧！若想繼續學習更多相關知識，請繼續關注億速云網站，小編會繼續努力為大家帶來更多實用的文章！