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 Smart Home

action.devices.traits.OnOff: funzionalità di base per attivare e disattivare qualsiasi dispositivo con funzionalità binaria attivata e disattivata, incluse le prese e gli interruttori e per molti dispositivi futuri.

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

(Valore predefinito: false)

Indica se il dispositivo può essere controllato solo tramite comandi e non può essere oggetto di query per informazioni sullo stato.

queryOnlyOnOff Booleano

(Valore predefinito: false)

Indica se il dispositivo può essere oggetto di query solo per informazioni sullo stato e non può essere controllato tramite comandi.

Esempi

Dispositivo che supporta gli comandi di attivazione e disattivazione e gli stati dei report.

{
  "commandOnlyOnOff": false,
  "queryOnlyOnOff": false
}

Dispositivo che supporta solo comandi on/off.

{
  "commandOnlyOnOff": true,
  "queryOnlyOnOff": false
}

Dispositivo (in genere sensore) che supporta solo la generazione di report su stato on/off.

{
  "queryOnlyOnOff": true,
  "commandOnlyOnOff": false
}

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

Indica se un dispositivo con un sensore on/off è acceso o spento.

Esempi

Il dispositivo è acceso?

{
  "on": true
}

Il dispositivo è spento?

{
  "on": false
}

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.OnOff

Accendi o spegni il dispositivo.

Parametri

Parametri Tipo Descrizione
on Booleano

Obbligatorio.

Consente di indicare se accendere o spegnere il dispositivo.

Esempi

Accendi il dispositivo.

{
  "command": "action.devices.commands.OnOff",
  "params": {
    "on": true
  }
}

Spegni il dispositivo.

{
  "command": "action.devices.commands.OnOff",
  "params": {
    "on": false
  }
}

Esempi di frasi

de-DE

  • Bitte Licht aus
  • Bitte das Wohnzimmer einschalten
  • Bitte die Küche ausstellen
  • Ist der Staubsauger an
  • Ist in der Küche noch was an
  • Lampen an

en-US

  • are the lights off
  • turn off the AC
  • turn on my lights
  • what is on in the kitchen ?

es-ES

  • enciende el robot de limpieza
  • enciéndeme el salón

fr-FR

  • Tu peux éteindre le salon ?
  • allume la chambre
  • allume les lumières
  • est-ce que la lumière de la cuisine est éteinte
  • qu'est-ce qui est allumé dans la cuisine
  • éteins les lumières

hi-IN

  • किचन को ऑन करो
  • किचन में कुछ ऑन है?
  • बत्तियाँ जला दें
  • बालकनी ऑफ कर दो
  • लाइट आन है क्या
  • लाइट ऑफ करो

it-IT

  • Accendimi la luce in cucina
  • Ho spento la luce in bagno ?
  • accendere in cucina
  • ho lasciato il bagno acceso?
  • spegni la luce della camera
  • spengi camera bimbi

ja-JP

  • エアコン はついてる
  • キッチン で何がオンになっていますか
  • ベッドルーム をつけて
  • リビング をオフにして
  • 照明 をオンにして
  • 照明 を消して

ko-KR

  • 거실 꺼 줘
  • 거실 에어컨 전원 켜
  • 거실 켜 줘
  • 켜져 있어
  • 에어컨 전원 꺼 줘
  • 주방 에 뭐 켜져 있어

nl-NL

  • babykamer aandoen
  • doe het licht aan
  • doe het licht uit
  • staat de droger aan
  • staat er iets aan in de keuken

pt-BR

  • Acender a luz .
  • Apagar a luz .
  • a sala está apagada?
  • acender a sala
  • eu apaguei luz do quarto ?
  • quero desligar o quarto

sv-SE

  • stäng av lampan
  • sätt på ljuset
  • vad är på i badrummet
  • Är badrumslampan på?

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.