Bienvenue dans le Centre des développeurs Google Home, la nouvelle destination pour apprendre à développer des actions pour la maison connectée. Remarque : Vous continuerez à créer des actions dans la console Actions.
Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Schéma d'activation et de désactivation de la maison connectée

action.devices.traits.OnOff : fonctionnalité de base qui permet d'allumer et d'éteindre tout appareil dont le mode binaire est activé et désactivé, ce qui inclut les prises et les interrupteurs, ainsi que de nombreux futurs appareils.

Appareil : ATTRIBUTES

Les appareils associés à cette caractéristique peuvent signaler les attributs suivants dans le cadre de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez la page Traitement des intents.

Attributs Type Description
commandOnlyOnOff Booléen

(Par défaut : false)

Indique si l'appareil ne peut être contrôlé que via des commandes et ne peut pas être interrogé pour les informations d'état.

queryOnlyOnOff Booléen

(Par défaut : false)

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

Exemples

Appareil compatible avec les commandes d'activation/de désactivation et les états de reporting.

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

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

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

Appareil (capteur en général) compatible uniquement avec l'état d'activation/de désactivation des rapports.

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

Appareil : STATES

Les appareils associés à 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 la page Traitement des intents.

États Type Description
on Booléen

Indique si un appareil avec un bouton marche/arrêt est activé ou désactivé.

Exemples

L'appareil est-il allumé ?

{
  "on": true
}

L'appareil est-il éteint ?

{
  "on": false
}

Appareil COMMANDS

Les appareils dotés 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 la page 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
  • Lampen

en-US

  • éteins la climatisation
  • allumer mes lumières

es-ES

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

fr-FR

  • Tu peux Déconnecter le salon ?
  • Lumière la chambre
  • Lumière les lumières
  • éteins les lumières

Erreurs liées à l'appareil

Consultez la liste complète des erreurs et exceptions.