writeValueForCharacteristic

根據(jù)指定的外圍設(shè)備 UUID 及其服務(wù) UUID 和特征 UUID 寫數(shù)據(jù)

writeValueForCharacteristic({params}, callback(ret, err))

params

peripheralUUID：

• 類型：字符串
• 描述：指定的藍(lán)牙外圍設(shè)備的 UUID

serviceUUID

• 類型：字符串
• 描述：指定的服務(wù)的 UUID

characteristicUUID

• 類型：字符串
• 描述：指定的特征的 UUID

value

• 類型：字符串
• 描述：要寫入的數(shù)據(jù) ，十六進(jìn)制的字符串

writeType

• 類型：字符串
• 描述：（可選項）寫入數(shù)據(jù)時的類型
• 默認(rèn)：auto
• 取值范圍：
  • auto：模塊自動選擇類型
  • response：有回調(diào)
  • withoutResponse：無回調(diào)
  • signed: 簽名 (signed只支持Android)

callback(ret, err)

ret:

• 類型：JSON 對象
• 描述：每有數(shù)據(jù)接收便會觸發(fā)此回調(diào)
• 內(nèi)部字段：

{
     status: true ,      //布爾類型；是否發(fā)送成功，true|false
     characteristic:{    //JSON對象；獲取監(jiān)聽的特征的信息
        uuid: '',        //字符串類型；特征的 UUID 
        serviceUUID: '', //字符串類型；服務(wù)的 UUID 
        permissions: '', //字符串類型；特征的權(quán)限，取值范圍如下：
                         //readable：
                         //writeable：
                         //readEncryptionRequired：
                         //writeEncryptionRequired：
        propertie: ''    //字符串類型；特征的屬性，取值范圍如下：
                         //broadcast：
                         //read：
                         //writeWithoutResponse：
                         //write：
                         //notify：
                         //indicate：
                         //authenticatedSignedWrites：
                         //extendedProperties：
                         //notifyEncryptionRequired：
                         //indicateEncryptionRequired：
     }      
}

err:

• 類型：JSON 對象
• 內(nèi)部字段：

{
     code: 1          //數(shù)字類型；失敗時返回錯誤碼，取值范圍如下：
                      //-1：未知錯誤
                      //1：peripheralUUID 為空
                      //2：serviceUUID 為空
                      //3：characteristicUUID 為空
                      //4：value 為空
                      //5：未找到指定特征（characteristic）
                      //6：未找到指定服務(wù)（service）
                      //7：尚未搜索到該藍(lán)牙設(shè)備
}

示例代碼

var ble = api.require('ble');
ble.writeValueForCharacteristic({
    peripheralUUID: '',
    serviceUUID: '',
    characteristicUUID: '',
    value: ''
}, function(ret) {
    if (ret) {
        api.alert({ msg: JSON.stringify(ret) });
    }
});

可用性

iOS系統(tǒng)，Android系統(tǒng)

可提供的1.0.0及更高版本