my.readBLECharacteristicValue

2020-09-15 15:20 更新

版本需求:支付寶客戶端 10.0.18 或更高版本,若版本較低,建議做 兼容處理。支持 iOS 客戶端,Android 5.0 及以上版本客戶端。

注意: IDE 模擬器暫不支持調(diào)試,請(qǐng)以真機(jī)調(diào)試結(jié)果為準(zhǔn)。

讀取低功耗藍(lán)牙設(shè)備特征值中的數(shù)據(jù)。調(diào)用后在 my.onBLECharacteristicValueChange 事件中接收數(shù)據(jù)返回。

使用說(shuō)明:

  • 設(shè)備的特征值必須支持 read 才可以成功調(diào)用,具體請(qǐng)參見(jiàn) characteristic 的 properties 屬性。
  • 并行多次調(diào)用讀寫(xiě)接口存在讀寫(xiě)失敗的可能性。
  • 如果讀取超時(shí),錯(cuò)誤碼為 10015,錯(cuò)誤碼信息及解決方案請(qǐng)參見(jiàn) 藍(lán)牙 API 錯(cuò)誤碼對(duì)照表my.onBLECharacteristicValueChange 接口之后可能返回?cái)?shù)據(jù),需要接入方酌情處理。

掃碼體驗(yàn)

藍(lán)牙.jpeg

效果示例

藍(lán)牙寫(xiě)入數(shù)據(jù).png

示例代碼

my.readBLECharacteristicValue({
  deviceId: deviceId,
  serviceId: serviceId,
  characteristicId: characteristicId,
  success: (res) => {
    console.log(res)
  },
  fail:(res) => {
  },
  complete: (res)=>{
  }
});

入?yún)?/h2>

Object 類(lèi)型,屬性如下:

屬性 類(lèi)型 必填 描述
deviceId String 藍(lán)牙設(shè)備 ID,參考 device 對(duì)象。
serviceId String 藍(lán)牙特征值對(duì)應(yīng) service 的 UUID。
characteristicId String 藍(lán)牙特征值的 UUID。
success Function 調(diào)用成功的回調(diào)函數(shù)。
fail Function 調(diào)用失敗的回調(diào)函數(shù)。
complete Function 調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行)。

success 回調(diào)函數(shù)

入?yún)?Object 類(lèi)型,屬性如下:

屬性 類(lèi)型 描述
characteristic Object 設(shè)備特征值信息

characteristic 對(duì)象

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

名稱(chēng) 類(lèi)型 描述
characteristicId String 藍(lán)牙設(shè)備特征值的 UUID。
serviceId String 藍(lán)牙設(shè)備特征值對(duì)應(yīng)服務(wù)的 UUID。
value Hex String 藍(lán)牙設(shè)備特征值的 value。
以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)