スマートホームの OccupancySensing トレイトのスキーマ
action.devices.traits.OccupancySensing
- このトレイトは、PIR、超音波、物理的な接触センサーのいずれでも在室状況を検出できるデバイスに使用します。
デバイスの属性
このトレイトを持つデバイスは、SYNC
オペレーションの一部として次の属性をレポートできます。SYNC
インテントの処理方法については、インテントのフルフィルメントをご覧ください。
属性 | タイプ | 説明 |
---|---|---|
occupancySensorConfiguration |
配列 |
オブジェクトのリスト。各オブジェクトには、センサーの種類と、関連する遅延とイベントしきい値が含まれています。 |
[item, ...] |
温度計 |
センサーの種類とそれに関連する遅延とイベントしきい値(該当する場合)。 |
occupancySensorType |
文字列 |
必須。 サポートされている値:
|
occupiedToUnoccupiedDelaySec |
整数 |
最後の検出イベント後、レポートされた対象人数が占有率のない状態に変わるまでの遅延時間(秒単位)を表します。 |
unoccupiedToOccupiedDelaySec |
整数 |
最後の検出イベントから、報告された宿泊人数が占有ステータスに変わるまでの遅延時間(秒単位)を表します。 |
unoccupiedToOccupiedEventThreshold |
整数 |
報告された宿泊人数が在宅ステータスに変わる前に、 |
例
PIR と超音波センサーに対応する在室確認センサー。
{ "occupancySensorConfiguration": [ { "occupancySensorType": "PIR", "occupiedToUnoccupiedDelaySec": 10, "unoccupiedToOccupiedDelaySec": 10, "unoccupiedToOccupiedEventThreshold": 2 }, { "occupancySensorType": "ULTRASONIC", "occupiedToUnoccupiedDelaySec": 10, "unoccupiedToOccupiedDelaySec": 10, "unoccupiedToOccupiedEventThreshold": 2 } ] }
デバイスのステータス
このトレイトを持つエンティティは、QUERY
オペレーションの一部として次の状態をレポートできます。QUERY
インテントの処理方法については、インテントのフルフィルメントをご覧ください。
状態 | タイプ | 説明 |
---|---|---|
occupancy |
文字列 |
必須。 デバイスが在宅を検知するかどうかを示します。 サポートされている値:
|
例
センサーはオフィスで在宅を検知しますか?
{ "occupancy": "OCCUPIED" }
デバイスのコマンド
なし。