Ti diamo il benvenuto nel Centro sviluppatori Google Home, la nuova destinazione per scoprire come sviluppare azioni per la smart home. Nota: continuerai a creare azioni nella console di Actions.

Schema del Trait Smart Home OnOff

action.devices.traits.OnOff: le funzionalità di base per l'attivazione e la disattivazione di qualsiasi dispositivo con funzionalità di attivazione e disattivazione dei programmi binari, incluse prese e interruttori, nonché molti dispositivi futuri.

ATTRIBUTE dispositivo

I dispositivi con questo trattino potrebbero segnalare i seguenti attributi come parte dell'operazione SYNC. Per saperne di più sulla gestione degli intent SYNC, consulta la sezione fulfillment di 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 le informazioni sullo stato.

queryOnlyOnOff Booleano

(Valore predefinito: false)

Indica se è possibile eseguire query sulle informazioni sullo stato del dispositivo e non può essere controllato tramite i comandi.

Esempi

Dispositivo che supporta il comando on/off e gli stati dei report.

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

Dispositivo che supporta solo comandi on/off.

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

Dispositivo (generalmente sensore) che supporta soltanto la generazione di report sullo stato on/off.

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

STATO dispositivo

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

Stati Tipo Descrizione
on Booleano

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

Esempi

Il dispositivo è acceso?

{
  "on": true
}

Il dispositivo è spento?

{
  "on": false
}

COMANDI dispositivo

I dispositivi con questo trattino potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per saperne di più sulla gestione degli intent EXECUTE, consulta la sezione fulfillment di 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
  }
}

Espressioni di esempio

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.