Schéma des traits de scène de la maison connectée
action.devices.traits.Scene
: cette caractéristique permet d'implémenter des appareils virtuels avec le type d'appareil SCENE.
Pour en savoir plus, consultez le guide sur le type de scène.
Par exemple, si un appareil permet aux utilisateurs de configurer un regroupement de commandes en un seul geste, comme régler les lumières sur des couleurs spécifiques, séquencer différentes 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. L'Assistant mettra ces scènes à la disposition des utilisateurs via une grammaire d'activation simple:
- Démarrer le mode Fête
- Activez le mode Nuit.
En tant qu'objets virtuels, les scènes peuvent être placées dans des pièces (le cas échéant) afin de les différencier:
- Lancez la fête dans la cuisine
- Activez le mode Veilleuse dans les chambres.
L'une des différences entre les scènes et les cibles physiques est que l'Assistant applique automatiquement plusieurs effets aux commandes de la scène, ce qui permet aux utilisateurs de déclencher des scènes sur plusieurs partenaires. Par exemple, si un utilisateur dispose d'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 prochaines actions personnelles pour une grammaire personnalisée (par exemple, Activer le mode Fête -> Que la fête commence !).
Les scènes doivent toujours avoir des noms fournis par les utilisateurs, et non le nom par défaut "Scène BobCo". Chaque scène correspond à un appareil virtuel qui lui est propre, et possède un ou plusieurs noms qui lui sont propres.
Les noms fournis par les utilisateurs peuvent provenir de SYNC
.
ATTRIBUTS DES APPAREILS
Les appareils dotés de 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 section Traitement des intents.
Attributs | Type | Description |
---|---|---|
sceneReversible |
Valeur booléenne |
(Par défaut : Indique que la 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 prend en charge la commande |
Exemples
Appareil compatible avec les scènes réversibles.
{ "sceneReversible": true }
ÉTATS de l'appareil
Aucune
COMMANDES D'appareil
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 section Traitement des intents.
action.devices.commands.ActivateScene
Activez ou désactivez une scène.
Paramètres
Paramètres | Type | Description |
---|---|---|
deactivate |
Valeur booléenne |
Obligatoire. "True" pour annuler une scène si elle est réversible, "false" pour activer une scène. |
Exemples
Activez une scène en saisissant son nom.
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": false } }
Désactivez une scène en saisissant son nom.
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": true } }