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 delle caratteristiche del ciclo di smart home

action.devices.traits.RunCycle: questa caratteristica rappresenta qualsiasi dispositivo la cui durata è in corso e che può essere oggetto di query.

I dispositivi come questi riportano il numero totale di cicli all'inizio dell'operazione e ogni ciclo in cui l'utente è attualmente in esecuzione. Ciò consente all'utente di eseguire query come:

  • In che ciclo è il mio asciugatrice?
  • Quanti cicli ha la lavastoviglie?
  • Cosa sta facendo l'asciugatrice?
  • Quando verrà completato il lavaggio?

Alcuni dispositivi includono una durata in formato non ciclico. Qualsiasi dispositivo in esecuzione per un determinato periodo di tempo può segnalare il tempo rimanente, senza cicli. Inoltre, gestisce i casi in cui i cicli potrebbero non essere coerenti (ad esempio, le lavastoviglie potrebbero non utilizzare sempre tutti i cicli). Ad esempio, l'utente potrebbe chiedere quanto più a lungo durerà l'aspirapolvere, che restituirà la quantità di tempo in unità proporzionale al tempo rimanente. Questo vale anche per i dispositivi sopra elencati. Quanto tempo sarà più lungo per l'asciugatura dei miei vestiti? restituirà una durata in minuti.

I dispositivi possono restituire ciò che conoscono e la risposta dell'assistente TTS fornirà la risposta migliore con i dati disponibili (ad esempio, La lavastoviglie è in funzione e verrà completata in circa 20 minuti).

Attualmente, RunRun è una caratteristica di sola lettura: non ha comandi, ma solo stati per eseguire query. In futuro, potrebbero esserci meccanismi per ripetere i cicli o saltare cicli (ideale per gli irrigatori, per le lavatrici).

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
currentRunCycle Array

Obbligatorio.

Contiene i sinonimi per il ciclo corrente in ogni lingua supportata.

[item, ...] Oggetto

Nomi dei sinonimi.

currentCycle Stringa

Obbligatorio.

Ciclo attuale eseguito.

nextCycle Stringa

Campo facoltativo. Ciclo successivo.

lang Stringa

Obbligatorio.

Codice lingua per i nomi di ciclo specificati. Vedi Lingue supportate.

currentTotalRemainingTime Intero

Obbligatorio.

Tempo rimanente in funzione, in secondi.

currentCycleRemainingTime Intero

Obbligatorio.

Tempo rimanente del ciclo attuale, in secondi.

Esempi

Il dispositivo riscuoterà per altri 5 minuti e verrà completato tra 20 minuti.

{
  "currentRunCycle": [
    {
      "currentCycle": "rinse",
      "lang": "en"
    }
  ],
  "currentTotalRemainingTime": 1200,
  "currentCycleRemainingTime": 300
}

Il dispositivo va risciacquo per altri 5 minuti, prima di iniziare a ruotare.

{
  "currentRunCycle": [
    {
      "currentCycle": "rinse",
      "nextCycle": "spin",
      "lang": "en"
    }
  ],
  "currentTotalRemainingTime": 600,
  "currentCycleRemainingTime": 300
}

comandi del dispositivo

Nessuna.

NOTIFICHE DEL DISPOSITIVO

Nell'ambito di una modifica dello stato del dispositivo, i dispositivi con questa caratteristica potrebbero restituire il seguente payload di notifica. Per scoprire di più sull'implementazione delle notifiche, consulta Notifiche per le azioni relative alla smart home.

Campi Tipo Descrizione
RunCycle

Obbligatorio.

Payload della notifica.

Supporta una delle seguenti funzionalità:
0 Oggetto

Operazione riuscita

priority Intero

Obbligatorio.

Rappresenta il livello di notifica. Il valore attualmente supportato è 0, il che indica che la notifica deve essere pronunciata ad alta voce.

status Stringa

Obbligatorio.

Risultato dell'operazione.

Valori supportati:

SUCCESS
currentCycleRemainingTime Intero

Obbligatorio.

Tempo rimanente del ciclo attuale, in secondi.

1 Oggetto

Non riuscita

priority Intero

Obbligatorio.

Rappresenta il livello di notifica. Il valore attualmente supportato è 0, il che indica che la notifica deve essere pronunciata ad alta voce.

status Stringa

Obbligatorio.

Risultato dell'operazione.

Valori supportati:

FAILURE
errorCode Stringa

Obbligatorio.

Il valore può essere qualsiasi codice di errore per questa caratteristica, ad esempio deviceStuck.

Esempi

L'esecuzione del dispositivo è terminata.

{
  "RunCycle": {
    "priority": 0,
    "status": "SUCCESS",
    "currentCycleRemainingTime": 0
  }
}

Si è verificato un errore durante il completamento del ciclo attuale.

{
  "RunCycle": {
    "priority": 0,
    "status": "FAILURE",
    "errorCode": "deviceStuck"
  }
}

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.