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

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

デバイスのコマンド

なし。

デバイスエラー

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