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 trattino iniziale della smart home

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

L'avvio e l'interruzione di un dispositivo svolge una funzione simile per l'accensione e lo spegnimento. I dispositivi che ereditano questa funzione diversa quando viene attivata e avviata. Ad esempio, alcune lavatrici possono essere accese e modificate le relative impostazioni prima dell'effettiva operazione.

A differenza dei dispositivi che hanno semplicemente uno stato di accensione e spegnimento, alcuni dispositivi che possono essere avviati e arrestati possono essere messi in pausa anche durante l'esecuzione di un'operazione. I dispositivi che possono essere messi in pausa cesseranno di funzionare, ma il ripristino continuerà nello stesso stato in cui erano in pausa. La riattivazione differisce dall'avvio/riavvio, indipendentemente dallo stato attuale del dispositivo, che inizierà a funzionare dall'inizio.

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

ATTRIBUTE del 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 Soddisfazione 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 desideri.

[item, ...] Stringa

Nome di una zona in cui è supportato il dispositivo iniziale.

Esempi

Dispositivo che può essere messo in pausa e supporta il funzionamento in più zone.

{
  "pausable": true,
  "availableZones": [
    "Kitchen",
    "Living room",
    "Office",
    "Bedroom"
  ]
}

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
isRunning Booleano

Obbligatorio.

Indica se il dispositivo è attualmente in funzione.

isPaused Booleano

Indica se il dispositivo è stato messo esplicitamente in pausa. Se questo valore è vero, implica che isRunning è falso, 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 esecuzione?

{
  "isRunning": true,
  "isPaused": false,
  "activeZones": [
    "Kitchen",
    "Living room"
  ]
}

comandi del 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 Soddisfazione degli intent.

action.devices.commands.StartStop

Avvia o arresta il dispositivo.

Parametri

Parametri Tipo Descrizione
start Booleano

Obbligatorio.

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

zone Stringa

Indica la zona in cui iniziare a correre.

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 avviare il dispositivo.

Esempi

Avvia il dispositivo.

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

Spegni 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 il funzionamento 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 tentato di 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 abschalten
  • Staubsauger pausieren
  • bitte starte die Waschmaschine
  • ist die Waschmaschine fertig

en-US

  • I need my roomba to start running in the den
  • is the vacuum running
  • pause the dryer now
  • start the dryer now
  • stop the dishwasher
  • unpause the dishwasher

es-ES

  • dime si ha acabado el lavavajillas
  • parar la lavadora
  • pon el lavavajillas en pausa
  • quiero usar el friegaplatos
  • vuelve a encender la aspiradora

fr-FR

  • Allumer l'aspirateur dans le salon .
  • Continuer l'aspirateur .
  • arrête l'aspirateur
  • est-ce que l'aspirateur est en marche
  • lance la machine à laver
  • mets l'aspirateur en pause

hi-IN

  • कमरे में वैक्यूम चलाओगी
  • क्या वैक्यूम चल रहा है?
  • डिशवॉशर को कुछ देर रोको
  • वैक्यूम को अनपॉज़ करो
  • वैक्यूम को चालू कर दो
  • वैक्यूम को बंद कर दो

it-IT

  • Mi accendi l'aspirapolvere in cucina ?
  • fa' partire aspirapolvere
  • fai ripartire l'aspirapolvere
  • la lavatrice è in funzione
  • metti in pausa l'aspirapolvere
  • stoppa l'aspirapolvere

ja-JP

  • お掃除ロボット リビング で動かして
  • 台所の食洗機 を一時停止してください
  • 掃除機 は作動してる
  • 掃除機 を停止して
  • 掃除機 を再開してください
  • 洗濯機 をスタートさせて

ko-KR

  • 거실 에서 청소기 돌려
  • 건조기 돌아가고 있나
  • 세탁기 좀 돌려 줘
  • 식기 세척기 다시 시작해
  • 청소기 일시 정지
  • 청소기 작동 멈춰 줘

nl-NL

  • De schoonmaakrobot inschakelen in de keuken .
  • Is de stofzuiger klaar
  • hervat de stofzuiger
  • pauzeer de stofzuiger
  • start mijn stofzuiger
  • stop de stofzuiger

pt-BR

  • Inicia o aspersor no jardim
  • Iniciar o aspirador de pó na sala .
  • iniciar a máquina de lavar
  • o aspirador está parado?
  • parar a pausa na máquina de lavar roupa
  • parar o aspirador de pó
  • pausar o aspirador de pó

sv-SE

  • Kör igång sprinklern gräsmattan .
  • har dammsugaren i vardagsrummet startat?
  • kör igång dammsugaren igen
  • pausa dammsugaren
  • starta tvättmaskinen
  • stoppa dammsugaren

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.