智慧型住宅共乘特徵結構定義
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" }
裝置指令
無。