Schéma de comportement d'une 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 en un seul geste Commandes : vous pouvez régler les lumières sur des couleurs spécifiques ou séquencer différentes mesures de sécurité ou toute autre combinaison d'activités, celle-ci peut seront exposées via SYNC en tant que scènes nommées, et l'Assistant les fera scènes disponibles pour les utilisateurs grâce à une grammaire d'activation simple:

  • Démarrez le mode Fête.
  • 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 lever l'ambiguïté:

  • Faites la fête dans votre 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 appliquer automatiquement des effets au pluriel aux commandes Scène, ce qui permet aux utilisateurs de déclencher entre plusieurs partenaires. Par exemple, si un utilisateur a un "mode Fête" scène sur deux différents partenaires, un pour la sécurité et un pour l'éclairage, activer le mode Fête déclenchera les deux.

Les scènes interagiront bien avec les actions personnelles à venir pour personnaliser la grammaire (par exemple, Activer le mode Fête -> Que la fête commence !).

Les scènes doivent toujours avoir un nom fourni par l'utilisateur au lieu du nom par défaut "BobCo Scene" nommage. Chaque scène est un appareil virtuel distinct, avec un ou plusieurs noms. Les noms fournis par les utilisateurs peuvent provenir de SYNC.

ATTRIBUTS D'appareils

Les appareils présentant cette caractéristique peuvent signaler les éléments suivants : dans le cadre de l'opération SYNC. Pour apprendre Pour en savoir plus sur la gestion des intents SYNC, consultez 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 les scènes réversibles.

{
  "sceneReversible": true
}

STATES de l'appareil

Aucun

COMMANDS d'appareils

Les appareils présentant cette caractéristique peuvent répondre aux éléments suivants : dans le cadre de l'opération EXECUTE. Pour apprendre Pour en savoir plus sur la gestion des intents EXECUTE, consultez 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 celle-ci est réversible, "false" pour activer une scène.

Exemples

Activez une scène par son nom.

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": false
  }
}

Désactivez une scène par son nom.

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": true
  }
}

Erreurs d'appareil

Voir la liste complète les erreurs et les exceptions.