智慧型住宅有人使用特徵結構定義

action.devices.traits.OccupancySensing - 這項特徵屬於可偵測活動情形的裝置，無論是透過 PIR、超音波感應或身體接觸感應功能偵測都一樣。

裝置屬性

具備這項特徵的裝置可能會回報下列資料： 在 SYNC 作業中使用屬性變更。學習 如要進一步瞭解如何處理 SYNC 意圖，請參閱 意圖執行要求。

屬性	類型	說明
occupancySensorConfiguration	陣列	物件清單，每個物件都會包含感應器類型，以及相關的延遲和事件門檻。
[item, ...]	物件	感應器類型，以及相關的延遲和事件門檻 (如適用)。
occupancySensorType	String	必要。 支援的值： PIR 裝置可透過被動紅外線 (PIR) 感應功能感應活動情形， ULTRASONIC 裝置可透過超音波感應功能感應活動情形。 PHYSICAL_CONTACT 裝置可透過肢體接觸功能偵測訪客身分。
occupiedToUnoccupiedDelaySec	整數	代表系統回報入住人數之前的延遲時間 (以秒為單位)，從上次偵測到事件後變為無人座狀態。
unoccupiedToOccupiedDelaySec	整數	代表系統回報入座率前的延遲時間 (以秒為單位)，從上次偵測到事件後到已有人居住狀態變更為已有人狀態。如果已設定 occupiedToUnoccupiedDelaySec，則為必要欄位。
unoccupiedToOccupiedEventThreshold	整數	指定 unoccupiedToOccupiedDelaySec 年內必須發生的偵測事件數，系統才會在回報的入座率變更為可住人數狀態之前發生。如果已設定 unoccupiedToOccupiedDelaySec，則為必要欄位。

範例

支援 PIR 和超音波感應功能的活動情形感應器。

{
  "occupancySensorConfiguration": [
    {
      "occupancySensorType": "PIR",
      "occupiedToUnoccupiedDelaySec": 10,
      "unoccupiedToOccupiedDelaySec": 10,
      "unoccupiedToOccupiedEventThreshold": 2
    },
    {
      "occupancySensorType": "ULTRASONIC",
      "occupiedToUnoccupiedDelaySec": 10,
      "unoccupiedToOccupiedDelaySec": 10,
      "unoccupiedToOccupiedEventThreshold": 2
    }
  ]
}

裝置狀態

具有此特徵的實體可能會回報下列資料： 做為 QUERY 作業的一部分。學習 如要進一步瞭解如何處理 QUERY 意圖，請參閱 意圖執行要求。

州	類型	說明
occupancy	String	必要。 指出裝置是否感應活動情形。 支援的值： OCCUPIED 裝置偵測到活動情形。 UNOCCUPIED 裝置不會偵測活動情形。 UNKNOWN_OCCUPANCY_STATE 裝置偵測到目前的活動情形狀態不明。

範例

感應器是否偵測到辦公室內的活動情形？

{
  "occupancy": "OCCUPIED"
}

裝置指令

無。

裝置錯誤

查看完整清單 錯誤和例外狀況。