スマートホームの StatusReport トレイトのスキーマ

action.devices.traits.StatusReport - このトレイトは、特定のデバイスまたはデバイス グループの現在のステータスを報告します。

特定のデバイスは、現在のステータスとグループ内の関連デバイスのステータスを報告できます。たとえば、ターゲット デバイスは、関連するデバイスが個々のセンサーを表すセキュリティ システムです。StatusReport は、グループのステータスを報告するための集約として機能しますが、個々のアドレス指定に代わるものではありません。Google アシスタントがアクセスできるデバイスは、SYNC レスポンスで個別のデバイスとして報告されます。

デバイスの属性

なし。

デバイスのステータス

このトレイトを持つエンティティは、QUERY オペレーションの一部として次の状態をレポートできます。QUERY インテントの処理方法については、インテントのフルフィルメントをご覧ください。

状態 タイプ 説明
currentStatusReport 配列

必須。

デバイスの現在のエラーまたは例外ステータスと、関連するデバイス ID。

[item, ...] 温度計

現在のステータスです。

blocking ブール値

エラーまたは現在のステータスがそれ以上のコマンド実行をブロックしている場合は true。

deviceTarget 文字列

ターゲット デバイスの ID。

priority 整数

このステータスの優先度を指定します。値が小さいほど優先度は高く、優先度が最も高いのは 0 です。エラーまたは例外ステータスは、優先度が高いものから順に報告されます。サーフェスに応じて、Google は優先度の高いエラーや例外のみを報告します。

statusCode 文字列

デバイスの現在のステータス。エラーと例外の全リストをご覧ください。

セキュリティ システムは大丈夫ですか?

{
  "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"
    }
  ]
}

デバイスのコマンド

なし。

デバイスエラー

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