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 : false)

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 ActivateScene avec le paramètre deactivate défini sur "true".

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
  }
}

ERREURS sur l'appareil

Consultez la liste complète des erreurs et exceptions.