スマートホームの 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"
}

デバイスのコマンド

なし。

デバイスエラー

詳しくは、 エラーと例外をご覧ください。