Bienvenue dans le centre Google Home pour les développeurs, la nouvelle destination pour apprendre à développer des actions pour la maison connectée. Remarque:Vous continuerez de créer des actions dans la console Actions.

Schéma de la fonction OnOff Trait pour la maison connectée

action.devices.traits.OnOff : fonctionnalité de base permettant d'allumer et d'éteindre les appareils compatibles avec le binaire, y compris les prises et les interrupteurs, ainsi que de nombreux futurs appareils.

ATTRIBUTS de l'appareil

Les appareils disposant de cette caractéristique peuvent signaler les attributs suivants lors de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez Traitement des intents.

Attributs Type Description
commandOnlyOnOff Booléen

(Par défaut : false)

Indique si l'appareil ne peut être contrôlé que par des commandes et ne peut pas être interrogé pour obtenir des informations sur l'état.

queryOnlyOnOff Booléen

(Par défaut : false)

Indique si l'appareil peut uniquement être interrogé pour obtenir des informations sur l'état et ne peut pas être contrôlé via des commandes.

Exemples

Appareil compatible avec les commandes et les états de création de rapports activés/désactivés.

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

Appareil uniquement compatible avec les commandes d'activation et de désactivation.

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

Appareil (généralement un capteur) qui ne prend en charge que les états d'activation et de désactivation des rapports.

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

Appareil STATES

Les entités dotées de cette caractéristique peuvent signaler les états suivants dans le cadre de l'opération QUERY. Pour en savoir plus sur la gestion des intents QUERY, consultez Traitement des intents.

États Type Description
on Booléen

Indique si un appareil avec un bouton Marche/Arrêt est allumé ou éteint.

Exemples

L'appareil est-il allumé ?

{
  "on": true
}

L'appareil est-il éteint ?

{
  "on": false
}

Appareil COMMANDS

Les appareils disposant de cette caractéristique peuvent répondre aux commandes suivantes dans le cadre de l'opération EXECUTE. Pour en savoir plus sur la gestion des intents EXECUTE, consultez Traitement des intents.

action.devices.commands.OnOff

Allumez ou éteignez l'appareil.

Paramètres

Paramètres Type Description
on Booléen

Obligatoire.

Permet d'allumer ou d'éteindre l'appareil.

Exemples

Allumez l'appareil.

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

Éteignez l'appareil.

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

Exemples d'énoncés

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å?

ERREURS sur l'appareil

Consultez la liste complète des erreurs et exceptions.