Philips HUE (Unabhängiger Herausgeber)
Philips HUE ermöglicht es Ihnen, intelligente Heimgeräte wie Lichter, Schalter, Stecker und mehr von Philips gebaut zu steuern.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Tomasz Poszytek |
| URL | https://aka.ms/poszytek |
| tomasz@poszytek.eu |
| Connectormetadaten | |
|---|---|
| Herausgeber | Tomasz Poszytek |
| Webseite | https://www.philips-hue.com/ |
| Datenschutzrichtlinie | https://www.philips-hue.com/en-us/support/legal/privacy-policy |
| Kategorien | Internet der Dinge; Lifestyle und Unterhaltung |
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| HUE-Anwendungsschlüssel | securestring | Der API-Schlüssel, der nach dem Ausführen von PUT- und POST-Autorisierungsaufrufen zurückgegeben wird. | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abrufen von Räumen |
Liste der Räume abrufen (Gruppen). |
| Gerät abrufen |
Rufen Sie Details zu einem bestimmten Gerät ab. |
| Gerät ausführen |
Führen Sie ein bestimmtes Gerät aus. |
| Geräte abrufen |
Dient zum Abrufen einer Liste aller Geräte. |
| Licht abrufen |
Rufen Sie Details zu einem bestimmten Gerät mit Blitzfunktionen ab. |
| Licht ausführen |
Führen Sie das Gerät mit Blitzfunktionen aus. |
| Lichter abrufen |
Rufen Sie eine Liste Ihrer Geräte mit Blitzfunktionen ab. |
| Szene abrufen |
Rufen Sie Details einer bestimmten Szene ab. |
| Szene löschen |
Löschen Sie eine bestimmte Szene. |
| Szenen abrufen |
Dient zum Abrufen einer Liste aller Szenen. Szenen werden verwendet, um Einstellungen für eine Gruppe von Lichtern zu speichern und zurückzurufen. |
Abrufen von Räumen
Liste der Räume abrufen (Gruppen).
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Irrtümer
|
errors | array of object |
Fehler, die während des Anrufs aufgetreten sind. |
|
Fehlerbeschreibung
|
errors.description | string |
Eine menschlichen lesbare Erklärung, die für dieses Auftreten des Problems spezifisch ist. |
|
Daten
|
data | array of object |
Daten. |
|
Children
|
data.children | array of object |
Geräte, die nach dem Raum gruppiert werden sollen. Folgende untergeordnete Elemente sind zulässig: "Gerät". |
|
los
|
data.children.rid | string |
Die eindeutige ID der erstellten Szene. |
|
rtype
|
data.children.rtype | string |
Der Typ der erstellten Szene. |
|
Gruppierte Dienste
|
data.grouped_services | array of object |
Verweise auf aggregierte Steuerelementdienste. Veraltet: Dienste verwenden. |
|
los
|
data.grouped_services.rid | string |
Die eindeutige ID der erstellten Szene. |
|
rtype
|
data.grouped_services.rtype | string |
Der Typ der erstellten Szene. |
|
Id
|
data.id | string |
Eindeutiger Bezeichner, der eine bestimmte Ressourceninstanz darstellt. |
|
ID v1
|
data.id_v1 | string |
Clip v1-Ressourcenbezeichner (zur Verwendung in API v1). |
|
Archetyp
|
data.metadata.archetype | string |
Standardmäßiger Archetyp, der vom Hersteller angegeben wird. |
|
Name
|
data.metadata.name | string |
Lesbarer Name einer Ressource. |
|
Dienste
|
data.services | array of object |
Verweist auf alle Dienste, die steuerelemente und den Status untergeordneter Elemente in der Gruppe aggregieren. Aggregation ist pro Diensttyp, d. h. jeder Diensttyp, der gruppiert werden kann, verfügt über eine entsprechende Definition des gruppierten Typs. Unterstützte Typen: "light". |
|
los
|
data.services.rid | string |
Die eindeutige ID der erstellten Szene. |
|
rtype
|
data.services.rtype | string |
Der Typ der erstellten Szene. |
|
Typ
|
data.type | string |
Typ der unterstützten Ressourcen. |
Gerät abrufen
Rufen Sie Details zu einem bestimmten Gerät ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Geräte-ID
|
DeviceId | True | string |
ID eines Geräts zum Anzeigen von Details. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Irrtümer
|
errors | array of object |
Fehler, die während des Anrufs aufgetreten sind. |
|
Fehlerbeschreibung
|
errors.description | string |
Eine menschlichen lesbare Erklärung, die für dieses Auftreten des Problems spezifisch ist. |
|
Daten
|
data | array of object |
Geräte, die mit der angegebenen ID übereinstimmen. |
|
Id
|
data.id | string |
Eindeutiger Bezeichner, der eine bestimmte Ressourceninstanz darstellt. |
|
ID v1
|
data.id_v1 | string |
Clip v1-Ressourcenbezeichner (zur Verwendung in API v1). |
|
Archetyp
|
data.metadata.archetype | string |
Standardmäßiger Archetyp, der vom Hersteller angegeben wird. |
|
Name
|
data.metadata.name | string |
Lesbarer Name einer Ressource. |
|
Beglaubigt
|
data.product_data.certified | boolean |
Dieses Gerät ist HUE zertifiziert. |
|
Herstellername
|
data.product_data.manufacturer_name | string |
Name des Geräteherstellers. |
|
Modell-ID
|
data.product_data.model_id | string |
eindeutige Identifikation des Gerätemodells. |
|
Produkt-Archetyp
|
data.product_data.product_archetype | string |
Archetyp des Produkts. |
|
Produktname
|
data.product_data.product_name | string |
Name des Produkts. |
|
Softwareversion
|
data.product_data.software_version | string |
Softwareversion des Produkts. |
|
Dienste
|
data.services | array of object |
Verweist auf alle Dienste, die steuerelemente und den Status untergeordneter Elemente in der Gruppe aggregieren. |
|
los
|
data.services.rid | string |
Die eindeutige ID der referenzierten Ressource. |
|
rtype
|
data.services.rtype | string |
Der Typ der Ressource, auf die verwiesen wird. |
|
Typ
|
data.type | string |
Typ der unterstützten Ressource. |
Gerät ausführen
Führen Sie ein bestimmtes Gerät aus.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Geräte-ID
|
DeviceId | True | string |
ID eines Geräts zum Aktualisieren von Metadaten. |
|
Archetyp
|
archetype | string |
Standardmäßig vom Hersteller gegebener Archetyp. |
|
|
Name
|
name | string |
Lesbarer Name einer Ressource (max. 32 Zeichen). |
|
|
Maßnahme
|
action | string |
Geben Sie "identifizieren" ein, um die Identifizierung auszulösen. Bridge führt Zigbee LED-Identifikationszyklen für 5 Sekunden durch. Lichter führen einen Atmenzyklus durch. Sensoren führen LED-Identifikationszyklen für 15 Sekunden durch. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Daten
|
data | array of object |
Aktualisierte Geräte. |
|
los
|
data.rid | string |
Die eindeutige ID der referenzierten Ressource. |
|
rtype
|
data.rtype | string |
Der Typ der Ressource, auf die verwiesen wird. |
|
Irrtümer
|
errors | array of object |
Fehler, die während des Anrufs aufgetreten sind. |
|
Fehlerbeschreibung
|
errors.description | string |
Eine menschlichen lesbare Erklärung, die für dieses Auftreten des Problems spezifisch ist. |
Geräte abrufen
Dient zum Abrufen einer Liste aller Geräte.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Irrtümer
|
errors | array of object |
Fehler, die während des Anrufs aufgetreten sind. |
|
Fehlerbeschreibung
|
errors.description | string |
Eine menschlichen lesbare Erklärung, die für dieses Auftreten des Problems spezifisch ist. |
|
Daten
|
data | array of object |
Benutzergeräte. |
|
Id
|
data.id | string |
Eindeutiger Bezeichner, der eine bestimmte Ressourceninstanz darstellt. |
|
ID v1
|
data.id_v1 | string |
Clip v1-Ressourcenbezeichner (zur Verwendung in API v1). |
|
Archetyp
|
data.metadata.archetype | string |
Standardmäßiger Archetyp, der vom Hersteller angegeben wird. |
|
Name
|
data.metadata.name | string |
Lesbarer Name einer Ressource. |
|
Beglaubigt
|
data.product_data.certified | boolean |
Dieses Gerät ist HUE zertifiziert. |
|
Herstellername
|
data.product_data.manufacturer_name | string |
Name des Geräteherstellers. |
|
Modell-ID
|
data.product_data.model_id | string |
eindeutige Identifikation des Gerätemodells. |
|
Produkt-Archetyp
|
data.product_data.product_archetype | string |
Archetyp des Produkts. |
|
Produktname
|
data.product_data.product_name | string |
Name des Produkts. |
|
Softwareversion
|
data.product_data.software_version | string |
Softwareversion des Produkts. |
|
Dienste
|
data.services | array of object |
Verweist auf alle Dienste, die steuerelemente und den Status untergeordneter Elemente in der Gruppe aggregieren. |
|
los
|
data.services.rid | string |
Die eindeutige ID der referenzierten Ressource. |
|
rtype
|
data.services.rtype | string |
Der Typ der Ressource, auf die verwiesen wird. |
|
Typ
|
data.type | string |
Typ der unterstützten Ressource. |
Licht abrufen
Rufen Sie Details zu einem bestimmten Gerät mit Blitzfunktionen ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Geräte-ID
|
DeviceId | True | string |
ID eines Geräts zum Anzeigen von Details. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Irrtümer
|
errors | array of object |
Fehler, die während des Anrufs aufgetreten sind. |
|
Fehlerbeschreibung
|
errors.description | string |
Eine menschlichen lesbare Erklärung, die für dieses Auftreten des Problems spezifisch ist. |
|
Daten
|
data | array of object |
Leuchten, die mit der angegebenen ID übereinstimmen. |
|
Aktionswerte
|
data.alert.action_values | array of string |
Liste der Warnungseffekte, die das Licht unterstützt. |
|
Blaues X
|
data.color.gamut.blue.x | float |
X-Position im Farbskala. |
|
Blau Y
|
data.color.gamut.blue.y | float |
Y-Position im Farbskala. |
|
Grünes X
|
data.color.gamut.green.x | float |
X-Position im Farbskala. |
|
Grün Y
|
data.color.gamut.green.y | float |
X-Position im Farbskala. |
|
Rotes X
|
data.color.gamut.red.x | float |
X-Position im Farbskala. |
|
Rot Y
|
data.color.gamut.red.y | float |
X-Position im Farbskala. |
|
Gamut-Typ
|
data.color.gamut_type | string |
Die von Farbton unterstützten Gamuttypen: A - Gamut von frühen Philips Farb-only-Produkten, B - Begrenzte Farbskala der ersten Farbprodukte, C - Reichhaltigere Farbskala von Farbtonweiß- und Farbatmosphäreprodukten, andere - Farbskala von Nicht-Farbprodukten. |
|
X
|
data.color.xy.x | float |
X-Position im Farbskala. |
|
J
|
data.color.xy.y | float |
Y-Position im Farbskala. |
|
Mirek
|
data.color_temperature.mirek | integer |
Farbtemperatur in Mirek oder Null, wenn sich die Lichtfarbe nicht im Ct-Spektrum befindet. |
|
Mirek maximum
|
data.color_temperature.mirek_schema.mirek_maximum | integer |
Maximale Farbtemperatur dieses Lichts. |
|
Mirek Minimum
|
data.color_temperature.mirek_schema.mirek_minimum | integer |
Mindestfarbtemperatur dieses Lichts. |
|
Mirek gültig
|
data.color_temperature.mirek_valid | boolean |
Gibt an, ob der in Mirek dargestellte Wert gültig ist. |
|
Helligkeit
|
data.dimming.brightness | float |
Helligkeitsprozentsatz. Der Wert darf nicht 0 sein, 0 ändert es in die niedrigste mögliche Helligkeit. |
|
Min dim level
|
data.dimming.min_dim_level | float |
Prozentsatz des maximalen Lumens, den das Gerät bei minimaler Helligkeit ausgibt. |
|
Speed
|
data.dynamics.speed | float |
Geschwindigkeit der dynamischen Palette oder des Effekts. Die Geschwindigkeit ist gültig für die dynamische Palette, wenn der Status dynamic_palette oder für den entsprechenden Effekt ist, der im Status aufgeführt ist. Bei status none ist die Geschwindigkeit ungültig. |
|
Geschwindigkeit gültig
|
data.dynamics.speed_valid | boolean |
Gibt an, ob der in Geschwindigkeit dargestellte Wert gültig ist. |
|
Der Status
|
data.dynamics.status | string |
Aktueller Status der Leuchte mit Dynamik. |
|
Statuswerte
|
data.dynamics.status_values | array of string |
Statuses, in denen eine Leuchte beim Spielen von Dynamik sein könnte. |
|
Ressourcen-ID
|
data.id | string |
Eindeutiger Bezeichner, der eine bestimmte Ressourceninstanz darstellt. |
|
Clip v1-Ressourcen-ID
|
data.id_v1 | string |
Clip v1-Ressourcenbezeichner (v1 API-Version). |
|
Archetyp
|
data.metadata.archetype | string |
Lichtbogen. Veraltet: Verwenden Sie den Archetyp auf Geräteebene. |
|
Gerätename
|
data.metadata.name | string |
Lesbarer Name einer Ressource. |
|
Modus
|
data.mode | string |
Eine von: normal oder Streaming. |
|
Lichtzustand
|
data.on.on | boolean |
Ein/Aus-Zustand des Lichts: on=true, off=false. |
|
RID
|
data.owner.rid | string |
Die eindeutige ID der referenzierten Ressource. |
|
Rtype
|
data.owner.rtype | string |
Der Typ der Ressource, auf die verwiesen wird. |
|
Typ
|
data.type | string |
Typ der unterstützten Ressourcen. |
Licht ausführen
Führen Sie das Gerät mit Blitzfunktionen aus.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Geräte-ID
|
DeviceId | True | string |
ID eines Geräts zum Aktualisieren von Eigenschaften. |
|
Name
|
name | string |
MinLength: 1 - maxLength: 32. Lesbarer Name einer Ressource. |
|
|
Ein
|
on | boolean |
"Ein/Aus"-Zustand des Lichts "on=true", "off=false". |
|
|
Helligkeit
|
brightness | float |
Maximal: 100. Helligkeitsprozentsatz. Durch das Schreiben von 0 wird sie auf die niedrigste mögliche Helligkeit geändert. |
|
|
Mirek
|
mirek | integer |
Minimum: 153 - maximum: 500. Farbtemperatur in Mirek oder Null, wenn sich die Lichtfarbe nicht im Ct-Spektrum befindet. |
|
|
X
|
x | float |
Minimum: 0 - maximum: 1. X-Position im Farbskala. |
|
|
J
|
y | float |
Minimum: 0 - maximum: 1. Y-Position im Farbskala. |
|
|
Speed
|
speed | float |
Minimum: 0 - maximum: 1. Geschwindigkeit der dynamischen Palette. Die Geschwindigkeit ist gültig für die dynamische Palette, wenn der Status dynamic_palette oder für den entsprechenden Effekt ist, der im Status aufgeführt ist. Bei status none ist die Geschwindigkeit ungültig. |
|
|
Dauer
|
duration | integer |
Maximum: 60000000. Dauer eines Lichtübergangs in ms. Genauigkeit ist in 100 ms Schritten. |
|
|
Maßnahme
|
action | string |
Eine der verfügbaren Aktionen, die auf einem Gerät ausgeführt werden sollen. D.h. "atmen". |
|
|
X
|
x | float |
Minimum: 0 - maximum: 1. X-Position im Farbskala. |
|
|
J
|
y | float |
Minimum: 0 - maximum: 1. Y-Position im Farbskala. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Daten
|
data | array of object |
Daten |
|
los
|
data.rid | string |
los |
|
rtype
|
data.rtype | string |
rtype |
|
Irrtümer
|
errors | array of object |
Fehler, die während des Anrufs aufgetreten sind. |
|
Fehlerbeschreibung
|
errors.description | string |
Eine menschlichen lesbare Erklärung, die für dieses Auftreten des Problems spezifisch ist. |
Lichter abrufen
Rufen Sie eine Liste Ihrer Geräte mit Blitzfunktionen ab.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Irrtümer
|
errors | array of object |
Fehler, die während des Anrufs aufgetreten sind. |
|
Fehlerbeschreibung
|
errors.description | string |
Eine menschlichen lesbare Erklärung, die für dieses Auftreten des Problems spezifisch ist. |
|
Daten
|
data | array of object |
Benutzerlichter. |
|
Aktionswerte
|
data.alert.action_values | array of string |
Liste der Warnungseffekte, die das Licht unterstützt. |
|
Blaues X
|
data.color.gamut.blue.x | float |
X-Position im Farbskala. |
|
Blau Y
|
data.color.gamut.blue.y | float |
Y-Position im Farbskala. |
|
Grünes X
|
data.color.gamut.green.x | float |
X-Position im Farbskala. |
|
Grün Y
|
data.color.gamut.green.y | float |
X-Position im Farbskala. |
|
Rotes X
|
data.color.gamut.red.x | float |
X-Position im Farbskala. |
|
Rot Y
|
data.color.gamut.red.y | float |
X-Position im Farbskala. |
|
Gamut-Typ
|
data.color.gamut_type | string |
Die von Farbton unterstützten Gamuttypen: A - Gamut von frühen Philips Farb-only-Produkten, B - Begrenzte Farbskala der ersten Farbprodukte, C - Reichhaltigere Farbskala von Farbtonweiß- und Farbatmosphäreprodukten, andere - Farbskala von Nicht-Farbprodukten. |
|
X
|
data.color.xy.x | float |
X-Position im Farbskala. |
|
J
|
data.color.xy.y | float |
Y-Position im Farbskala. |
|
Mirek
|
data.color_temperature.mirek | integer |
Farbtemperatur in Mirek oder Null, wenn sich die Lichtfarbe nicht im Ct-Spektrum befindet. |
|
Mirek maximum
|
data.color_temperature.mirek_schema.mirek_maximum | integer |
Maximale Farbtemperatur dieses Lichts. |
|
Mirek Minimum
|
data.color_temperature.mirek_schema.mirek_minimum | integer |
Mindestfarbtemperatur dieses Lichts. |
|
Mirek gültig
|
data.color_temperature.mirek_valid | boolean |
Gibt an, ob der in Mirek dargestellte Wert gültig ist. |
|
Helligkeit
|
data.dimming.brightness | float |
Helligkeitsprozentsatz. Der Wert darf nicht 0 sein, 0 ändert es in die niedrigste mögliche Helligkeit. |
|
Min dim level
|
data.dimming.min_dim_level | float |
Prozentsatz des maximalen Lumens, den das Gerät bei minimaler Helligkeit ausgibt. |
|
Speed
|
data.dynamics.speed | float |
Geschwindigkeit der dynamischen Palette oder des Effekts. Die Geschwindigkeit ist gültig für die dynamische Palette, wenn der Status dynamic_palette oder für den entsprechenden Effekt ist, der im Status aufgeführt ist. Bei status none ist die Geschwindigkeit ungültig. |
|
Geschwindigkeit gültig
|
data.dynamics.speed_valid | boolean |
Gibt an, ob der in Geschwindigkeit dargestellte Wert gültig ist. |
|
Der Status
|
data.dynamics.status | string |
Aktueller Status der Leuchte mit Dynamik. |
|
Statuswerte
|
data.dynamics.status_values | array of string |
Statuses, in denen eine Leuchte beim Spielen von Dynamik sein könnte. |
|
Ressourcen-ID
|
data.id | string |
Eindeutiger Bezeichner, der eine bestimmte Ressourceninstanz darstellt. |
|
Clip v1-Ressourcen-ID
|
data.id_v1 | string |
Clip v1-Ressourcenbezeichner (v1 API-Version). |
|
Archetyp
|
data.metadata.archetype | string |
Lichtbogen. Veraltet: Verwenden Sie den Archetyp auf Geräteebene. |
|
Gerätename
|
data.metadata.name | string |
Lesbarer Name einer Ressource. |
|
Modus
|
data.mode | string |
Eine von: normal oder Streaming. |
|
Lichtzustand
|
data.on.on | boolean |
Ein/Aus-Zustand des Lichts: on=true, off=false. |
|
RID
|
data.owner.rid | string |
Die eindeutige ID der referenzierten Ressource. |
|
Rtype
|
data.owner.rtype | string |
Der Typ der Ressource, auf die verwiesen wird. |
|
Typ
|
data.type | string |
Typ der unterstützten Ressourcen. |
Szene abrufen
Rufen Sie Details einer bestimmten Szene ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Szenen-ID
|
SceneId | True | string |
ID einer Szene zum Anzeigen von Details. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Irrtümer
|
errors | array of object |
Fehler, die während des Anrufs aufgetreten sind. |
|
Fehlerbeschreibung
|
errors.description | string |
Eine menschlichen lesbare Erklärung, die für dieses Auftreten des Problems spezifisch ist. |
|
Daten
|
data | array of object |
Daten. |
|
Aktionen
|
data.actions | array of object |
Liste der aktionen, die in szene ausgeführt werden. |
|
X
|
data.actions.action.color.xy.x | float |
Minimum: 0 - maximum: 1. X-Position im Farbskala. |
|
J
|
data.actions.action.color.xy.y | float |
Minimum: 0 - maximum: 1. Y-Position im Farbskala. |
|
Helligkeit
|
data.actions.action.dimming.brightness | float |
Maximal: 100. Helligkeitsprozentsatz. Durch das Schreiben von 0 wird sie auf die niedrigste mögliche Helligkeit geändert. |
|
Ein
|
data.actions.action.on.on | boolean |
"Ein/Aus"-Zustand des Lichts "on=true", "off=false". |
|
Mirek
|
data.actions.action.color_temperature.mirek | integer |
Minimum: 153 - maximum: 500. Farbtemperatur in Mirek oder Null, wenn sich die Lichtfarbe nicht im Ct-Spektrum befindet. |
|
los
|
data.actions.target.rid | string |
Die eindeutige ID der referenzierten Ressource. |
|
rtype
|
data.actions.target.rtype | string |
Der Typ der Ressource, auf die verwiesen wird. |
|
los
|
data.group.rid | string |
Die eindeutige ID der referenzierten Ressource. |
|
rtype
|
data.group.rtype | string |
Der Typ der Ressource, auf die verwiesen wird. |
|
Id
|
data.id | string |
Eindeutiger Bezeichner, der eine bestimmte Ressourceninstanz darstellt. |
|
ID v1
|
data.id_v1 | string |
Clip v1-Ressourcenbezeichner (zur Verwendung in API v1). |
|
los
|
data.metadata.image.rid | string |
Die eindeutige ID der referenzierten Ressource. |
|
rtype
|
data.metadata.image.rtype | string |
Der Typ der Ressource, auf die verwiesen wird. |
|
Name
|
data.metadata.name | string |
Lesbarer Name einer Ressource. |
|
Farbe
|
data.palette.color | array of object | |
|
X
|
data.palette.color.color.xy.x | float |
Minimum: 0 - maximum: 1. X-Position im Farbskala. |
|
J
|
data.palette.color.color.xy.y | float |
Minimum: 0 - maximum: 1. Y-Position im Farbskala. |
|
Helligkeit
|
data.palette.color.dimming.brightness | float |
Maximal: 100. Helligkeitsprozentsatz. Durch das Schreiben von 0 wird sie auf die niedrigste mögliche Helligkeit geändert. |
|
Farbtemperatur
|
data.palette.color_temperature | array of object | |
|
Mirek
|
data.palette.color_temperature.color_temperature.mirek | integer |
Minimum: 153 - maximum: 500. Farbtemperatur in Mirek oder Null, wenn sich die Lichtfarbe nicht im Ct-Spektrum befindet. |
|
Helligkeit
|
data.palette.color_temperature.dimming.brightness | float |
Maximal: 100. Helligkeitsprozentsatz. Durch das Schreiben von 0 wird sie auf die niedrigste mögliche Helligkeit geändert. |
|
Verdunkelnd
|
data.palette.dimming | array of object | |
|
Helligkeit
|
data.palette.dimming.brightness | float |
Maximal: 100. Helligkeitsprozentsatz. Durch das Schreiben von 0 wird sie auf die niedrigste mögliche Helligkeit geändert. |
|
Speed
|
data.speed | float |
Geschwindigkeit der dynamischen Palette für diese Szene. |
|
Typ
|
data.type | string |
Typ der unterstützten Ressourcen. |
Szene löschen
Löschen Sie eine bestimmte Szene.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Szenen-ID
|
SceneId | True | string |
ID einer zu löschenden Szene. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Daten
|
data | array of object |
Aktualisierte Szenen. |
|
los
|
data.rid | string |
Die eindeutige ID der gelöschten Szene. |
|
rtype
|
data.rtype | string |
Der Typ der gelöschten Szene. |
|
Irrtümer
|
errors | array of object |
Fehler, die während des Anrufs aufgetreten sind. |
|
Fehlerbeschreibung
|
errors.description | string |
Eine menschlichen lesbare Erklärung, die für dieses Auftreten des Problems spezifisch ist. |
Szenen abrufen
Dient zum Abrufen einer Liste aller Szenen. Szenen werden verwendet, um Einstellungen für eine Gruppe von Lichtern zu speichern und zurückzurufen.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Irrtümer
|
errors | array of object |
Fehler, die während des Anrufs aufgetreten sind. |
|
Fehlerbeschreibung
|
errors.description | string |
Eine menschlichen lesbare Erklärung, die für dieses Auftreten des Problems spezifisch ist. |
|
Daten
|
data | array of object |
Daten. |
|
Aktionen
|
data.actions | array of object |
Liste der aktionen, die in szene ausgeführt werden. |
|
X
|
data.actions.action.color.xy.x | float |
Minimum: 0 - maximum: 1. X-Position im Farbskala. |
|
J
|
data.actions.action.color.xy.y | float |
Minimum: 0 - maximum: 1. Y-Position im Farbskala. |
|
Helligkeit
|
data.actions.action.dimming.brightness | float |
Maximal: 100. Helligkeitsprozentsatz. Durch das Schreiben von 0 wird sie auf die niedrigste mögliche Helligkeit geändert. |
|
Ein
|
data.actions.action.on.on | boolean |
"Ein/Aus"-Zustand des Lichts "on=true", "off=false". |
|
Mirek
|
data.actions.action.color_temperature.mirek | integer |
Minimum: 153 - maximum: 500. Farbtemperatur in Mirek oder Null, wenn sich die Lichtfarbe nicht im Ct-Spektrum befindet. |
|
los
|
data.actions.target.rid | string |
Die eindeutige ID der referenzierten Ressource. |
|
rtype
|
data.actions.target.rtype | string |
Der Typ der Ressource, auf die verwiesen wird. |
|
los
|
data.group.rid | string |
Die eindeutige ID der referenzierten Ressource. |
|
rtype
|
data.group.rtype | string |
Der Typ der Ressource, auf die verwiesen wird. |
|
Id
|
data.id | string |
Eindeutiger Bezeichner, der eine bestimmte Ressourceninstanz darstellt. |
|
ID v1
|
data.id_v1 | string |
Clip v1-Ressourcenbezeichner (zur Verwendung in API v1). |
|
los
|
data.metadata.image.rid | string |
Die eindeutige ID der referenzierten Ressource. |
|
rtype
|
data.metadata.image.rtype | string |
Der Typ der Ressource, auf die verwiesen wird. |
|
Name
|
data.metadata.name | string |
Lesbarer Name einer Ressource. |
|
Farbe
|
data.palette.color | array of object | |
|
X
|
data.palette.color.color.xy.x | float |
Minimum: 0 - maximum: 1. X-Position im Farbskala. |
|
J
|
data.palette.color.color.xy.y | float |
Minimum: 0 - maximum: 1. Y-Position im Farbskala. |
|
Helligkeit
|
data.palette.color.dimming.brightness | float |
Maximal: 100. Helligkeitsprozentsatz. Durch das Schreiben von 0 wird sie auf die niedrigste mögliche Helligkeit geändert. |
|
Farbtemperatur
|
data.palette.color_temperature | array of object | |
|
Mirek
|
data.palette.color_temperature.color_temperature.mirek | integer |
Minimum: 153 - maximum: 500. Farbtemperatur in Mirek oder Null, wenn sich die Lichtfarbe nicht im Ct-Spektrum befindet. |
|
Helligkeit
|
data.palette.color_temperature.dimming.brightness | float |
Maximal: 100. Helligkeitsprozentsatz. Durch das Schreiben von 0 wird sie auf die niedrigste mögliche Helligkeit geändert. |
|
Verdunkelnd
|
data.palette.dimming | array of object | |
|
Helligkeit
|
data.palette.dimming.brightness | float |
Maximal: 100. Helligkeitsprozentsatz. Durch das Schreiben von 0 wird sie auf die niedrigste mögliche Helligkeit geändert. |
|
Speed
|
data.speed | float |
Geschwindigkeit der dynamischen Palette für diese Szene. |
|
Typ
|
data.type | string |
Typ der unterstützten Ressourcen. |