物聯(lián)網(wǎng)平臺(tái)的設(shè)備標(biāo)簽是給設(shè)備添加自定義的標(biāo)識(shí)。您可以使用標(biāo)簽功能來(lái)靈活管理產(chǎn)品、設(shè)備和分組。
功能介紹
設(shè)備標(biāo)簽的結(jié)構(gòu)為鍵值對(duì), Key:Value
。
您可以根據(jù)設(shè)備的特性為設(shè)備添加特有的標(biāo)簽,方便對(duì)設(shè)備進(jìn)行管理。例如,為房間 201 的智能電表定義一個(gè)標(biāo)簽為room:201
。
SDK使用
更新標(biāo)簽
API原型 | device#postTags(params, [callback]) |
---|---|
函數(shù)描述 | 上報(bào)或更新設(shè)備標(biāo)簽 |
參數(shù)描述 |
- params 屬性對(duì)象數(shù)組,array 類(lèi)型,內(nèi)容格式示例 [ {attrKey:’xxx’,attrValue:’xxx’},{}…] - callback - res 服務(wù)端 reply 消息內(nèi)容 |
下面的示例代碼向云端添加一個(gè)名為“Temperature”的標(biāo)簽,其值為“36.8”:
const tags = [
{
"attrKey": "Temperature",
"attrValue": "36.8"
}
]
device.postTags(
tags,
(res) => {
console.log(`add tag ok res:${res.id}`);
done()
}
);
注:設(shè)備可以向云端添加多個(gè)標(biāo)簽
刪除標(biāo)簽
API原型 | device#deleteTags(tags) |
---|---|
函數(shù)描述 | 刪除設(shè)備標(biāo)簽 |
參數(shù)描述 | - tags 屬性參數(shù),array 類(lèi)型,內(nèi)容格式 [ 'string','string',....],string 內(nèi)外為tag的標(biāo)簽名稱
|
代碼示例:
device.deleteTags(['tagA','tagB']);
上面的示例代碼刪除名為“tagA”和“tagB”的兩個(gè)標(biāo)簽。
開(kāi)發(fā)者也可訪問(wèn)完整代碼示例了解相關(guān)用法。