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

デバイスのコマンド

なし。

デバイスエラー

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