智慧型住宅可住人數特徵結構定義
action.devices.traits.OccupancySensing
:這項特徵屬於可偵測活動情形的裝置 (透過 PIR、超音波或實體接觸感應)。
裝置特徵
具有此特徵的裝置可能會在執行 SYNC
作業時回報下列屬性。如要進一步瞭解如何處理 SYNC
意圖,請參閱「意圖執行要求」。
屬性 | 類型 | 說明 |
---|---|---|
occupancySensorConfiguration |
陣列 |
物件清單,每個物件含有感應器類型及其相關的延遲和事件門檻。 |
[item, ...] |
物件 |
感應器類型及其相關延遲和事件門檻 (如適用)。 |
occupancySensorType |
String |
必要。 支援的值:
|
occupiedToUnoccupiedDelaySec |
整數 |
代表在上次偵測到事件後,系統回報入座率變更為無人在家狀態前的延遲時間 (以秒為單位)。 |
unoccupiedToOccupiedDelaySec |
整數 |
代表在上次偵測到事件後,系統回報入座率變更為有人住狀態前的延遲時間 (以秒為單位)。如果已設定 |
unoccupiedToOccupiedEventThreshold |
整數 |
指定在系統回報入座狀態變更為入座狀態前,必須在 |
範例
支援 PIR 和超音波感應的入座感應器。
{ "occupancySensorConfiguration": [ { "occupancySensorType": "PIR", "occupiedToUnoccupiedDelaySec": 10, "unoccupiedToOccupiedDelaySec": 10, "unoccupiedToOccupiedEventThreshold": 2 }, { "occupancySensorType": "ULTRASONIC", "occupiedToUnoccupiedDelaySec": 10, "unoccupiedToOccupiedDelaySec": 10, "unoccupiedToOccupiedEventThreshold": 2 } ] }
裝置狀態
具有此特徵的實體可能會在 QUERY
作業中回報下列狀態。如要進一步瞭解如何處理 QUERY
意圖,請參閱「意圖執行要求」。
狀態 | 類型 | 說明 |
---|---|---|
occupancy |
String |
必要。 指出裝置是否可感應活動情形。 支援的值:
|
範例
感應器是否偵測到辦公室的活動情形?
{ "occupancy": "OCCUPIED" }
裝置指令
無。