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

デバイスのコマンド

なし

デバイスエラー

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