Philips HUE (éditeur indépendant)
Philips HUE vous permet de contrôler les appareils domestiques intelligents, tels que les lumières, les commutateurs, les plugs et plus construits par Philips.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Tomasz Poszytek |
| URL | https://aka.ms/poszytek |
| Messagerie électronique | tomasz@poszytek.eu |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Tomasz Poszytek |
| Site web | https://www.philips-hue.com/ |
| Politique de confidentialité | https://www.philips-hue.com/en-us/support/legal/privacy-policy |
| Catégories | Internet des objets ; Style de vie et divertissement |
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application Power est partagée avec un autre utilisateur, un autre utilisateur sera invité à créer explicitement une nouvelle connexion.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| Clé d’application HUE | securestring | Clé API retournée après avoir effectué des appels d’autorisation PUT et POST. | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Exécuter la lumière |
Exécutez l’appareil avec des fonctionnalités de foudre. |
| Exécuter un appareil |
Exécutez un appareil spécifique. |
| Obtenir des appareils |
Obtenez la liste de tous vos appareils. |
| Obtenir des lumières |
Obtenez la liste de vos appareils ayant des fonctionnalités d’éclair. |
| Obtenir des salles |
Obtenir la liste des salles (groupes). |
| Obtenir des scènes |
Obtenez la liste de toutes les scènes. Les scènes sont utilisées pour stocker et rappeler les paramètres d’un groupe de lumières. |
| Obtenir la lumière |
Obtenez les détails d’un appareil spécifique ayant des fonctionnalités d’éclair. |
| Obtenir un appareil |
Obtenez les détails d’un appareil spécifique. |
| Obtenir une scène |
Obtenez des détails sur une scène spécifique. |
| Supprimer la scène |
Supprimez une scène spécifique. |
Exécuter la lumière
Exécutez l’appareil avec des fonctionnalités de foudre.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’appareil
|
DeviceId | True | string |
ID d’un appareil pour mettre à jour les propriétés. |
|
Nom
|
name | string |
MinLength : 1 - maxLength : 32. Nom lisible par l’homme d’une ressource. |
|
|
Activées
|
on | boolean |
État activé/désactivé de la lumière on=true, off=false. |
|
|
Luminosité
|
brightness | float |
Maximum : 100. Pourcentage de luminosité. L’écriture de 0 la modifie en luminosité la plus faible possible. |
|
|
Mirek
|
mirek | integer |
Minimum : 153 - maximum : 500. Température de couleur en mirek ou null lorsque la couleur claire n’est pas dans le spectre ct. |
|
|
X
|
x | float |
Minimum : 0 - maximum : 1. Position X dans la gamme de couleurs. |
|
|
O
|
y | float |
Minimum : 0 - maximum : 1. Position Y dans la gamme de couleurs. |
|
|
Vitesse
|
speed | float |
Minimum : 0 - maximum : 1. Vitesse de palette dynamique. La vitesse est valide pour la palette dynamique si l’état est dynamic_palette ou pour l’effet correspondant répertorié dans l’état. En cas d’état aucun, la vitesse n’est pas valide. |
|
|
Durée
|
duration | integer |
Maximum : 60000000. Durée d’une transition légère en ms. La précision est en 100 ms étapes. |
|
|
Action
|
action | string |
Une des actions disponibles à exécuter sur un appareil. C’est-à-dire « respirer ». |
|
|
X
|
x | float |
Minimum : 0 - maximum : 1. Position X dans la gamme de couleurs. |
|
|
O
|
y | float |
Minimum : 0 - maximum : 1. Position Y dans la gamme de couleurs. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
données
|
data | array of object |
données |
|
débarrasser
|
data.rid | string |
débarrasser |
|
rtype
|
data.rtype | string |
rtype |
|
Erreurs
|
errors | array of object |
Erreurs qui se sont produites pendant l’appel. |
|
Description de l’erreur
|
errors.description | string |
Explication lisible par l’homme propre à cette occurrence du problème. |
Exécuter un appareil
Exécutez un appareil spécifique.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’appareil
|
DeviceId | True | string |
ID d’un appareil pour mettre à jour les métadonnées. |
|
Archétype
|
archetype | string |
Par défaut, archétype donné par le fabricant. |
|
|
Nom
|
name | string |
Nom lisible humain d’une ressource (max. 32 caractères). |
|
|
Action
|
action | string |
Tapez « identifier » pour déclencher l’identification. Bridge effectue des cycles d’identification LED Zigbee pendant 5 secondes. Les lumières effectuent un cycle de respiration. Les capteurs effectuent des cycles d’identification LED pendant 15 secondes. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
données
|
data | array of object |
Appareils mis à jour. |
|
débarrasser
|
data.rid | string |
ID unique de la ressource référencée. |
|
rtype
|
data.rtype | string |
Type de la ressource référencée. |
|
Erreurs
|
errors | array of object |
Erreurs qui se sont produites pendant l’appel. |
|
Description de l’erreur
|
errors.description | string |
Explication lisible par l’homme propre à cette occurrence du problème. |
Obtenir des appareils
Obtenez la liste de tous vos appareils.
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Erreurs
|
errors | array of object |
Erreurs qui se sont produites pendant l’appel. |
|
Description de l’erreur
|
errors.description | string |
Explication lisible par l’homme propre à cette occurrence du problème. |
|
données
|
data | array of object |
Appareils utilisateur. |
|
Id
|
data.id | string |
Identificateur unique représentant une instance de ressource spécifique. |
|
ID v1
|
data.id_v1 | string |
Identificateur de ressource Clip v1 (à utiliser dans l’API v1). |
|
Archétype
|
data.metadata.archetype | string |
Archétype par défaut donné par le fabricant. |
|
Nom
|
data.metadata.name | string |
Nom lisible par l’homme d’une ressource. |
|
Certifié
|
data.product_data.certified | boolean |
Cet appareil est certifié HUE. |
|
Nom du fabricant
|
data.product_data.manufacturer_name | string |
Nom du fabricant de l’appareil. |
|
ID de modèle
|
data.product_data.model_id | string |
identification unique du modèle d’appareil. |
|
Archétype de produit
|
data.product_data.product_archetype | string |
Archétype du produit. |
|
Nom du produit
|
data.product_data.product_name | string |
Nom du produit. |
|
Version du logiciel
|
data.product_data.software_version | string |
Version logicielle du produit. |
|
Services
|
data.services | array of object |
Référence tous les services agrégeant le contrôle et l’état des enfants dans le groupe. |
|
débarrasser
|
data.services.rid | string |
ID unique de la ressource référencée. |
|
rtype
|
data.services.rtype | string |
Type de la ressource référencée. |
|
Type
|
data.type | string |
Type de la ressource prise en charge. |
Obtenir des lumières
Obtenez la liste de vos appareils ayant des fonctionnalités d’éclair.
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Erreurs
|
errors | array of object |
Erreurs qui se sont produites pendant l’appel. |
|
Description de l’erreur
|
errors.description | string |
Explication lisible par l’homme propre à cette occurrence du problème. |
|
données
|
data | array of object |
Lumières utilisateur. |
|
Valeurs d’action
|
data.alert.action_values | array of string |
Liste des effets d’alerte pris en charge par la lumière. |
|
X bleu
|
data.color.gamut.blue.x | float |
Position X dans la gamme de couleurs. |
|
Y bleu
|
data.color.gamut.blue.y | float |
Position Y dans la gamme de couleurs. |
|
X vert
|
data.color.gamut.green.x | float |
Position X dans la gamme de couleurs. |
|
Y vert
|
data.color.gamut.green.y | float |
Position X dans la gamme de couleurs. |
|
X rouge
|
data.color.gamut.red.x | float |
Position X dans la gamme de couleurs. |
|
Y rouge
|
data.color.gamut.red.y | float |
Position X dans la gamme de couleurs. |
|
Type gamut
|
data.color.gamut_type | string |
Les types de gamuts pris en charge par hue : A - Gamut de produits de couleur Philips précoces, B - Gamme limitée de premiers produits de couleur Hue, C - Plus riche gamme de couleurs de produits d’ambiance de teinte blanche et couleur, autre - Gamut de couleurs de produits non-teintes. |
|
X
|
data.color.xy.x | float |
Position X dans la gamme de couleurs. |
|
O
|
data.color.xy.y | float |
Position Y dans la gamme de couleurs. |
|
Mirek
|
data.color_temperature.mirek | integer |
Température de couleur en mirek ou null lorsque la couleur claire n’est pas dans le spectre ct. |
|
Mirek maximum
|
data.color_temperature.mirek_schema.mirek_maximum | integer |
Température de couleur maximale prise en charge par cette lumière. |
|
Mirek minimum
|
data.color_temperature.mirek_schema.mirek_minimum | integer |
Température de couleur minimale prise en charge par cette lumière. |
|
Mirek valide
|
data.color_temperature.mirek_valid | boolean |
Indique si la valeur présentée dans mirek est valide. |
|
Luminosité
|
data.dimming.brightness | float |
Pourcentage de luminosité. la valeur ne peut pas être 0, en écrivant 0 la modification de la luminosité la plus faible possible. |
|
Niveau minimal dim
|
data.dimming.min_dim_level | float |
Pourcentage de la quantité maximale de sorties de l’appareil sur une luminosité minimale. |
|
Vitesse
|
data.dynamics.speed | float |
Vitesse de palette dynamique ou d’effet. La vitesse est valide pour la palette dynamique si l’état est dynamic_palette ou pour l’effet correspondant répertorié dans l’état. En cas d’état aucun, la vitesse n’est pas valide. |
|
Vitesse valide
|
data.dynamics.speed_valid | boolean |
Indique si la valeur présentée en vitesse est valide. |
|
Statut
|
data.dynamics.status | string |
État actuel de la lampe avec dynamique. |
|
Valeurs d’état
|
data.dynamics.status_values | array of string |
États dans lesquels une lampe peut être lors de la lecture dynamique. |
|
ID de ressource
|
data.id | string |
Identificateur unique représentant une instance de ressource spécifique. |
|
Id de ressource clip v1
|
data.id_v1 | string |
Identificateur de ressource v1 (version de l’API v1). |
|
Archétype
|
data.metadata.archetype | string |
Archétype clair. Déconseillé : utilisez l’archétype au niveau de l’appareil. |
|
Nom donné de l’appareil
|
data.metadata.name | string |
Nom lisible par l’homme d’une ressource. |
|
Mode
|
data.mode | string |
L’un des éléments suivants : normal ou streaming. |
|
État clair
|
data.on.on | boolean |
État activé/désactivé de la lumière : on=true, off=false. |
|
RID
|
data.owner.rid | string |
ID unique de la ressource référencée. |
|
Rtype
|
data.owner.rtype | string |
Type de la ressource référencée. |
|
Type
|
data.type | string |
Type des ressources prises en charge. |
Obtenir des salles
Obtenir la liste des salles (groupes).
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Erreurs
|
errors | array of object |
Erreurs qui se sont produites pendant l’appel. |
|
Description de l’erreur
|
errors.description | string |
Explication lisible par l’homme propre à cette occurrence du problème. |
|
données
|
data | array of object |
Données. |
|
Enfants
|
data.children | array of object |
Appareils à regrouper par la salle. Les enfants suivants sont autorisés : « appareil ». |
|
débarrasser
|
data.children.rid | string |
ID unique de la scène créée. |
|
rtype
|
data.children.rtype | string |
Type de la scène créée. |
|
Services groupés
|
data.grouped_services | array of object |
Références aux services de contrôle agrégés. Déconseillé : utilisez des services. |
|
débarrasser
|
data.grouped_services.rid | string |
ID unique de la scène créée. |
|
rtype
|
data.grouped_services.rtype | string |
Type de la scène créée. |
|
Id
|
data.id | string |
Identificateur unique représentant une instance de ressource spécifique. |
|
ID v1
|
data.id_v1 | string |
Identificateur de ressource Clip v1 (à utiliser dans l’API v1). |
|
Archétype
|
data.metadata.archetype | string |
Archétype par défaut donné par le fabricant. |
|
Nom
|
data.metadata.name | string |
Nom lisible par l’homme d’une ressource. |
|
Services
|
data.services | array of object |
Référence tous les services agrégeant le contrôle et l’état des enfants dans le groupe. L’agrégation est par type de service, c’est-à-dire chaque type de service qui peut être regroupé a une définition correspondante de type groupé. Types pris en charge : « light ». |
|
débarrasser
|
data.services.rid | string |
ID unique de la scène créée. |
|
rtype
|
data.services.rtype | string |
Type de la scène créée. |
|
Type
|
data.type | string |
Type des ressources prises en charge. |
Obtenir des scènes
Obtenez la liste de toutes les scènes. Les scènes sont utilisées pour stocker et rappeler les paramètres d’un groupe de lumières.
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Erreurs
|
errors | array of object |
Erreurs qui se sont produites pendant l’appel. |
|
Description de l’erreur
|
errors.description | string |
Explication lisible par l’homme propre à cette occurrence du problème. |
|
données
|
data | array of object |
Données. |
|
Actions
|
data.actions | array of object |
Liste des actions exécutées dans la scène. |
|
X
|
data.actions.action.color.xy.x | float |
Minimum : 0 - maximum : 1. Position X dans la gamme de couleurs. |
|
O
|
data.actions.action.color.xy.y | float |
Minimum : 0 - maximum : 1. Position Y dans la gamme de couleurs. |
|
Luminosité
|
data.actions.action.dimming.brightness | float |
Maximum : 100. Pourcentage de luminosité. L’écriture de 0 la modifie en luminosité la plus faible possible. |
|
Activées
|
data.actions.action.on.on | boolean |
État activé/désactivé de la lumière on=true, off=false. |
|
Mirek
|
data.actions.action.color_temperature.mirek | integer |
Minimum : 153 - maximum : 500. Température de couleur en mirek ou null lorsque la couleur claire n’est pas dans le spectre ct. |
|
débarrasser
|
data.actions.target.rid | string |
ID unique de la ressource référencée. |
|
rtype
|
data.actions.target.rtype | string |
Type de la ressource référencée. |
|
débarrasser
|
data.group.rid | string |
ID unique de la ressource référencée. |
|
rtype
|
data.group.rtype | string |
Type de la ressource référencée. |
|
Id
|
data.id | string |
Identificateur unique représentant une instance de ressource spécifique. |
|
ID v1
|
data.id_v1 | string |
Identificateur de ressource Clip v1 (à utiliser dans l’API v1). |
|
débarrasser
|
data.metadata.image.rid | string |
ID unique de la ressource référencée. |
|
rtype
|
data.metadata.image.rtype | string |
Type de la ressource référencée. |
|
Nom
|
data.metadata.name | string |
Nom lisible par l’homme d’une ressource. |
|
Color
|
data.palette.color | array of object | |
|
X
|
data.palette.color.color.xy.x | float |
Minimum : 0 - maximum : 1. Position X dans la gamme de couleurs. |
|
O
|
data.palette.color.color.xy.y | float |
Minimum : 0 - maximum : 1. Position Y dans la gamme de couleurs. |
|
Luminosité
|
data.palette.color.dimming.brightness | float |
Maximum : 100. Pourcentage de luminosité. L’écriture de 0 la modifie en luminosité la plus faible possible. |
|
Température des couleurs
|
data.palette.color_temperature | array of object | |
|
Mirek
|
data.palette.color_temperature.color_temperature.mirek | integer |
Minimum : 153 - maximum : 500. Température de couleur en mirek ou null lorsque la couleur claire n’est pas dans le spectre ct. |
|
Luminosité
|
data.palette.color_temperature.dimming.brightness | float |
Maximum : 100. Pourcentage de luminosité. L’écriture de 0 la modifie en luminosité la plus faible possible. |
|
Gradation
|
data.palette.dimming | array of object | |
|
Luminosité
|
data.palette.dimming.brightness | float |
Maximum : 100. Pourcentage de luminosité. L’écriture de 0 la modifie en luminosité la plus faible possible. |
|
Vitesse
|
data.speed | float |
Vitesse de palette dynamique pour cette scène. |
|
Type
|
data.type | string |
Type des ressources prises en charge. |
Obtenir la lumière
Obtenez les détails d’un appareil spécifique ayant des fonctionnalités d’éclair.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’appareil
|
DeviceId | True | string |
ID d’un appareil pour afficher les détails. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Erreurs
|
errors | array of object |
Erreurs qui se sont produites pendant l’appel. |
|
Description de l’erreur
|
errors.description | string |
Explication lisible par l’homme propre à cette occurrence du problème. |
|
données
|
data | array of object |
Lumières correspondant à l’ID donné. |
|
Valeurs d’action
|
data.alert.action_values | array of string |
Liste des effets d’alerte pris en charge par la lumière. |
|
X bleu
|
data.color.gamut.blue.x | float |
Position X dans la gamme de couleurs. |
|
Y bleu
|
data.color.gamut.blue.y | float |
Position Y dans la gamme de couleurs. |
|
X vert
|
data.color.gamut.green.x | float |
Position X dans la gamme de couleurs. |
|
Y vert
|
data.color.gamut.green.y | float |
Position X dans la gamme de couleurs. |
|
X rouge
|
data.color.gamut.red.x | float |
Position X dans la gamme de couleurs. |
|
Y rouge
|
data.color.gamut.red.y | float |
Position X dans la gamme de couleurs. |
|
Type gamut
|
data.color.gamut_type | string |
Les types de gamuts pris en charge par hue : A - Gamut de produits de couleur Philips précoces, B - Gamme limitée de premiers produits de couleur Hue, C - Plus riche gamme de couleurs de produits d’ambiance de teinte blanche et couleur, autre - Gamut de couleurs de produits non-teintes. |
|
X
|
data.color.xy.x | float |
Position X dans la gamme de couleurs. |
|
O
|
data.color.xy.y | float |
Position Y dans la gamme de couleurs. |
|
Mirek
|
data.color_temperature.mirek | integer |
Température de couleur en mirek ou null lorsque la couleur claire n’est pas dans le spectre ct. |
|
Mirek maximum
|
data.color_temperature.mirek_schema.mirek_maximum | integer |
Température de couleur maximale prise en charge par cette lumière. |
|
Mirek minimum
|
data.color_temperature.mirek_schema.mirek_minimum | integer |
Température de couleur minimale prise en charge par cette lumière. |
|
Mirek valide
|
data.color_temperature.mirek_valid | boolean |
Indique si la valeur présentée dans mirek est valide. |
|
Luminosité
|
data.dimming.brightness | float |
Pourcentage de luminosité. la valeur ne peut pas être 0, en écrivant 0 la modification de la luminosité la plus faible possible. |
|
Niveau minimal dim
|
data.dimming.min_dim_level | float |
Pourcentage de la quantité maximale de sorties de l’appareil sur une luminosité minimale. |
|
Vitesse
|
data.dynamics.speed | float |
Vitesse de palette dynamique ou d’effet. La vitesse est valide pour la palette dynamique si l’état est dynamic_palette ou pour l’effet correspondant répertorié dans l’état. En cas d’état aucun, la vitesse n’est pas valide. |
|
Vitesse valide
|
data.dynamics.speed_valid | boolean |
Indique si la valeur présentée en vitesse est valide. |
|
Statut
|
data.dynamics.status | string |
État actuel de la lampe avec dynamique. |
|
Valeurs d’état
|
data.dynamics.status_values | array of string |
États dans lesquels une lampe peut être lors de la lecture dynamique. |
|
ID de ressource
|
data.id | string |
Identificateur unique représentant une instance de ressource spécifique. |
|
Id de ressource clip v1
|
data.id_v1 | string |
Identificateur de ressource v1 (version de l’API v1). |
|
Archétype
|
data.metadata.archetype | string |
Archétype clair. Déconseillé : utilisez l’archétype au niveau de l’appareil. |
|
Nom donné de l’appareil
|
data.metadata.name | string |
Nom lisible par l’homme d’une ressource. |
|
Mode
|
data.mode | string |
L’un des éléments suivants : normal ou streaming. |
|
État clair
|
data.on.on | boolean |
État activé/désactivé de la lumière : on=true, off=false. |
|
RID
|
data.owner.rid | string |
ID unique de la ressource référencée. |
|
Rtype
|
data.owner.rtype | string |
Type de la ressource référencée. |
|
Type
|
data.type | string |
Type des ressources prises en charge. |
Obtenir un appareil
Obtenez les détails d’un appareil spécifique.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’appareil
|
DeviceId | True | string |
ID d’un appareil pour afficher les détails. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Erreurs
|
errors | array of object |
Erreurs qui se sont produites pendant l’appel. |
|
Description de l’erreur
|
errors.description | string |
Explication lisible par l’homme propre à cette occurrence du problème. |
|
données
|
data | array of object |
Appareils correspondant à l’ID donné. |
|
Id
|
data.id | string |
Identificateur unique représentant une instance de ressource spécifique. |
|
ID v1
|
data.id_v1 | string |
Identificateur de ressource Clip v1 (à utiliser dans l’API v1). |
|
Archétype
|
data.metadata.archetype | string |
Archétype par défaut donné par le fabricant. |
|
Nom
|
data.metadata.name | string |
Nom lisible par l’homme d’une ressource. |
|
Certifié
|
data.product_data.certified | boolean |
Cet appareil est certifié HUE. |
|
Nom du fabricant
|
data.product_data.manufacturer_name | string |
Nom du fabricant de l’appareil. |
|
ID de modèle
|
data.product_data.model_id | string |
identification unique du modèle d’appareil. |
|
Archétype de produit
|
data.product_data.product_archetype | string |
Archétype du produit. |
|
Nom du produit
|
data.product_data.product_name | string |
Nom du produit. |
|
Version du logiciel
|
data.product_data.software_version | string |
Version logicielle du produit. |
|
Services
|
data.services | array of object |
Référence tous les services agrégeant le contrôle et l’état des enfants dans le groupe. |
|
débarrasser
|
data.services.rid | string |
ID unique de la ressource référencée. |
|
rtype
|
data.services.rtype | string |
Type de la ressource référencée. |
|
Type
|
data.type | string |
Type de la ressource prise en charge. |
Obtenir une scène
Obtenez des détails sur une scène spécifique.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de scène
|
SceneId | True | string |
ID d’une scène pour afficher les détails. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Erreurs
|
errors | array of object |
Erreurs qui se sont produites pendant l’appel. |
|
Description de l’erreur
|
errors.description | string |
Explication lisible par l’homme propre à cette occurrence du problème. |
|
données
|
data | array of object |
Données. |
|
Actions
|
data.actions | array of object |
Liste des actions exécutées dans la scène. |
|
X
|
data.actions.action.color.xy.x | float |
Minimum : 0 - maximum : 1. Position X dans la gamme de couleurs. |
|
O
|
data.actions.action.color.xy.y | float |
Minimum : 0 - maximum : 1. Position Y dans la gamme de couleurs. |
|
Luminosité
|
data.actions.action.dimming.brightness | float |
Maximum : 100. Pourcentage de luminosité. L’écriture de 0 la modifie en luminosité la plus faible possible. |
|
Activées
|
data.actions.action.on.on | boolean |
État activé/désactivé de la lumière on=true, off=false. |
|
Mirek
|
data.actions.action.color_temperature.mirek | integer |
Minimum : 153 - maximum : 500. Température de couleur en mirek ou null lorsque la couleur claire n’est pas dans le spectre ct. |
|
débarrasser
|
data.actions.target.rid | string |
ID unique de la ressource référencée. |
|
rtype
|
data.actions.target.rtype | string |
Type de la ressource référencée. |
|
débarrasser
|
data.group.rid | string |
ID unique de la ressource référencée. |
|
rtype
|
data.group.rtype | string |
Type de la ressource référencée. |
|
Id
|
data.id | string |
Identificateur unique représentant une instance de ressource spécifique. |
|
ID v1
|
data.id_v1 | string |
Identificateur de ressource Clip v1 (à utiliser dans l’API v1). |
|
débarrasser
|
data.metadata.image.rid | string |
ID unique de la ressource référencée. |
|
rtype
|
data.metadata.image.rtype | string |
Type de la ressource référencée. |
|
Nom
|
data.metadata.name | string |
Nom lisible par l’homme d’une ressource. |
|
Color
|
data.palette.color | array of object | |
|
X
|
data.palette.color.color.xy.x | float |
Minimum : 0 - maximum : 1. Position X dans la gamme de couleurs. |
|
O
|
data.palette.color.color.xy.y | float |
Minimum : 0 - maximum : 1. Position Y dans la gamme de couleurs. |
|
Luminosité
|
data.palette.color.dimming.brightness | float |
Maximum : 100. Pourcentage de luminosité. L’écriture de 0 la modifie en luminosité la plus faible possible. |
|
Température des couleurs
|
data.palette.color_temperature | array of object | |
|
Mirek
|
data.palette.color_temperature.color_temperature.mirek | integer |
Minimum : 153 - maximum : 500. Température de couleur en mirek ou null lorsque la couleur claire n’est pas dans le spectre ct. |
|
Luminosité
|
data.palette.color_temperature.dimming.brightness | float |
Maximum : 100. Pourcentage de luminosité. L’écriture de 0 la modifie en luminosité la plus faible possible. |
|
Gradation
|
data.palette.dimming | array of object | |
|
Luminosité
|
data.palette.dimming.brightness | float |
Maximum : 100. Pourcentage de luminosité. L’écriture de 0 la modifie en luminosité la plus faible possible. |
|
Vitesse
|
data.speed | float |
Vitesse de palette dynamique pour cette scène. |
|
Type
|
data.type | string |
Type des ressources prises en charge. |
Supprimer la scène
Supprimez une scène spécifique.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de scène
|
SceneId | True | string |
ID d’une scène à supprimer. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
données
|
data | array of object |
Mises à jour des scènes. |
|
débarrasser
|
data.rid | string |
ID unique de la scène supprimée. |
|
rtype
|
data.rtype | string |
Type de la scène supprimée. |
|
Erreurs
|
errors | array of object |
Erreurs qui se sont produites pendant l’appel. |
|
Description de l’erreur
|
errors.description | string |
Explication lisible par l’homme propre à cette occurrence du problème. |