スマートホームの OccupancySensing トレイトのスキーマ

action.devices.traits.OccupancySensing - この特性は、PIR、超音波、物理接触センサーのいずれかによって占有率を検出できるデバイスに属します。

デバイスの属性

このトレイトを持つデバイスは、SYNC オペレーションの一部として次の属性を報告できます。SYNC インテントの処理の詳細については、インテントのフルフィルメントをご覧ください。

属性 タイプ 説明
occupancySensorConfiguration 配列

オブジェクトのリスト。それぞれにセンサータイプ、関連する遅延とイベントしきい値が含まれています。
[item, ...] 温度計

センサータイプ、および関連する遅延とイベントしきい値（該当する場合）。
occupancySensorType String

必須。

サポートされる値:

PIR
このデバイスは、受動的な赤外線（PIR）センサーによる占有率の検知をサポートしています。
ULTRASONIC
このデバイスは超音波センサーによる在宅確認をサポートしています。
PHYSICAL_CONTACT
物理的な接触センサーによる在宅確認のサポート。
occupiedToUnoccupiedDelaySec Integer

最後に検出されたイベント後に、報告される人数が占有状態に変更されるまでの時間遅延（秒）を表します。
unoccupiedToOccupiedDelaySec Integer

最後に報告されたイベントの後に、報告される利用人数が占有状態に変更されるまでの時間（秒）を表します。occupiedToUnoccupiedDelaySec が設定されている場合は必須。
unoccupiedToOccupiedEventThreshold Integer

レポートされた占有率が占有状態に変更されるまでの 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"
}

デバイスのコマンド

なし。

デバイスエラー

エラーと例外の全一覧をご覧ください。