Ti diamo il benvenuto nel Centro sviluppatori Google Home, la nuova destinazione per imparare a sviluppare azioni per la smart home. Nota:continuerai a creare azioni nella Console Actions.
Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Schema tratto report Stato smart home

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

Un dispositivo specifico può segnalare il suo stato attuale e quello di qualsiasi dispositivo correlato 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 i singoli indirizzi. Qualsiasi dispositivo a cui l'Assistente Google possa accedere deve essere segnalato come dispositivo separato nella risposta SYNC.

ATTRIBUTE del dispositivo

Nessuna.

STATEs dispositivo

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

Stati Tipo Descrizione
currentStatusReport Array

Obbligatorio.

Gli stati di errore o eccezione correnti del dispositivo e gli eventuali ID dispositivo correlati.

[item, ...] Oggetto

Stato attuale.

blocking Booleano

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

deviceTarget Stringa

L'ID del dispositivo di destinazione.

priority Intero

Specifica la priorità di questo stato. Più basso è il valore, maggiore è 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 superficie, Google potrebbe segnalare solo errori o eccezioni con priorità elevata.

statusCode Stringa

Lo stato attuale del dispositivo. Consulta l'elenco completo degli errori e delle 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

Nessuna.

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.