Schéma de la scène pour la maison connectée
action.devices.traits.Scene
: cette caractéristique est utilisée pour implémenter des appareils virtuels avec le type d'appareil SCENE.
Pour en savoir plus, consultez le guide des types de scènes.
Par exemple, si un appareil permet de configurer le regroupement des commandes en un seul geste (définir des lumières sur des couleurs spécifiques, séquencer des 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 activation:
- Démarrez le mode Fête.
- Activer la scène à partir 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 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 des effets de pluriel aux scènes, ce qui permet aux utilisateurs de déclencher des scènes sur 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 -> C'est parti !).
Les scènes doivent toujours avoir des noms fournis par l'utilisateur par rapport aux noms par défaut "BobCo". Chaque scène est associée à son propre appareil virtuel, avec ses propres noms.
Les noms fournis par l'utilisateur peuvent provenir de SYNC
.
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 |
---|---|---|
sceneReversible |
Booléen |
(Par défaut : Indique que cette scène peut être annulée. Cet attribut n'est pertinent que pour les scènes qui modifient l'état et mémorisent l'état précédent. L'appareil est compatible avec la commande |
Exemples
Appareil compatible avec une scène réversible.
{ "sceneReversible": true }
Appareil STATES
Aucun.
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.ActivateScene
Activer ou désactiver une scène
Paramètres
Paramètres | Type | Description |
---|---|---|
deactivate |
Booléen |
Obligatoire. Vrai pour annuler une scène si elle est réversible, ou faux 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 } }