Govee (niezależny wydawca) (wersja zapoznawcza)
Integrowanie inteligentnych urządzeń Govee z aplikacjami przy użyciu interfejsu API dewelopera govee. Sterowanie światłami, zmienianie kolorów, dostosowywanie jasności i ustawianie czasomierzy. Uzyskiwanie dostępu do stanu urządzenia w czasie rzeczywistym na potrzeby zaawansowanego tworzenia aplikacji.
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 | Richard Wilson |
| adres URL | https://www.richardawilson.com/ |
| richard.a.wilson@microsoft.com |
| Metadane łącznika | |
|---|---|
| Publisher | Richard Wilson |
| Witryna internetowa | https://us.govee.com/ |
| Zasady ochrony prywatności | https://us.govee.com/policies/privacy-policy |
| Kategorie | Internet rzeczy |
Govee
Oferuje bezproblemową integrację z inteligentnymi systemami oświetleniowymi firmy Govee , umożliwiając użytkownikom bezproblemową kontrolę urządzeń i zarządzanie nimi. Umożliwia ona szeroką gamę funkcji, w tym dostosowywanie ustawień światła, zmienianie kolorów, modyfikowanie jasności i uzyskiwanie dostępu do stanu urządzenia w czasie rzeczywistym.
Możliwość automatyzowania i dostosowywania konfiguracji oświetlenia sprawia, że ten łącznik jest szczególnie przydatny do ulepszania atmosfery w inteligentnych domach, tworzenia dynamicznych scen oświetleniowych przez różne okazje i integrowania inteligentnego oświetlenia z szerszymi systemami automatyzacji domu. Oferuje on wygodny i intuicyjny sposób, aby użytkownicy mogli personalizować swoje środowisko oświetlenia i w pełni wykorzystać możliwości technologii inteligentnego oświetlenia Govee.
Wydawca: Richard Wilson
Wymagania wstępne
Przed rozpoczęciem korzystania z łącznika govee należy uzyskać klucz interfejsu API dewelopera języka Govee. Wykonaj następujące kroki, aby uzyskać klucz:
Uzyskiwanie klucza interfejsu API dewelopera języka Govee
Pobierz aplikację Govee Home:
- W przypadku systemu iOS: Govee Home w sklepie App Store
- Dla systemu Android: Govee Home w sklepie Google Play
Uzyskiwanie dostępu do profilu:
- Otwórz aplikację Govee Home App i przejdź do strony "Mój profil", naciskając ikonę profilu (👤).
Przejdź do pozycji Ustawienia:
- Kliknij ikonę ustawień (⚙️) znajdującą się w prawym górnym rogu, aby uzyskać dostęp do menu Ustawienia.
Zastosuj do klucza interfejsu API:
- W menu Ustawienia wybierz pozycję "Zastosuj do klucza interfejsu API".
Kompletny formularz aplikacji:
- Wypełnij pola wymagane dla pól "Name" i "Reason for application".
- Przykładowe przyczyny to automatyzacja domu, integracja innych firm lub cele edukacyjne.
- Wypełnij pola wymagane dla pól "Name" i "Reason for application".
Zaakceptuj warunki użytkowania usługi:
- Uważnie przeczytaj warunki użytkowania interfejsu API dewelopera języka Govee. Po zrozumieniu terminów zaznacz pole wyboru, aby wskazać akceptację.
Prześlij aplikację:
- Kliknij pozycję "Prześlij", aby wysłać aplikację dla klucza interfejsu API. Po zatwierdzeniu otrzymasz klucz interfejsu API govee, który jest niezbędny do korzystania z tego łącznika.
Należy pamiętać, że proces zatwierdzania klucza interfejsu API może zająć trochę czasu, a zatwierdzenie jest według uznania govee. Upewnij się, że aplikacja zawiera prawidłową i wyraźną przyczynę żądania klucza interfejsu API w celu zwiększenia prawdopodobieństwa zatwierdzenia.
Obsługiwane operacje
1. Uruchom polecenie na urządzeniu
Ta operacja umożliwia wysyłanie różnych poleceń w celu kontrolowania urządzenia Govee.
-
Właściwości wejściowe:
- Adres MAC urządzenia: Unikatowy adres MAC urządzenia Govee, który ma być kontrolowany.
- Model urządzenia: Numer modelu urządzenia Govee.
-
Szczegóły polecenia: Obiekt zawierający polecenie do wykonania. Obejmuje następujące elementy:
- Nazwa: Nazwa polecenia (np. "turn", "brightness", "color", "color", "colorTem".
- Dodatkowe parametry (na podstawie polecenia):
- Włącz: (Opcjonalnie) "włączone" lub "wyłączone" — używane, gdy polecenie ma wartość "turn".
- Jasność: (opcjonalnie) Wartość liczbowa (0–100) — używana, gdy polecenie ma wartość "jasność".
- Kolor: (Opcjonalnie) Obiekt z wartościami "r", "g", "b" — używany, gdy polecenie ma wartość "color".
- Temperatura koloru: (opcjonalnie) Wartość liczbowa temperatury koloru — używana, gdy polecenie to "colorTem".
2. Pobieranie informacji o urządzeniu
Pobierz informacje o konkretnym urządzeniu Govee lub wszystkich urządzeniach skojarzonych z twoim kontem.
-
Właściwości wejściowe:
- Adres MAC urządzenia: (opcjonalnie) Adres MAC określonego urządzenia Govee, dla którego są wymagane informacje. W przypadku pominięcia zwracane są informacje dotyczące wszystkich urządzeń.
- Model urządzenia: (opcjonalnie) Model urządzenia Govee. Jeśli zostanie określony wraz z adresem MAC, uściśli zapytanie do tego konkretnego urządzenia.
Dokumentacja interfejsu API
Aby uzyskać szczegółowe informacje na temat interfejsu API dewelopera usługi Govee Lights, w tym jego możliwości, punktów końcowych, parametrów i odpowiedzi, zapoznaj się z oficjalną dokumentacją interfejsu API usługi Govee. Dokumentacja zawiera kompleksowe wskazówki i przykłady ułatwiające efektywne integrowanie i korzystanie z interfejsu API w aplikacjach i przepływach pracy.
Znane problemy i ograniczenia
Obecnie nie istnieją znane problemy ani ograniczenia. Zawsze zapoznaj się z tą sekcją, aby uzyskać zaktualizowane informacje.
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 zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Klucz interfejsu API usługi Govee | securestring | Klucz interfejsu API govee, którego można zażądać w aplikacji mobilnej Govee. | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Uruchom polecenie na urządzeniu |
Wykonaj określone polecenie na urządzeniu Govee. Ten punkt końcowy umożliwia kontrolowanie różnych aspektów urządzenia, takich jak stan zasilania, jasność, kolor i temperatura koloru. Podaj adres MAC i model urządzenia wraz ze szczegółami polecenia. Obsługiwane polecenia obejmują "turn" dla kontrolki zasilania, "jasność" do dostosowywania poziomów jasności, "kolor" do ustawiania wartości kolorów RGB i "colorTem" w celu dostosowania temperatury koloru. |
| Uzyskiwanie informacji o urządzeniu |
Uzyskaj dostęp do szczegółowych informacji o urządzeniach Govee. Ten punkt końcowy pobiera dane dla określonego urządzenia, gdy jest dostarczany z jego adresem MAC i modelem. Jeśli nie określono określonego urządzenia, punkt końcowy zwraca informacje dotyczące wszystkich urządzeń skojarzonych z twoim kontem. Odpowiedź zawiera szczegóły urządzenia, takie jak nazwa urządzenia, możliwość kontrolowania, pobieranie, obsługiwane polecenia i dodatkowe właściwości. Jest to przydatne do zrozumienia możliwości i bieżącej konfiguracji urządzeń Govee. |
Uruchom polecenie na urządzeniu
Wykonaj określone polecenie na urządzeniu Govee. Ten punkt końcowy umożliwia kontrolowanie różnych aspektów urządzenia, takich jak stan zasilania, jasność, kolor i temperatura koloru. Podaj adres MAC i model urządzenia wraz ze szczegółami polecenia. Obsługiwane polecenia obejmują "turn" dla kontrolki zasilania, "jasność" do dostosowywania poziomów jasności, "kolor" do ustawiania wartości kolorów RGB i "colorTem" w celu dostosowania temperatury koloru.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Adres MAC urządzenia
|
device | True | string |
Unikatowy adres MAC urządzenia Govee. Ten identyfikator służy do określania urządzenia, które chcesz kontrolować. |
|
Model urządzenia
|
model | True | string |
Numer modelu urządzenia Govee. Te informacje ułatwiają identyfikowanie określonych funkcji i możliwości dostępnych dla urządzenia. |
|
Nazwa polecenia
|
name | True | string |
Polecenie do wykonania na urządzeniu. Ten obiekt zawiera nazwę polecenia (np. "turn", "brightness", "color", "colorTem" i skojarzona z nią wartość. Nazwa polecenia określa typ akcji, która ma być wykonywana na urządzeniu. |
|
Skręcić
|
turn | string |
Ten parametr służy do włączania lub wyłączania urządzenia. Użyj tej opcji tylko wtedy, gdy wybrano polecenie "turn". Prawidłowe wartości to "włączone" lub "wyłączone". |
|
|
Jasność
|
brightness | integer |
Poziom jasności ustawiony dla urządzenia. Użyj tego parametru tylko wtedy, gdy wybrano polecenie "jasność". Wprowadź wartość z zakresu od 0 (minimalna jasność) do 100 (maksymalna jasność). |
|
|
Kolor — czerwony
|
r | integer |
Ten parametr reprezentuje czerwony składnik wartości koloru RGB dla urządzenia. Jest to część polecenia "color". Określ wartość całkowitą z zakresu od 0 do 255, gdzie 0 oznacza, że nie ma czerwonego, a 255 reprezentuje maksymalną intensywność koloru czerwonego. |
|
|
Kolor — zielony
|
g | integer |
Ten parametr definiuje zielony składnik wartości koloru RGB dla urządzenia. Jest on używany w połączeniu z poleceniem "color". Podaj wartość całkowitą z zakresu od 0 do 255, z wartością 0 wskazującą, że nie ma zielonego i 255 oznacza najwyższą intensywność zieleni. |
|
|
Kolor — niebieski
|
b | integer |
Niebieski składnik wartości koloru RGB ustawiony na urządzeniu. Ten parametr jest częścią polecenia "color". Wartość powinna być liczbą całkowitą z zakresu od 0 do 255, gdzie 0 jest brakiem niebieskiego i 255 oznacza najjjaśniejszy niebieski. |
|
|
Temperatura koloru
|
colorTem | integer |
Wartość temperatury koloru ustawiona dla urządzenia. Użyj tego parametru tylko wtedy, gdy wybrano polecenie "colorTem". Wprowadź wartość temperatury koloru zgodnie z wymaganiami urządzenia. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Kod stanu
|
code | integer |
Kod stanu HTTP odpowiedzi |
|
Message
|
message | string |
Komunikat opisujący wynik operacji |
|
dane
|
data | object |
Dane zwrócone z odpowiedzią. |
Uzyskiwanie informacji o urządzeniu
Uzyskaj dostęp do szczegółowych informacji o urządzeniach Govee. Ten punkt końcowy pobiera dane dla określonego urządzenia, gdy jest dostarczany z jego adresem MAC i modelem. Jeśli nie określono określonego urządzenia, punkt końcowy zwraca informacje dotyczące wszystkich urządzeń skojarzonych z twoim kontem. Odpowiedź zawiera szczegóły urządzenia, takie jak nazwa urządzenia, możliwość kontrolowania, pobieranie, obsługiwane polecenia i dodatkowe właściwości. Jest to przydatne do zrozumienia możliwości i bieżącej konfiguracji urządzeń Govee.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Adres MAC urządzenia
|
device | string |
Opcjonalny parametr reprezentujący adres MAC urządzenia Govee, dla którego są żądane informacje. Jeśli zostanie podany, interfejs API zwróci szczegółowe informacje dotyczące tego urządzenia. Pozostaw ten parametr pusty, aby pobrać informacje dla wszystkich urządzeń skojarzonych z kontem. |
|
|
Model urządzenia
|
model | string |
Opcjonalny parametr wskazujący model urządzenia Govee. Jeśli zostanie określony, interfejs API zwróci informacje dotyczące urządzeń pasujących do tego modelu. Tego parametru można używać w połączeniu z adresem MAC urządzenia. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Urządzenia
|
data.devices | array of object |
Lista urządzeń skojarzonych z kontem. Jeśli zażądano określonego urządzenia, lista będzie zawierać tylko jedno urządzenie. |
|
Adres MAC urządzenia
|
data.devices.device | string |
Unikatowy adres MAC urządzenia |
|
Model urządzenia
|
data.devices.model | string |
Numer modelu urządzenia |
|
Nazwa urządzenia
|
data.devices.deviceName | string |
Nazwa urządzenia |
|
Kontrolowane
|
data.devices.controllable | boolean |
Wskazuje, czy urządzenie jest sterowane |
|
Minimalna wartość
|
data.devices.properties.colorTem.range.min | integer |
Minimalna wartość temperatury koloru |
|
Maximum
|
data.devices.properties.colorTem.range.max | integer |
Maksymalna wartość temperatury koloru |
|
Z możliwością pobierania
|
data.devices.retrievable | boolean |
Wskazuje, czy urządzenie jest możliwe do pobrania |
|
Obsługiwane polecenia
|
data.devices.supportCmds | array of string |
Obsługiwane polecenia dla urządzenia |
|
Message
|
message | string |
Komunikat opisujący wynik operacji |
|
Kod stanu
|
code | integer |
Kod stanu HTTP odpowiedzi |