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 iniziale di smart home

action.devices.traits.StartStop: questa caratteristica appartiene ai dispositivi che supportano le operazioni di avvio e di interruzione.

L'avvio e l'interruzione di un dispositivo svolge una funzione simile per l'accensione e lo spegnimento. I dispositivi che ereditano questo attributo funzionano in modo diverso all'accensione e all'avvio. Alcune lavatrici, ad esempio, possono essere accese e modificare le impostazioni prima di iniziare a funzionare.

A differenza dei dispositivi che hanno semplicemente uno stato acceso e spento, alcuni dispositivi che possono avviare e arrestare gli annunci possono anche essere messi in pausa mentre eseguono un'operazione. I dispositivi che possono essere messi in pausa smetteranno di funzionare, ma al momento del ripristino continueranno allo stesso stato in cui erano in pausa. La riattivazione avviene in modo diverso dall'avvio e dal riavvio, indipendentemente dallo stato attuale del dispositivo, pertanto l'operazione inizierà dall'inizio.

Alcuni dispositivi potrebbero supportare l'esecuzione in determinate zone. Ad esempio, un irrigatore potrebbe avere diverse zone di irrigazione e supporta la capacità di annaffiare determinate zone separatamente, mentre un aspirapolvere può supportare la pulizia di stanze specifiche.

ATTRIBUTE di dispositivo

I dispositivi con questa caratteristica potrebbero segnalare i seguenti attributi come parte dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta fulfillment degli intent.

Attributi Tipo Descrizione
pausable Booleano

(valore predefinito: false)

Indica se il dispositivo può essere messo in pausa durante il funzionamento.

availableZones Array

Indica i nomi di zona supportati. Le stringhe devono essere localizzate come impostato dall'utente. Questo elenco non è esclusivo; gli utenti possono segnalare qualsiasi nome.

[item, ...] Stringa

Nome di una zona in cui è supportato l'avvio del dispositivo.

Esempi

Dispositivo che può essere messo in pausa e supporta l'utilizzo in più zone.

{
  "pausable": true,
  "availableZones": [
    "kitchen",
    "living room",
    "office",
    "bedroom"
  ]
}

Dispositivo STATES

I dispositivi con questa caratteristica potrebbero segnalare i seguenti stati come parte dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta fulfillment degli intent.

Stati Tipo Descrizione
isRunning Booleano

Obbligatorio.

Indica se il dispositivo è attualmente in funzione.

isPaused Booleano

Indica se il dispositivo è stato messo in pausa in modo esplicito. Se questo valore è true, implica che isRunning è false, ma può essere ripristinato.

activeZones Array

Indica le zone in cui il dispositivo è attualmente in esecuzione, dall'elenco di availableZones.

[item, ...] Stringa

Il nome della zona.

Esempi

Il dispositivo è in pausa?

{
  "isRunning": false,
  "isPaused": true
}

Il dispositivo è in pausa?

{
  "isRunning": true,
  "isPaused": false
}

Il dispositivo è in funzione?

{
  "isRunning": true,
  "isPaused": false,
  "activeZones": [
    "kitchen",
    "living room"
  ]
}

COMANDI sul dispositivo

I dispositivi con questa caratteristica possono rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta fulfillment degli intent.

action.devices.commands.StartStop

Avviare o arrestare il dispositivo.

Parametri

Parametri Tipo Descrizione
start Booleano

Obbligatorio.

Vero per avviare il funzionamento del dispositivo, falso per interrompere.

zone Stringa

Indica la zona da cui iniziare l'esecuzione.

multipleZones Array

Indica due o più zone da cui iniziare l'esecuzione. Verrà impostato al posto di zone parameter.

[item, ...] Stringa

Nome di una zona in cui iniziare il dispositivo.

Esempi

Avvia il dispositivo.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true
  }
}

Arresta il dispositivo.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": false
  }
}

Avvia il dispositivo in ufficio.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "zone": "office"
  }
}

Avvia il dispositivo in cucina, sala da pranzo e salotto.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "multipleZones": [
      "kitchen",
      "dining room",
      "living room"
    ]
  }
}

action.devices.commands.PauseUnpause

Metti in pausa o riattiva l'operazione del dispositivo.

Questo comando richiede i seguenti attributi:
{
  "pausable": true
}

Parametri

Parametri Tipo Descrizione
pause Booleano

Obbligatorio.

Vero per mettere in pausa, falso per riattivare.

Esempi

Metti in pausa il dispositivo.

{
  "command": "action.devices.commands.PauseUnpause",
  "params": {
    "pause": true
  }
}

L'utente ha provato a mettere in pausa un dispositivo, ma il dispositivo si trova in uno stato in cui non può essere messo in pausa.

Valori supportati:

unpausableState

Esempi di frasi

de-DE

  • Bitte starte den Staubsauger im Wohnzimmer .
  • Geschirrspüler wieder anstellen
  • Staubsauger aschalten
  • Staubsauger pausieren
  • bitte starte die Waschmaschine

en-US

  • ho bisogno di my roomba per iniziare a correre in Den
  • metti in pausa l'asciugatrice ora
  • avvia l'asciugatrice adesso
  • interrompi la lavastoviglie
  • Riattiva La lavastoviglie

es-ES

  • parar la lavadora
  • pon el aspirador it el dormitorio principal
  • pon el lavavajillas en pausa
  • quiero usar el friegaplatos
  • vuelve a encender la aspiradora

fr-FR

  • Allumer l'aspirateur dans le salone .
  • Continua l'aspirateur .
  • arrête l'aspirateur
  • lancia la machine à laver
  • soddisfatto l'aspirateur en pause

ERRORS dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.