Schema del tratto StatusReport 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 corrente, nonché lo stato 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 la generazione di report sullo stato collettivo, ma non sostituisce l'indirizzamento individuale. Qualsiasi dispositivo a cui è possibile accedere dall'Assistente Google deve essere indicato come dispositivo distinto nella risposta SYNC.

ATTRIBUTES dispositivo

Nessuno.

STATI del dispositivo

Le entità con questo tratto possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta Adempimento degli 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 corrente bloccano ulteriori esecuzioni di comandi.
deviceTarget	String	L'ID del dispositivo di destinazione.
priority	Intero	Specifica la priorità di questo stato. Più basso è il valore, maggiore è la priorità, con la priorità massima pari a 0. Google segnala lo stato di errore o eccezione dalla priorità più alta a quella più bassa. A seconda della piattaforma, Google potrebbe segnalare solo errori o eccezioni con priorità elevata.
statusCode	String	Lo stato attuale del dispositivo. Consulta l'elenco completo di errori ed eccezioni.

Esempi

Il mio sistema di sicurezza è a posto?

{
  "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 del dispositivo

Nessuno.

ERRORI dispositivo

Consulta l'elenco completo di errori ed eccezioni.