智慧型住宅共乘特徵結構定義

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

裝置指令

無。

裝置錯誤

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