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 Trait de scène pour maison connectée

action.devices.traits.Scene : cette caractéristique permet d'implémenter des appareils virtuels avec le type d'appareil SCÈNE.

Pour en savoir plus, consultez le guide des types de scènes.

Par exemple, si un appareil permet aux utilisateurs de configurer le regroupement des commandes en un seul geste (définir des lumières sur des couleurs spécifiques, séquencer diverses fonctionnalités de sécurité ou toute autre combinaison d'activités), cette configuration peut être exposée via SYNC en tant que scène nommée, et l'Assistant mettra ces scènes à la disposition des utilisateurs via une simple grammaire d'activation:

  • Démarrer le mode Fête
  • Activez la scène de minuit.

En tant qu'objets virtuels, les scènes peuvent être placées dans des pièces (le cas échéant) pour éviter toute ambiguïté:

  • Commencez à faire la fête en cuisine.
  • Activez le mode Éclairage nocturne dans les chambres.

L'une des différences entre les scènes et les cibles physiques est que l'Assistant applique automatiquement les formes au pluriel aux scènes, ce qui permet aux utilisateurs de déclencher des scènes entre plusieurs partenaires. Par exemple, si un utilisateur a défini une scène en "mode Fête" sur deux partenaires différents, l'un pour la sécurité et l'autre pour les lumières, l'option Activer le mode Fête déclenche les deux.

Les scènes interagiront bien avec les actions personnelles à venir pour la grammaire personnalisée (par exemple, Activer le mode Fête -> Commençons la fête !).

Le nom des scènes doit toujours être fourni par l'utilisateur, et non celui par défaut "BobCo". Chaque scène correspond à son propre appareil virtuel et possède son propre nom. Les noms fournis par les utilisateurs peuvent provenir de SYNC.

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
sceneReversible Booléen

(Par défaut : false)

Indique que cette scène peut être annulée. Cet attribut n'est pertinent que pour les scènes qui modifient l'état et se souviennent de l'état précédent. L'appareil accepte la commande ActivateScene avec le paramètre deactivate défini sur "true".

Exemples

Appareil compatible avec les scènes réversibles.

{
  "sceneReversible": true
}

Appareil : STATES

None.

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

Activer ou désactiver une scène

Paramètres

Paramètres Type Description
deactivate Booléen

Obligatoire.

True pour annuler une scène réversible, ou false pour activer une scène.

Exemples

Activez une scène par son nom.

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": false
  }
}

Désactiver une scène par son nom

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": true
  }
}

Erreurs liées à l'appareil

Consultez la liste complète des erreurs et exceptions.