智慧型住宅車輛種子結構定義

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

裝置指令

無。

裝置 ERRORS

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