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, c'est-à-dire définir l'éclairage 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. L'Assistant mettra ces scènes à la disposition des utilisateurs via une grammaire d'activation simple:

  • Démarrer le mode Fête.
  • Active 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 clarifier les choses:

  • Que la fête commence 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 des effets au pluriel aux commandes de la scène, ce qui permet aux utilisateurs de déclencher des scènes entre 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 actions personnelles à venir pour une grammaire personnalisée (par exemple, Activer le mode Fête -> C'est parti !).

Les noms des scènes doivent toujours être fournis par les utilisateurs, et non le nom par défaut "Scène BobCo". Chaque scène correspond à un appareil virtuel qui a son propre nom. Les noms fournis par les utilisateurs peuvent provenir de SYNC.

Attributs d'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 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 mémorisent 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
}

Device STATES

Aucun.

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

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.