Schéma de trait de scène de 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 des types de scènes.

Par exemple, si un appareil permet aux utilisateurs de configurer un regroupement de commandes en appuyant sur un bouton (par exemple, définir des lumières sur des couleurs spécifiques, ou 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. L'Assistant mettra ces scènes à la disposition des utilisateurs via une grammaire d'activation simple:

  • Activez le mode Party.
  • 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 clarifier les choses:

  • Démarrez la fête dans la cuisine.
  • Activez le mode veille dans les chambres.

Une différence entre les scènes et les cibles physiques est que l'Assistant applique automatiquement des effets au pluriel aux commandes de scène, ce qui permet aux utilisateurs de déclencher des scènes auprès de plusieurs partenaires. Par exemple, si un utilisateur a une scène "mode soirée" sur deux partenaires différents, l'un pour la sécurité et l'autre pour l'éclairage, l'option Activer le mode soirée déclenchera les deux.

Les scènes interagiront bien avec les prochaines actions personnelles pour la grammaire personnalisée (par exemple, Activer le mode Fête -> Allons-y !).

Les scènes doivent toujours porter un nom fourni par l'utilisateur, et non le nom par défaut "Scène BobCo". Chaque scène est un appareil virtuel à part entière, avec son ou ses propres noms. Les noms fournis par l'utilisateur peuvent provenir de SYNC.

ATTRIBUTS de l'appareil

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

Exemples

Appareil compatible avec une scène réversible.

{
  "sceneReversible": true
}

ÉTATS DE L'APPAREIL

Aucune.

COMMANDES DE L'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 l'activer.

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 de l'appareil

Consultez la liste complète des erreurs et exceptions.