Schema del Trait OnOff per la smart home

action.devices.traits.OnOff: la funzionalità di accensione e spegnimento di base per qualsiasi dispositivo con accensione e spegnimento binari, inclusi prese e interruttori, nonché molti dispositivi futuri.

ATTRIBUTES dispositivo

I dispositivi con questa caratteristica possono segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Adempimento degli intent.

Attributi Tipo Descrizione
commandOnlyOnOff Valore booleano

(Valore predefinito: false)

Indica se il dispositivo può essere controllato solo tramite comandi e non è possibile eseguire query per informazioni sullo stato.

queryOnlyOnOff Valore booleano

(Valore predefinito: false)

Indica se è possibile eseguire query sul dispositivo solo per informazioni sullo stato e non può essere controllato tramite comandi.

Esempi

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

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

Dispositivo che supporta solo i comandi di accensione/spegnimento.

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

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

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

STATI del dispositivo

Le entità con questo tratto possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta Adempimento degli intent.

Stati Tipo Descrizione
on Valore 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 questa caratteristica possono rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta Completamento dell'intent.

action.devices.commands.OnOff

Accendi o spegni il dispositivo.

Parametri

Parametri Tipo Descrizione
on Valore booleano

Obbligatorio.

Indica 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
  }
}

Frasi 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 di errori ed eccezioni.