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

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

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

デバイスの属性

なし

デバイスのステータス

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

状態	タイプ	説明
currentStatusReport	配列	必須。 デバイスの現在のエラーまたは例外ステータスと関連するデバイス ID。
[item, ...]	オブジェクト	現在のステータス:
blocking	ブール値	エラーまたは現在のステータスによって以降のコマンドの実行がブロックされている場合は true。
deviceTarget	文字列	ターゲット デバイスの ID。
priority	Integer	このステータスの優先度を指定します。値が小さいほど優先度は高く、優先度が最も高いのは 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"
    }
  ]
}

デバイスのコマンド

なし

デバイスエラー

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