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

action.devices.traits.OccupancySensing - このトレイトは、PIR、超音波、物理的な接触センサーのいずれでも在室状況を検出できるデバイスに使用します。

デバイスの属性

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

属性	タイプ	説明
occupancySensorConfiguration	配列	オブジェクトのリスト。各オブジェクトには、センサーの種類と、関連する遅延とイベントしきい値が含まれています。
[item, ...]	温度計	センサーの種類とそれに関連する遅延とイベントしきい値（該当する場合）。
occupancySensorType	文字列	必須。 サポートされている値: 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	文字列	必須。 デバイスが在宅を検知するかどうかを示します。 サポートされている値: OCCUPIED デバイスが在宅ステータスを検出しました。 UNOCCUPIED デバイスが在宅ステータスを検出しない。 UNKNOWN_OCCUPANCY_STATE デバイスで検出された現在の在宅ステータスは不明です。

例

センサーはオフィスで在宅を検知しますか？

{
  "occupancy": "OCCUPIED"
}

デバイスのコマンド

なし。

デバイスエラー

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