スマートホームの StatusReport トレイトのスキーマ
action.devices.traits.StatusReport - このトレイトは、特定のデバイスまたはデバイス グループの現在のステータスの報告に使用します。
特定のデバイスは、現在のステータスと、グループ内の関連デバイスのステータスを報告できます。たとえば、対象デバイスは、関連するデバイスが個々のセンサーを表すセキュリティ システムです。StatusReport は、集合的なステータスを報告するための集合体として機能しますが、個々のアドレス指定に代わるものではありません。Google アシスタントからアクセスできるデバイスは、SYNC レスポンスで個別のデバイスとして報告する必要があります。
デバイスの属性
なし。
デバイスのステータス
このトレイトを持つエンティティは、QUERY オペレーションの一部として次のステータスを報告できます。QUERY インテントの処理の詳細については、インテントのフルフィルメントをご覧ください。
| 州 | タイプ | 説明 |
|---|---|---|
currentStatusReport |
配列 |
必須。 デバイスの現在のエラーまたは例外ステータスと、関連するデバイス ID。 |
[item, ...] |
オブジェクト |
現在のステータス。 |
blocking |
ブール値 |
エラーまたは現在のステータスが、以降のコマンドの実行をブロックしている場合、true。 |
deviceTarget |
String |
ターゲット デバイスの ID。 |
priority |
整数 |
このステータスの優先度を指定します。値が小さいほど優先度は高く、優先度が最も高いのは 0 です。エラーまたは例外のステータスは、優先度の高い順に報告されます。サーフェスに応じて、優先度の高いエラーまたは例外のみ報告される場合があります。 |
statusCode |
String |
デバイスの現在のステータス。エラーと例外の全リストをご覧ください。 |
例
セキュリティ システムは大丈夫ですか？
{
"currentStatusReport": [
{
"blocking": false,
"deviceTarget": "alarm_1",
"priority": 0,
"statusCode": "lowBattery"
},
{
"blocking": false,
"deviceTarget": "front_window_1",
"priority": 1,
"statusCode": "deviceOpen"
},
{
"blocking": false,
"deviceTarget": "back_window_2",
"priority": 1,
"statusCode": "deviceOpen"
},
{
"blocking": true,
"deviceTarget": "alarm_2",
"priority": 0,
"statusCode": "needsSoftwareUpdate"
}
]
}デバイスのコマンド
なし。