Udostępnij przez

Philips HUE (niezależny wydawca)

Philips HUE umożliwia sterowanie inteligentnymi urządzeniami domowymi, takimi jak światła, przełączniki, wtyczki i więcej zbudowanych przez Philipsa.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Tomasz Poszytek
adres URL https://aka.ms/poszytek
Email tomasz@poszytek.eu
Metadane łącznika
Publisher Tomasz Poszytek
Witryna internetowa https://www.philips-hue.com/
Zasady ochrony prywatności https://www.philips-hue.com/en-us/support/legal/privacy-policy
Kategorie Internet rzeczy; Styl życia i rozrywka

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:
Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: Wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja Power App zostanie udostępniona innemu użytkownikowi, inny użytkownik zostanie poproszony o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
Klucz aplikacji HUE securestring Klucz interfejsu API zwracany po wykonaniu wywołań autoryzacji PUT i POST. Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Pobieranie pomieszczeń

Pobierz listę pomieszczeń (grup).
Pobieranie scen

Pobierz listę wszystkich scen. Sceny są używane do przechowywania i odwoływania ustawień dla grupy świateł.
Pobieranie sceny

Uzyskaj szczegółowe informacje o określonej scenie.
Pobieranie urządzenia

Uzyskaj szczegółowe informacje o określonym urządzeniu.
Pobieranie urządzeń

Pobierz listę wszystkich urządzeń.
Usuwanie sceny

Usuń określoną scenę.
Uzyskiwanie świateł

Pobierz listę urządzeń z możliwościami błyskawic.
Uzyskiwanie światła

Uzyskaj szczegółowe informacje o konkretnym urządzeniu z możliwościami błyskawic.
Wykonywanie urządzenia

Wykonaj określone urządzenie.
Wykonywanie światła

Wykonywanie urządzenia z możliwościami błyskawic.

Pobieranie pomieszczeń

Identyfikator operacji:
GetRooms

Pobierz listę pomieszczeń (grup).

Zwraca

Nazwa Ścieżka Typ Opis
Błędy
 errors array of object

Błędy, które wystąpiły podczas wywołania.
Opis błędu
 errors.description string

Czytelne dla człowieka wyjaśnienie specyficzne dla tego wystąpienia problemu.
dane
 data array of object

Dane.
Elementy podrzędne
 data.children array of object

Urządzenia do grupowania według pokoju. Dozwolone są następujące elementy podrzędne: "urządzenie".
Rid
 data.children.rid string

Unikatowy identyfikator utworzonej sceny.
rtype
 data.children.rtype string

Typ utworzonej sceny.
Usługi grupowane
 data.grouped_services array of object

Odwołania do zagregowanych usług kontroli. Przestarzałe: użyj usług.
Rid
 data.grouped_services.rid string

Unikatowy identyfikator utworzonej sceny.
rtype
 data.grouped_services.rtype string

Typ utworzonej sceny.
Id
 data.id string

Unikatowy identyfikator reprezentujący określone wystąpienie zasobu.
Identyfikator v1
 data.id_v1 string

Clip v1 identyfikator zasobu (do użycia w interfejsie API w wersji 1).
Archetyp
 data.metadata.archetype string

Domyślny archetyp podany przez producenta.
Name
 data.metadata.name string

Czytelna dla człowieka nazwa zasobu.
Services
 data.services array of object

Odwołuje się do wszystkich usług agregujących kontrolkę i stan elementów podrzędnych w grupie. Agregacja to typ usługi, tj. każdy typ usługi, który można zgrupować, ma odpowiednią definicję typu zgrupowanego. Obsługiwane typy: "jasny".
Rid
 data.services.rid string

Unikatowy identyfikator utworzonej sceny.
rtype
 data.services.rtype string

Typ utworzonej sceny.
Typ
 data.type string

Typ obsługiwanych zasobów.

Pobieranie scen

Identyfikator operacji:
GetScenes

Pobierz listę wszystkich scen. Sceny są używane do przechowywania i odwoływania ustawień dla grupy świateł.

Zwraca

Nazwa Ścieżka Typ Opis
Błędy
 errors array of object

Błędy, które wystąpiły podczas wywołania.
Opis błędu
 errors.description string

Czytelne dla człowieka wyjaśnienie specyficzne dla tego wystąpienia problemu.
dane
 data array of object

Dane.
Czynności
 data.actions array of object

Lista akcji wykonywanych w scenie.
X
 data.actions.action.color.xy.x float

Minimum: 0 - maksimum: 1. Pozycja X w gamie kolorów.
Y
 data.actions.action.color.xy.y float

Minimum: 0 - maksimum: 1. Pozycja Y w gamie kolorów.
Jasność
 data.actions.action.dimming.brightness float

Maksimum: 100. Procent jasności. Zapis 0 zmienia się na najniższą możliwą jasność.
On
 data.actions.action.on.on boolean

On/Off stanu światła on=true, off=false.
Mirek
 data.actions.action.color_temperature.mirek integer

Minimum: 153 — maksimum: 500. Temperatura koloru w mirek lub null, gdy kolor światła nie znajduje się w spektrum ct.
Rid
 data.actions.target.rid string

Unikatowy identyfikator przywoływnego zasobu.
rtype
 data.actions.target.rtype string

Typ przywoływnego zasobu.
Rid
 data.group.rid string

Unikatowy identyfikator przywoływnego zasobu.
rtype
 data.group.rtype string

Typ przywoływnego zasobu.
Id
 data.id string

Unikatowy identyfikator reprezentujący określone wystąpienie zasobu.
Identyfikator v1
 data.id_v1 string

Clip v1 identyfikator zasobu (do użycia w interfejsie API w wersji 1).
Rid
 data.metadata.image.rid string

Unikatowy identyfikator przywoływnego zasobu.
rtype
 data.metadata.image.rtype string

Typ przywoływnego zasobu.
Name
 data.metadata.name string

Czytelna dla człowieka nazwa zasobu.
Kolor
 data.palette.color array of object
X
 data.palette.color.color.xy.x float

Minimum: 0 - maksimum: 1. Pozycja X w gamie kolorów.
Y
 data.palette.color.color.xy.y float

Minimum: 0 - maksimum: 1. Pozycja Y w gamie kolorów.
Jasność
 data.palette.color.dimming.brightness float

Maksimum: 100. Procent jasności. Zapis 0 zmienia się na najniższą możliwą jasność.
Temperatura koloru
 data.palette.color_temperature array of object
Mirek
 data.palette.color_temperature.color_temperature.mirek integer

Minimum: 153 — maksimum: 500. Temperatura koloru w mirek lub null, gdy kolor światła nie znajduje się w spektrum ct.
Jasność
 data.palette.color_temperature.dimming.brightness float

Maksimum: 100. Procent jasności. Zapis 0 zmienia się na najniższą możliwą jasność.
Ściemniania
 data.palette.dimming array of object
Jasność
 data.palette.dimming.brightness float

Maksimum: 100. Procent jasności. Zapis 0 zmienia się na najniższą możliwą jasność.
Szybkość
 data.speed float

Szybkość dynamicznej palety dla tej sceny.
Typ
 data.type string

Typ obsługiwanych zasobów.

Pobieranie sceny

Identyfikator operacji:
GetScene

Uzyskaj szczegółowe informacje o określonej scenie.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator sceny
 SceneId True string

Identyfikator sceny do wyświetlenia szczegółów.

Zwraca

Nazwa Ścieżka Typ Opis
Błędy
 errors array of object

Błędy, które wystąpiły podczas wywołania.
Opis błędu
 errors.description string

Czytelne dla człowieka wyjaśnienie specyficzne dla tego wystąpienia problemu.
dane
 data array of object

Dane.
Czynności
 data.actions array of object

Lista akcji wykonywanych w scenie.
X
 data.actions.action.color.xy.x float

Minimum: 0 - maksimum: 1. Pozycja X w gamie kolorów.
Y
 data.actions.action.color.xy.y float

Minimum: 0 - maksimum: 1. Pozycja Y w gamie kolorów.
Jasność
 data.actions.action.dimming.brightness float

Maksimum: 100. Procent jasności. Zapis 0 zmienia się na najniższą możliwą jasność.
On
 data.actions.action.on.on boolean

On/Off stanu światła on=true, off=false.
Mirek
 data.actions.action.color_temperature.mirek integer

Minimum: 153 — maksimum: 500. Temperatura koloru w mirek lub null, gdy kolor światła nie znajduje się w spektrum ct.
Rid
 data.actions.target.rid string

Unikatowy identyfikator przywoływnego zasobu.
rtype
 data.actions.target.rtype string

Typ przywoływnego zasobu.
Rid
 data.group.rid string

Unikatowy identyfikator przywoływnego zasobu.
rtype
 data.group.rtype string

Typ przywoływnego zasobu.
Id
 data.id string

Unikatowy identyfikator reprezentujący określone wystąpienie zasobu.
Identyfikator v1
 data.id_v1 string

Clip v1 identyfikator zasobu (do użycia w interfejsie API w wersji 1).
Rid
 data.metadata.image.rid string

Unikatowy identyfikator przywoływnego zasobu.
rtype
 data.metadata.image.rtype string

Typ przywoływnego zasobu.
Name
 data.metadata.name string

Czytelna dla człowieka nazwa zasobu.
Kolor
 data.palette.color array of object
X
 data.palette.color.color.xy.x float

Minimum: 0 - maksimum: 1. Pozycja X w gamie kolorów.
Y
 data.palette.color.color.xy.y float

Minimum: 0 - maksimum: 1. Pozycja Y w gamie kolorów.
Jasność
 data.palette.color.dimming.brightness float

Maksimum: 100. Procent jasności. Zapis 0 zmienia się na najniższą możliwą jasność.
Temperatura koloru
 data.palette.color_temperature array of object
Mirek
 data.palette.color_temperature.color_temperature.mirek integer

Minimum: 153 — maksimum: 500. Temperatura koloru w mirek lub null, gdy kolor światła nie znajduje się w spektrum ct.
Jasność
 data.palette.color_temperature.dimming.brightness float

Maksimum: 100. Procent jasności. Zapis 0 zmienia się na najniższą możliwą jasność.
Ściemniania
 data.palette.dimming array of object
Jasność
 data.palette.dimming.brightness float

Maksimum: 100. Procent jasności. Zapis 0 zmienia się na najniższą możliwą jasność.
Szybkość
 data.speed float

Szybkość dynamicznej palety dla tej sceny.
Typ
 data.type string

Typ obsługiwanych zasobów.

Pobieranie urządzenia

Identyfikator operacji:
GetDevice

Uzyskaj szczegółowe informacje o określonym urządzeniu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator urządzenia
 DeviceId True string

Identyfikator urządzenia do wyświetlania szczegółów.

Zwraca

Nazwa Ścieżka Typ Opis
Błędy
 errors array of object

Błędy, które wystąpiły podczas wywołania.
Opis błędu
 errors.description string

Czytelne dla człowieka wyjaśnienie specyficzne dla tego wystąpienia problemu.
dane
 data array of object

Urządzenia pasujące do danego identyfikatora.
Id
 data.id string

Unikatowy identyfikator reprezentujący określone wystąpienie zasobu.
Identyfikator v1
 data.id_v1 string

Clip v1 identyfikator zasobu (do użycia w interfejsie API w wersji 1).
Archetyp
 data.metadata.archetype string

Domyślny archetyp podany przez producenta.
Name
 data.metadata.name string

Czytelna dla człowieka nazwa zasobu.
Certyfikowane
 data.product_data.certified boolean

To urządzenie jest certyfikowane przez hue.
Nazwa producenta
 data.product_data.manufacturer_name string

Nazwa producenta urządzenia.
Identyfikator modelu
 data.product_data.model_id string

unikatowa identyfikacja modelu urządzenia.
Archetyp produktu
 data.product_data.product_archetype string

Archetyp produktu.
Nazwa produktu
 data.product_data.product_name string

Nazwa produktu.
Wersja oprogramowania
 data.product_data.software_version string

Wersja oprogramowania produktu.
Services
 data.services array of object

Odwołuje się do wszystkich usług agregujących kontrolkę i stan elementów podrzędnych w grupie.
Rid
 data.services.rid string

Unikatowy identyfikator przywoływnego zasobu.
rtype
 data.services.rtype string

Typ przywoływnego zasobu.
Typ
 data.type string

Typ obsługiwanego zasobu.

Pobieranie urządzeń

Identyfikator operacji:
GetDevices

Pobierz listę wszystkich urządzeń.

Zwraca

Nazwa Ścieżka Typ Opis
Błędy
 errors array of object

Błędy, które wystąpiły podczas wywołania.
Opis błędu
 errors.description string

Czytelne dla człowieka wyjaśnienie specyficzne dla tego wystąpienia problemu.
dane
 data array of object

Urządzenia użytkowników.
Id
 data.id string

Unikatowy identyfikator reprezentujący określone wystąpienie zasobu.
Identyfikator v1
 data.id_v1 string

Clip v1 identyfikator zasobu (do użycia w interfejsie API w wersji 1).
Archetyp
 data.metadata.archetype string

Domyślny archetyp podany przez producenta.
Name
 data.metadata.name string

Czytelna dla człowieka nazwa zasobu.
Certyfikowane
 data.product_data.certified boolean

To urządzenie jest certyfikowane przez hue.
Nazwa producenta
 data.product_data.manufacturer_name string

Nazwa producenta urządzenia.
Identyfikator modelu
 data.product_data.model_id string

unikatowa identyfikacja modelu urządzenia.
Archetyp produktu
 data.product_data.product_archetype string

Archetyp produktu.
Nazwa produktu
 data.product_data.product_name string

Nazwa produktu.
Wersja oprogramowania
 data.product_data.software_version string

Wersja oprogramowania produktu.
Services
 data.services array of object

Odwołuje się do wszystkich usług agregujących kontrolkę i stan elementów podrzędnych w grupie.
Rid
 data.services.rid string

Unikatowy identyfikator przywoływnego zasobu.
rtype
 data.services.rtype string

Typ przywoływnego zasobu.
Typ
 data.type string

Typ obsługiwanego zasobu.

Usuwanie sceny

Identyfikator operacji:
DeleteScene

Usuń określoną scenę.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator sceny
 SceneId True string

Identyfikator sceny do usunięcia.

Zwraca

Nazwa Ścieżka Typ Opis
dane
 data array of object

Zaktualizowane sceny.
Rid
 data.rid string

Unikatowy identyfikator usuniętej sceny.
rtype
 data.rtype string

Typ usuniętej sceny.
Błędy
 errors array of object

Błędy, które wystąpiły podczas wywołania.
Opis błędu
 errors.description string

Czytelne dla człowieka wyjaśnienie specyficzne dla tego wystąpienia problemu.

Uzyskiwanie świateł

Identyfikator operacji:
GetLights

Pobierz listę urządzeń z możliwościami błyskawic.

Zwraca

Nazwa Ścieżka Typ Opis
Błędy
 errors array of object

Błędy, które wystąpiły podczas wywołania.
Opis błędu
 errors.description string

Czytelne dla człowieka wyjaśnienie specyficzne dla tego wystąpienia problemu.
dane
 data array of object

Światła użytkownika.
Wartości akcji
 data.alert.action_values array of string

Lista efektów alertów, które obsługuje światło.
Niebieski X
 data.color.gamut.blue.x float

Pozycja X w gamie kolorów.
Niebieski Y
 data.color.gamut.blue.y float

Pozycja Y w gamie kolorów.
Zielony X
 data.color.gamut.green.x float

Pozycja X w gamie kolorów.
Zielony Y
 data.color.gamut.green.y float

Pozycja X w gamie kolorów.
Czerwony X
 data.color.gamut.red.x float

Pozycja X w gamie kolorów.
Czerwony Y
 data.color.gamut.red.y float

Pozycja X w gamie kolorów.
Typ gamu
 data.color.gamut_type string

Typy gamutów obsługiwane przez odcienie: A - Gamut wczesnych produktów tylko do kolorów Philips, B - Ograniczona gama pierwszych produktów kolorów Hue, C - Bogatsza gama kolorów produktów Hue białych i kolorów, inne - gamę kolorów produktów innych niż hue.
X
 data.color.xy.x float

Pozycja X w gamie kolorów.
Y
 data.color.xy.y float

Pozycja Y w gamie kolorów.
Mirek
 data.color_temperature.mirek integer

Temperatura koloru w mirek lub null, gdy kolor światła nie znajduje się w spektrum ct.
Maksimum Mirka
 data.color_temperature.mirek_schema.mirek_maximum integer

Maksymalna temperatura koloru, która obsługuje to światło.
Minimum Mirek
 data.color_temperature.mirek_schema.mirek_minimum integer

Minimalna temperatura koloru, która obsługuje to światło.
Mirek prawidłowy
 data.color_temperature.mirek_valid boolean

Wskazanie, czy wartość przedstawiona w mirek jest prawidłowa.
Jasność
 data.dimming.brightness float

Procent jasności. Wartość nie może być 0, zapis 0 zmienia ją na najniższą możliwą jasność.
Minimalny poziom przygaszonego
 data.dimming.min_dim_level float

Wartość procentowa maksymalnego światła wyjściowego urządzenia na minimalną jasność.
Szybkość
 data.dynamics.speed float

Szybkość dynamicznej palety lub efektu. Szybkość jest prawidłowa dla palety dynamicznej, jeśli stan jest dynamic_palette lub dla odpowiedniego efektu wymienionego w stanie. W przypadku braku stanu szybkość jest nieprawidłowa.
Prawidłowa szybkość
 data.dynamics.speed_valid boolean

Wskazuje, czy wartość przedstawiona z prędkością jest prawidłowa.
Status
 data.dynamics.status string

Bieżący stan lampy z dynamiką.
Wartości stanu
 data.dynamics.status_values array of string

Stany, w których lampa może być podczas odtwarzania dynamiki.
Identyfikator zasobu
 data.id string

Unikatowy identyfikator reprezentujący określone wystąpienie zasobu.
Identyfikator zasobu clip v1
 data.id_v1 string

Clip v1 identyfikator zasobu (wersja interfejsu API w wersji 1).
Archetyp
 data.metadata.archetype string

Jasny archetyp. Przestarzałe: użyj archetypu na poziomie urządzenia.
Nazwa nadana przez urządzenie
 data.metadata.name string

Czytelna dla człowieka nazwa zasobu.
Mode
 data.mode string

Jeden z: normalny lub przesyłany strumieniowo.
Stan światła
 data.on.on boolean

On/Off stanu światła: on=true, off=false.
RID
 data.owner.rid string

Unikatowy identyfikator przywoływnego zasobu.
Typ Rtype
 data.owner.rtype string

Typ przywoływnego zasobu.
Typ
 data.type string

Typ obsługiwanych zasobów.

Uzyskiwanie światła

Identyfikator operacji:
GetLight

Uzyskaj szczegółowe informacje o konkretnym urządzeniu z możliwościami błyskawic.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator urządzenia
 DeviceId True string

Identyfikator urządzenia do wyświetlania szczegółów.

Zwraca

Nazwa Ścieżka Typ Opis
Błędy
 errors array of object

Błędy, które wystąpiły podczas wywołania.
Opis błędu
 errors.description string

Czytelne dla człowieka wyjaśnienie specyficzne dla tego wystąpienia problemu.
dane
 data array of object

Światła pasujące do podanego identyfikatora.
Wartości akcji
 data.alert.action_values array of string

Lista efektów alertów, które obsługuje światło.
Niebieski X
 data.color.gamut.blue.x float

Pozycja X w gamie kolorów.
Niebieski Y
 data.color.gamut.blue.y float

Pozycja Y w gamie kolorów.
Zielony X
 data.color.gamut.green.x float

Pozycja X w gamie kolorów.
Zielony Y
 data.color.gamut.green.y float

Pozycja X w gamie kolorów.
Czerwony X
 data.color.gamut.red.x float

Pozycja X w gamie kolorów.
Czerwony Y
 data.color.gamut.red.y float

Pozycja X w gamie kolorów.
Typ gamu
 data.color.gamut_type string

Typy gamutów obsługiwane przez odcienie: A - Gamut wczesnych produktów tylko do kolorów Philips, B - Ograniczona gama pierwszych produktów kolorów Hue, C - Bogatsza gama kolorów produktów Hue białych i kolorów, inne - gamę kolorów produktów innych niż hue.
X
 data.color.xy.x float

Pozycja X w gamie kolorów.
Y
 data.color.xy.y float

Pozycja Y w gamie kolorów.
Mirek
 data.color_temperature.mirek integer

Temperatura koloru w mirek lub null, gdy kolor światła nie znajduje się w spektrum ct.
Maksimum Mirka
 data.color_temperature.mirek_schema.mirek_maximum integer

Maksymalna temperatura koloru, która obsługuje to światło.
Minimum Mirek
 data.color_temperature.mirek_schema.mirek_minimum integer

Minimalna temperatura koloru, która obsługuje to światło.
Mirek prawidłowy
 data.color_temperature.mirek_valid boolean

Wskazanie, czy wartość przedstawiona w mirek jest prawidłowa.
Jasność
 data.dimming.brightness float

Procent jasności. Wartość nie może być 0, zapis 0 zmienia ją na najniższą możliwą jasność.
Minimalny poziom przygaszonego
 data.dimming.min_dim_level float

Wartość procentowa maksymalnego światła wyjściowego urządzenia na minimalną jasność.
Szybkość
 data.dynamics.speed float

Szybkość dynamicznej palety lub efektu. Szybkość jest prawidłowa dla palety dynamicznej, jeśli stan jest dynamic_palette lub dla odpowiedniego efektu wymienionego w stanie. W przypadku braku stanu szybkość jest nieprawidłowa.
Prawidłowa szybkość
 data.dynamics.speed_valid boolean

Wskazuje, czy wartość przedstawiona z prędkością jest prawidłowa.
Status
 data.dynamics.status string

Bieżący stan lampy z dynamiką.
Wartości stanu
 data.dynamics.status_values array of string

Stany, w których lampa może być podczas odtwarzania dynamiki.
Identyfikator zasobu
 data.id string

Unikatowy identyfikator reprezentujący określone wystąpienie zasobu.
Identyfikator zasobu clip v1
 data.id_v1 string

Clip v1 identyfikator zasobu (wersja interfejsu API w wersji 1).
Archetyp
 data.metadata.archetype string

Jasny archetyp. Przestarzałe: użyj archetypu na poziomie urządzenia.
Nazwa nadana przez urządzenie
 data.metadata.name string

Czytelna dla człowieka nazwa zasobu.
Mode
 data.mode string

Jeden z: normalny lub przesyłany strumieniowo.
Stan światła
 data.on.on boolean

On/Off stanu światła: on=true, off=false.
RID
 data.owner.rid string

Unikatowy identyfikator przywoływnego zasobu.
Typ Rtype
 data.owner.rtype string

Typ przywoływnego zasobu.
Typ
 data.type string

Typ obsługiwanych zasobów.

Wykonywanie urządzenia

Identyfikator operacji:
ExecuteDevice

Wykonaj określone urządzenie.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator urządzenia
 DeviceId True string

Identyfikator urządzenia do aktualizowania metadanych.
Archetyp
 archetype string

Domyślnie archetyp podany przez producenta.
Name
 name string

Czytelna dla człowieka nazwa zasobu (maksymalnie 32 znaki).
Akcja
 action string

Wpisz "identify", aby wyzwolić identyfikację. Bridge wykonuje cykle identyfikacji LED Zigbee przez 5 sekund. Światła wykonują jeden cykl oddychania. Czujniki wykonują cykle identyfikacji LED przez 15 sekund.

Zwraca

Nazwa Ścieżka Typ Opis
dane
 data array of object

Zaktualizowane urządzenia.
Rid
 data.rid string

Unikatowy identyfikator przywoływnego zasobu.
rtype
 data.rtype string

Typ przywoływnego zasobu.
Błędy
 errors array of object

Błędy, które wystąpiły podczas wywołania.
Opis błędu
 errors.description string

Czytelne dla człowieka wyjaśnienie specyficzne dla tego wystąpienia problemu.

Wykonywanie światła

Identyfikator operacji:
ExecuteLight

Wykonywanie urządzenia z możliwościami błyskawic.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator urządzenia
 DeviceId True string

Identyfikator urządzenia do aktualizowania właściwości.
Name
 name string

MinLength: 1 - maxLength: 32. Czytelna dla człowieka nazwa zasobu.
On
 on boolean

On/Off stanu światła on=true, off=false.
Jasność
 brightness float

Maksimum: 100. Procent jasności. Zapis 0 zmienia się na najniższą możliwą jasność.
Mirek
 mirek integer

Minimum: 153 — maksimum: 500. Temperatura koloru w mirek lub null, gdy kolor światła nie znajduje się w spektrum ct.
X
 x float

Minimum: 0 - maksimum: 1. Pozycja X w gamie kolorów.
Y
 y float

Minimum: 0 - maksimum: 1. Pozycja Y w gamie kolorów.
Szybkość
 speed float

Minimum: 0 - maksimum: 1. Szybkość palety dynamicznej. Szybkość jest prawidłowa dla palety dynamicznej, jeśli stan jest dynamic_palette lub dla odpowiedniego efektu wymienionego w stanie. W przypadku braku stanu szybkość jest nieprawidłowa.
Czas trwania
 duration integer

Maksimum: 6000000. Czas trwania przejścia światła w ms. Dokładność jest wyrażona w krokach 100 ms.
Akcja
 action string

Jedna z dostępnych akcji do wykonania na urządzeniu. Tj. "oddychaj".
X
 x float

Minimum: 0 - maksimum: 1. Pozycja X w gamie kolorów.
Y
 y float

Minimum: 0 - maksimum: 1. Pozycja Y w gamie kolorów.

Zwraca

Nazwa Ścieżka Typ Opis
dane
 data array of object

dane
Rid
 data.rid string

Rid
rtype
 data.rtype string

rtype
Błędy
 errors array of object

Błędy, które wystąpiły podczas wywołania.
Opis błędu
 errors.description string

Czytelne dla człowieka wyjaśnienie specyficzne dla tego wystąpienia problemu.