Schema delle caratteristiche di StatusReport per la smart home

action.devices.traits.StatusReport: questa 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 all'interno di 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 lo stato collettivo dei report, ma non sostituisce i singoli indirizzamento. Qualsiasi dispositivo a cui l'Assistente Google può accedere deve essere segnalato come dispositivo separato nella risposta SYNC.

ATTRIBUTES del dispositivo

Nessuna.

Dispositivo STATES

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

Stati Tipo Descrizione
currentStatusReport Matrice

Obbligatorio.

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

[item, ...] Oggetto

Stato attuale.

blocking 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à più alta è 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"
    }
  ]
}

COMMANDS dispositivo

Nessuna.

ERRORS dispositivo

Consulta l'elenco completo di errori ed eccezioni.