Schema del tratto StatusReport di Smart Home

action.devices.traits.StatusReport: questa caratteristica indica lo stato attuale di un dispositivo specifico o di un gruppo di dispositivi connessi.

Un dispositivo specifico può segnalare il suo stato attuale, 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 singoli sensori. StatusReport funge da aggregazione per la segnalazione dello stato collettivo, ma non sostituisce l'indirizzamento individuale. Qualsiasi dispositivo a cui può accedere l'Assistente Google deve essere segnalato come dispositivo separato nella risposta SYNC.

ATTRIBUTI dispositivo

Nessuno.

Stati del dispositivo

Le entità con questo tratto possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per saperne di più sulla gestione degli intent QUERY, consulta Completamento degli intent.

Stati Tipo Descrizione
currentStatusReport Array

Obbligatorio.

Stati di errore o eccezione attuali del dispositivo e eventuali ID dispositivo correlati.

[item, ...] Oggetto

Stato attuale.

blocking Valore booleano

True se l'errore o lo stato attuale blocca l'esecuzione di ulteriori 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à più alta 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.

Valore minimo: 0.

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

Consulta l'elenco completo di errori ed eccezioni.