Freigeben über

Govee (Independent Publisher) (Vorschau)

Integrieren Sie govee intelligente Lichtgeräte in Ihre Anwendungen mit der Govee Developer API. Steuern von Lichtern, Ändern von Farben, Anpassen der Helligkeit und Festlegen von Zeitgebern Greifen Sie auf den Echtzeitgerätestatus für die erweiterte Anwendungsentwicklung zu.

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 Richard Wilson
URL https://www.richardawilson.com/
Email richard.a.wilson@microsoft.com
Connectormetadaten
Herausgeber Richard Wilson
Webseite https://us.govee.com/
Datenschutzrichtlinie https://us.govee.com/policies/privacy-policy
Kategorien Internet der Dinge

Govee

Bietet eine nahtlose Integration in die intelligenten Beleuchtungssysteme von Govee , sodass Benutzer ihre Geräte mühelos steuern und verwalten können. Es ermöglicht eine vielzahl von Funktionen, einschließlich der Anpassung von Lichteinstellungen, Ändern von Farben, Ändern der Helligkeit und Zugreifen auf den Echtzeitgerätestatus.

Die Möglichkeit, Beleuchtungseinrichtungen zu automatisieren und anzupassen, macht diesen Verbinder besonders nützlich, um das Ambiente in Smart Homes zu verbessern, dynamische Beleuchtungsszenen für verschiedene Anlässe zu schaffen und intelligente Beleuchtung in breitere Hausautomatisierungssysteme zu integrieren. Es bietet benutzern eine bequeme und intuitive Möglichkeit, ihre Beleuchtungserfahrung zu personalisieren und die Funktionen der intelligenten Beleuchtungstechnologie von Govee vollständig zu nutzen.

Herausgeber: Richard Wilson

Voraussetzungen

Bevor Sie den Govee-Connector verwenden können, müssen Sie einen Govee-Entwickler-API-Schlüssel abrufen. Führen Sie die folgenden Schritte aus, um den Schlüssel zu erwerben:

Abrufen eines Govee-Entwickler-API-Schlüssels

  1. Laden Sie die Govee Home App herunter:

  2. Zugreifen auf Ihr Profil:

    • Öffnen Sie die Govee Home App, und navigieren Sie zur Seite "Mein Profil", indem Sie auf das Profilsymbol (👤) tippen.

  3. Wechseln Sie zu "Einstellungen":

    • Klicken Sie auf das Symbol "Einstellungen" (⚙️), das sich in der oberen rechten Ecke befindet, um auf das Menü "Einstellungen" zuzugreifen.

  4. Für API-Schlüssel beantragen:

    • Wählen Sie im Menü "Einstellungen" die Option "Für API-Schlüssel übernehmen" aus.

  5. Vollständiges Bewerbungsformular:

    • Füllen Sie die erforderlichen Felder für "Name" und "Grund für Anwendung" aus.
      • Beispiele hierfür sind Home Automation, Integration von Drittanbietern oder Bildungszwecke.

  6. Nutzungsbedingungen zustimmen:

    • Lesen Sie sorgfältig die Nutzungsbedingungen der Govee-Entwickler-API. Sobald Sie die Bedingungen verstanden haben, aktivieren Sie das Kontrollkästchen, um Ihre Annahme anzugeben.

  7. Antrag einreichen:

    • Klicken Sie auf "Absenden", um Ihre Anwendung für einen API-Schlüssel zu senden. Nach der Genehmigung erhalten Sie Ihren Govee-API-Schlüssel, der für die Verwendung dieses Connectors erforderlich ist.

Bitte beachten Sie, dass der GENEHMIGUNGsprozess für DEN API-Schlüssel einige Zeit in Anspruch nehmen kann, und die Genehmigung liegt im Ermessen von Govee. Stellen Sie sicher, dass Ihre Anwendung einen gültigen und klaren Grund für die Anforderung des API-Schlüssels enthält, um die Wahrscheinlichkeit der Genehmigung zu erhöhen.

Unterstützte Vorgänge

1. Befehl auf Dem Gerät ausführen

Mit diesem Vorgang können Sie verschiedene Befehle senden, um Ihr Govee-Gerät zu steuern.

  • Eingabeeigenschaften:
    • Geräte-MAC-Adresse: Die eindeutige MAC-Adresse des govee-Geräts, das gesteuert werden soll.
    • Gerätemodell: Die Modellnummer des Govee-Geräts.
    • Befehlsdetails: Ein Objekt, das den auszuführenden Befehl enthält. Dazu gehören:
      • Name: Der Befehlsname (z. B. "turn", "brightness", "color", "colorTem").
    • Zusätzliche Parameter (basierend auf dem Befehl):
      • Aktivieren: (Optional) "Ein" oder "Aus" – wird verwendet, wenn der Befehl "turn" ist.
      • Helligkeit: (Optional) Numerischer Wert (0-100) – wird verwendet, wenn der Befehl "Helligkeit" ist.
      • Color: (Optional) Object with 'r', 'g', 'b' values - used when the command is 'color'.
      • Farbtemperatur: (Optional) Numerischer Wert für Farbtemperatur – wird verwendet, wenn der Befehl "colorTem" ist.

2. Abrufen von Geräteinformationen

Rufen Sie Informationen zu einem bestimmten Govee-Gerät oder allen Geräten ab, die Ihrem Konto zugeordnet sind.

  • Eingabeeigenschaften:
    • Geräte-MAC-Adresse: (Optional) Die MAC-Adresse des bestimmten Govee-Geräts, für das Informationen angefordert werden. Wenn diese Angabe weggelassen wird, werden Informationen für alle Geräte zurückgegeben.
    • Gerätemodell: (Optional) Das Modell des Govee-Geräts. Wenn sie zusammen mit der MAC-Adresse angegeben wird, wird die Abfrage auf dieses bestimmte Gerät optimiert.

API-Dokumentation

Ausführliche Informationen zur Govee Lights-Entwickler-API, einschließlich ihrer Funktionen, Endpunkte, Parameter und Antworten, finden Sie in der offiziellen Govee-API-Dokumentation. Die Dokumentation enthält umfassende Anleitungen und Beispiele, mit denen Sie die API in Ihre Anwendungen und Workflows effektiv integrieren und nutzen können.

Bekannte Probleme und Einschränkungen

Derzeit sind keine bekannten Probleme oder Einschränkungen vorhanden. Verweisen Sie immer auf diesen Abschnitt, um aktualisierte Informationen zu erhalten.

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
Govee-API-Schlüssel securestring Der Govee-API-Schlüssel, der in der mobilen Govee-App angefordert werden kann. Richtig

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Abrufen von Geräteinformationen

Greifen Sie auf detaillierte Informationen zu Ihren Govee-Geräten zu. Dieser Endpunkt ruft Daten für ein bestimmtes Gerät ab, wenn es mit der MAC-Adresse und dem Mac-Modell bereitgestellt wird. Wenn kein bestimmtes Gerät angegeben ist, gibt der Endpunkt Informationen für alle Geräte zurück, die Ihrem Konto zugeordnet sind. Die Antwort enthält Gerätedetails wie Gerätename, Steuerungsfähigkeit, Abrufbarkeit, unterstützte Befehle und zusätzliche Eigenschaften. Dies ist nützlich, um die Funktionen und die aktuelle Konfiguration Ihrer Govee-Geräte zu verstehen.
Befehl auf Gerät ausführen

Führen Sie einen bestimmten Befehl auf einem Govee-Gerät aus. Mit diesem Endpunkt können Sie verschiedene Aspekte des Geräts steuern, z. B. Energiezustand, Helligkeit, Farbe und Farbtemperatur. Geben Sie die MAC-Adresse und das Modell des Geräts zusammen mit den Befehlsdetails an. Zu den unterstützten Befehlen gehören "Turn" für die Energiesteuerung, "Helligkeit" zum Anpassen von Helligkeitsstufen, "Farbe" zum Festlegen von RGB-Farbwerten und "colorTem" zum Anpassen der Farbtemperatur.

Abrufen von Geräteinformationen

Vorgangs-ID:
GetDeviceInformation

Greifen Sie auf detaillierte Informationen zu Ihren Govee-Geräten zu. Dieser Endpunkt ruft Daten für ein bestimmtes Gerät ab, wenn es mit der MAC-Adresse und dem Mac-Modell bereitgestellt wird. Wenn kein bestimmtes Gerät angegeben ist, gibt der Endpunkt Informationen für alle Geräte zurück, die Ihrem Konto zugeordnet sind. Die Antwort enthält Gerätedetails wie Gerätename, Steuerungsfähigkeit, Abrufbarkeit, unterstützte Befehle und zusätzliche Eigenschaften. Dies ist nützlich, um die Funktionen und die aktuelle Konfiguration Ihrer Govee-Geräte zu verstehen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Geräte-MAC-Adresse
 device string

Ein optionaler Parameter, der die MAC-Adresse des Govee-Geräts darstellt, für die Informationen angefordert werden. Wenn angegeben, gibt die API Details speziell für dieses Gerät zurück. Lassen Sie diesen Parameter leer, um Informationen für alle Geräte abzurufen, die dem Konto zugeordnet sind.
Gerätemodell
 model string

Ein optionaler Parameter, der das Modell des Govee-Geräts angibt. Wenn angegeben, gibt die API Informationen für Geräte zurück, die mit diesem Modell übereinstimmen. Dieser Parameter kann in Verbindung mit der Mac-Adresse des Geräts verwendet werden.

Gibt zurück

Name Pfad Typ Beschreibung
Geräte
 data.devices array of object

Eine Liste der Geräte, die dem Konto zugeordnet sind. Wenn ein bestimmtes Gerät angefordert wird, enthält die Liste nur ein Gerät.
Geräte-MAC-Adresse
 data.devices.device string

Die eindeutige MAC-Adresse des Geräts
Gerätemodell
 data.devices.model string

Die Modellnummer des Geräts
Gerätename
 data.devices.deviceName string

Der Name des Geräts
Kontrollierbar
 data.devices.controllable boolean

Gibt an, ob das Gerät steuerbar ist.
Mindestwert
 data.devices.properties.colorTem.range.min integer

Minimaler Farbtemperaturwert
Höchstwert
 data.devices.properties.colorTem.range.max integer

Maximaler Farbtemperaturwert
Abrufbar
 data.devices.retrievable boolean

Gibt an, ob das Gerät abgerufen werden kann.
Unterstützte Befehle
 data.devices.supportCmds array of string

Unterstützte Befehle für das Gerät
Nachricht
 message string

Eine Meldung, die das Ergebnis des Vorgangs beschreibt
Statuscode
 code integer

Der HTTP-Statuscode der Antwort

Befehl auf Gerät ausführen

Vorgangs-ID:
RunCommandOnDevice

Führen Sie einen bestimmten Befehl auf einem Govee-Gerät aus. Mit diesem Endpunkt können Sie verschiedene Aspekte des Geräts steuern, z. B. Energiezustand, Helligkeit, Farbe und Farbtemperatur. Geben Sie die MAC-Adresse und das Modell des Geräts zusammen mit den Befehlsdetails an. Zu den unterstützten Befehlen gehören "Turn" für die Energiesteuerung, "Helligkeit" zum Anpassen von Helligkeitsstufen, "Farbe" zum Festlegen von RGB-Farbwerten und "colorTem" zum Anpassen der Farbtemperatur.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Geräte-MAC-Adresse
 device True string

Die eindeutige MAC-Adresse des Govee-Geräts. Dieser Bezeichner wird verwendet, um anzugeben, welches Gerät Sie steuern möchten.
Gerätemodell
 model True string

Die Modellnummer Ihres Govee-Geräts. Diese Informationen helfen bei der Identifizierung der spezifischen Features und Funktionen, die für das Gerät verfügbar sind.
Befehlsname
 name True string

Der Befehl, der auf dem Gerät ausgeführt werden soll. Dieses Objekt enthält den Befehlsnamen (z. B. "turn", "brightness", "color", "colorTem") und den zugehörigen Wert. Der Befehlsname bestimmt den Typ der Aktion, die auf dem Gerät ausgeführt werden soll.
Teil
 turn string

Dieser Parameter wird verwendet, um das Gerät ein- oder auszuschalten. Verwenden Sie diese Option nur, wenn der Befehl "Drehen" ausgewählt ist. Gültige Werte sind "ein" oder "aus".
Helligkeit
 brightness integer

Die für das Gerät festzulegende Helligkeitsstufe. Verwenden Sie diesen Parameter nur, wenn der Befehl "Helligkeit" ausgewählt ist. Geben Sie einen Wert zwischen 0 (Minimale Helligkeit) und 100 (maximale Helligkeit) ein.
Farbe - Rot
 r integer

Dieser Parameter stellt die rote Komponente des RGB-Farbwerts für das Gerät dar. Sie ist Teil des Befehls "Farbe". Geben Sie einen ganzzahligen Wert zwischen 0 und 255 an, wobei 0 kein Rot und 255 die maximale Intensität von Rot darstellt.
Farbe - Grün
 g integer

Dieser Parameter definiert die grüne Komponente des RGB-Farbwerts für das Gerät. Sie wird in Verbindung mit dem Befehl "Farbe" verwendet. Geben Sie einen ganzzahligen Wert zwischen 0 und 255 an, wobei "0" keine grüne und "255" angibt, die höchste Intensität von Grün bedeutet.
Farbe - Blau
 b integer

Die blaue Komponente des RGB-Farbwerts, der auf dem Gerät festgelegt werden soll. Dieser Parameter ist Teil des Befehls 'color'. Der Wert sollte eine ganze Zahl zwischen 0 und 255 sein, wobei 0 das Fehlen von Blau und 255 das hellste Blau angibt.
Farbtemperatur
 colorTem integer

Der für das Gerät festzulegende Farbtemperaturwert. Verwenden Sie diesen Parameter nur, wenn der Befehl "colorTem" ausgewählt ist. Geben Sie den Vom Gerät erforderlichen Farbtemperaturwert ein.

Gibt zurück

Name Pfad Typ Beschreibung
Statuscode
 code integer

Der HTTP-Statuscode der Antwort
Nachricht
 message string

Eine Meldung, die das Ergebnis des Vorgangs beschreibt
Daten
 data object

Die mit der Antwort zurückgegebenen Daten.