Schema dei Trait Report di stato per la smart home

action.devices.traits.StatusReport: questo trait segnala lo stato attuale di un dispositivo specifico o di un gruppo di dispositivi connessi.

Un dispositivo specifico può segnalare il proprio stato attuale e quello di eventuali dispositivi correlati in un gruppo. Ad esempio, il dispositivo di destinazione potrebbe essere un sistema di sicurezza con i dispositivi correlati che rappresentano i singoli sensori. StatusReport funge da aggregazione per registrare lo stato collettivo, ma non sostituisce i singoli indirizzi. Tutti i dispositivi a cui l'Assistente Google possono accedere devono essere segnalati come dispositivi separati. nella risposta SYNC.

ATTRIBUTES dispositivo

Nessuno.

STATES del dispositivo

Le entità con questo tratto possono segnalare quanto segue nell'ambito dell'operazione QUERY. Per ulteriori informazioni scopri di più sulla gestione degli intent QUERY; consulta Completamento dell'intent.

Stati Tipo Descrizione
currentStatusReport Array

Obbligatorio.

Stati correnti di errore o eccezione del dispositivo ed eventuali ID dispositivo correlati.

[item, ...] Oggetto

Stato attuale.

blocking Valore booleano

True se l'errore o lo stato attuale blocca ulteriori esecuzioni dei comandi.

deviceTarget String

L'ID del dispositivo di destinazione.

priority Intero

Specifica la priorità di questo stato. Più basso è il valore, più alta è la priorità; la priorità massima è 0. Google segnala lo stato di errore o di eccezione dalla priorità più alta a quella più bassa. A seconda della piattaforma, Google potrebbe segnalare solo errori o eccezioni ad alta priorità.

statusCode String

Lo stato attuale del dispositivo. Consulta l'elenco completo di errori ed eccezioni.

Esempi

Il mio sistema di sicurezza funziona?

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

COMANDI dispositivo

Nessuno.

ERRORI dispositivo

Consulta l'elenco completo errori ed eccezioni.