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