Smart Home SensorState 特性結構定義
action.devices.traits.SensorState
- 此屬性涵蓋量化測量和定性狀態。
裝置屬性
具有此特性的裝置可能會在 SYNC
作業中回報下列屬性。如要進一步瞭解如何處理 SYNC
意圖,請參閱意圖執行要求一文。
屬性 | 類型 | 說明 |
---|---|---|
sensorStatesSupported |
陣列 |
必填。 每個物件都代表這個裝置支援的感應器狀態功能。每個感應器都必須具有描述性或數值能力。感應器也可以回報這兩種情況,此時系統會優先採用數值。 |
[item, ...] |
物件 |
支援的感應器功能。 至少要有 1 個項目。 |
name |
字串 |
必填。 支援的感應器類型。請參閱「支援的感應器」表格。 |
descriptiveCapabilities |
物件 |
感應器功能的說明。 |
availableStates |
陣列 |
必填。 裝置的可用狀態清單。當感應器未傳回值時,默示支援「未知」狀態。 |
[item, ...] |
字串 |
支援描述性狀態值。 至少要有 1 個項目。 |
numericCapabilities |
物件 |
說明感應器可回報的數值。 |
rawValueUnit |
字串 |
必填。 支援的數值單位。 |
請參閱支援的感應器,進一步瞭解這些特性支援的不同功能和感應器類型。
範例
回報描述性狀態值的感應器裝置。
{ "sensorStatesSupported": [ { "name": "AirQuality", "descriptiveCapabilities": { "availableStates": [ "healthy", "moderate", "unhealthy", "very unhealthy" ] } } ] }
回報數字狀態值的感應器裝置。
{ "sensorStatesSupported": [ { "name": "CarbonMonoxideLevel", "numericCapabilities": { "rawValueUnit": "PARTS_PER_MILLION" } } ] }
可回報描述性和數值狀態的感應器裝置。
{ "sensorStatesSupported": [ { "name": "SmokeLevel", "numericCapabilities": { "rawValueUnit": "PARTS_PER_MILLION" }, "descriptiveCapabilities": { "availableStates": [ "smoke detected", "high", "no smoke detected" ] } } ] }
支援的感應器
下表列出支援的感應器類型及其相關功能。
空氣品質
名稱 | 口述能力 | 數字功能 |
---|---|---|
支援的值:
|
支援的值:
|
支援的值:
|
一氧化碳
名稱 | 口述能力 | 數字功能 |
---|---|---|
支援的值:
|
支援的值:
|
支援的值:
|
煙霾濃度
名稱 | 口述能力 | 數字功能 |
---|---|---|
支援的值:
|
支援的值:
|
支援的值:
|
過濾器乾淨
名稱 | 口述能力 | 數字功能 |
---|---|---|
支援的值:
|
支援的值:
|
不支援。 |
漏水
名稱 | 口述能力 | 數字功能 |
---|---|---|
支援的值:
|
支援的值:
|
不支援。 |
雨水偵測
名稱 | 口述能力 | 數字功能 |
---|---|---|
支援的值:
|
支援的值:
|
不支援。 |
篩選效期
名稱 | 口述能力 | 數字功能 |
---|---|---|
支援的值:
|
支援的值:
|
支援的值:
|
運算篩選器生命週期
名稱 | 口述能力 | 數字功能 |
---|---|---|
支援的值:
|
不支援。 | 支援的值:
|
二氧化碳濃度
名稱 | 口述能力 | 數字功能 |
---|---|---|
支援的值:
|
不支援。 | 支援的值:
|
參賽案件
名稱 | 口述能力 | 數字功能 |
---|---|---|
支援的值:
|
不支援。 | 支援的值:
|
揮發性有機化合物
名稱 | 口述能力 | 數字功能 |
---|---|---|
支援的值:
|
不支援。 | 支援的值:
|
裝置狀態:STATE
具有此特性的實體可能會在 QUERY
作業中回報下列狀態。如要進一步瞭解如何處理 QUERY
意圖,請參閱意圖執行要求一文。
州 | 類型 | 說明 |
---|---|---|
currentSensorStateData |
陣列 |
必填。 目前的感應器狀態清單。 |
[item, ...] |
物件 |
目前的感應器狀態。 |
name |
字串 |
必填。 感應器狀態名稱。比對 |
currentSensorState |
字串 |
目前的描述性狀態值。比對 |
rawValue |
Number |
目前的數值感應器值。 |
請參閱支援的感應器,進一步瞭解這些特性支援的不同功能和感應器類型。
範例
回報描述性狀態值的感應器裝置。
{ "currentSensorStateData": [ { "name": "AirQuality", "currentSensorState": "healthy" } ] }
回報數字狀態值的感應器裝置。
{ "currentSensorStateData": [ { "name": "CarbonMonoxideLevel", "rawValue": 200 } ] }
可回報描述性和數值狀態的感應器裝置。
{ "currentSensorStateData": [ { "name": "SmokeLevel", "currentSensorState": "smoke detected", "rawValue": 200 } ] }
裝置指令
無。
裝置通知
具有此特性的裝置可能會隨著裝置狀態變更,傳回下列通知酬載。如要進一步瞭解如何實作通知,請參閱智慧型住宅動作通知。
欄位 | 類型 | 說明 |
---|---|---|
SensorState |
物件 |
必填。 通知酬載。 |
priority |
整數 |
必填。 代表通知層級。目前支援的值為 0,表示系統應可大聲朗讀通知。 |
name |
字串 |
必填。 感應器狀態名稱。查看通知支援的感應器類型清單。 |
currentSensorState |
字串 |
必填。 目前的描述性狀態值。查看通知支援的感應器類型清單。 |
通知酬載可能包含下列感應器類型:
AirQuality
CarbonMonoxideLevel
SmokeLevel
FilterCleanliness
WaterLeak
RainDetection
FilterLifeTime
如要進一步瞭解各感應器類型支援的不同功能,請參閱支援的感應器。
範例
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }