智慧型住宅入住感應特徵結構定義

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"
}

裝置指令

無。

裝置錯誤

請參閱錯誤和例外狀況的完整清單。