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

デバイスのコマンド

なし。

デバイスエラー

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