Aracılığıyla paylaş

Govee (Bağımsız Yayımcı) (Önizleme)

Govee Geliştirici API'siyle Govee akıllı ışık cihazlarını uygulamalarınızla tümleştirin. Işıkları kontrol edin, renkleri değiştirin, parlaklığı ayarlayın ve zamanlayıcıları ayarlayın. Gelişmiş uygulama geliştirme için gerçek zamanlı cihaz durumuna erişin.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet Class Bölgeler
Copilot Studio Premium Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Logic Apps Standart Aşağıdakiler dışında tüm Logic Apps bölgeleri :
     - Azure Kamu bölgeleri
     - Azure Çin bölgeleri
     - ABD Savunma Bakanlığı (DoD)
Power Apps Premium Aşağıdakiler dışında tüm Power Apps bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Power Automate Premium Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
İletişim
İsim Richard Wilson
URL https://www.richardawilson.com/
E-posta richard.a.wilson@microsoft.com
Bağlayıcı Meta Verileri
Publisher Richard Wilson
Web sitesi https://us.govee.com/
Gizlilik ilkesi https://us.govee.com/policies/privacy-policy
Kategoriler Nesnelerin İnterneti

Govee

Govee'nin akıllı aydınlatma sistemleriyle sorunsuz tümleştirme sağlayarak kullanıcıların cihazlarını zahmetsizce kontrol etmesini ve yönetmesini sağlar. Işık ayarlarını yapma, renkleri değiştirme, parlaklığı değiştirme ve gerçek zamanlı cihaz durumuna erişme gibi çok çeşitli işlevlere olanak tanır.

Aydınlatma kurulumlarını otomatikleştirme ve özelleştirme özelliği, bu bağlayıcıyı özellikle akıllı evlerdeki ortamı geliştirmek, çeşitli durumlar için dinamik aydınlatma sahneleri oluşturmak ve akıllı aydınlatmayı daha geniş ev otomasyon sistemleriyle tümleştirmek için kullanışlı hale getirir. Kullanıcıların aydınlatma deneyimlerini kişiselleştirmeleri ve Govee'nin akıllı aydınlatma teknolojisinin özelliklerinden tam olarak yararlanmaları için kullanışlı ve sezgisel bir yol sunar.

Yayımcı: Richard Wilson

Önkoşullar

Govee bağlayıcısını kullanabilmeniz için bir Govee Geliştirici API Anahtarı edinmeniz gerekir. Anahtarı almak için şu adımları izleyin:

Govee Geliştirici API Anahtarı Alma

  1. Govee Ev Uygulamasını indirin:

  2. Profilinize Erişin:

    • Govee Giriş Uygulamasını açın ve profil simgesine (👤 ) dokunarak 'Profilim' sayfasına gidin.

  3. Ayarlar'a gidin:

    • Ayarlar menüsüne erişmek için sağ üst köşedeki ayarlar simgesine (⚙️) tıklayın.

  4. API Anahtarı için uygula:

    • Ayarlar menüsünden 'API Anahtarı için Uygula'yı seçin.

  5. Tam Başvuru Formu:

    • 'Ad' ve 'Uygulama nedeni' için gerekli alanları doldurun.
      • Örnek nedenler ev otomasyonu, üçüncü taraf tümleştirmesi veya eğitim amaçlarıdır.

  6. Hizmet Koşullarını Kabul Et:

    • Govee Geliştirici API'sinin Hizmet Koşulları'nı dikkatle okuyun. Koşulları anladıktan sonra kabul ettiğinizi belirtmek için kutuyu işaretleyin.

  7. Uygulamayı Gönder:

    • Uygulamanızı bir API anahtarı için göndermek için 'Gönder'e tıklayın. Onaylandıktan sonra, bu bağlayıcıyı kullanmak için gerekli olan Govee API Anahtarınızı alırsınız.

API anahtar onay işleminin biraz zaman alabileceğini ve onayın Govee'nin takdirine bağlı olduğunu lütfen unutmayın. Uygulamanızın onay olasılığını artırmak için API anahtarı istemek için geçerli ve net bir neden içerdiğinden emin olun.

Desteklenen İşlemler

1. Cihazda Komut Çalıştır

Bu işlem, Govee cihazınızı denetlemek için çeşitli komutlar göndermenizi sağlar.

  • Giriş Özellikleri:
    • Cihaz MAC Adresi: Denetlenecek Govee cihazının benzersiz MAC adresi.
    • Cihaz Modeli: Govee cihazının model numarası.
    • Komut Ayrıntıları: Yürütülecek komutu içeren bir nesne. Şunları içerir:
      • Ad: Komut adı (örneğin, 'turn', 'parlaklık', 'color', 'colorTem').
    • Ek Parametreler (komutuna göre):
      • Şunu açın: (İsteğe bağlı) 'açık' veya 'kapalı' - komut 'turn' olduğunda kullanılır.
      • Parlaklık: (İsteğe bağlı) Sayısal değer (0-100) - komut 'parlaklık' olduğunda kullanılır.
      • Renk: (İsteğe bağlı) 'r', 'g', 'b' değerlerine sahip nesne - komut 'color' olduğunda kullanılır.
      • Renk Sıcaklığı: (İsteğe bağlı) Renk sıcaklığı için sayısal değer - komut 'colorTem' olduğunda kullanılır.

2. Cihaz Bilgilerini Alma

Belirli bir Govee cihazı veya hesabınızla ilişkili tüm cihazlar hakkında bilgi alın.

  • Giriş Özellikleri:
    • Cihaz MAC Adresi: (İsteğe bağlı) Bilgilerin istendiği govee cihazının MAC adresi. Atlanırsa, tüm cihazlar için bilgiler döndürülür.
    • Cihaz Modeli: (İsteğe bağlı) Govee cihazının modeli. MAC adresiyle birlikte belirtilirse, sorguyu ilgili cihaza daraltıyor.

API Belgeleri

Özellikleri, uç noktaları, parametreleri ve yanıtları dahil olmak üzere Govee Lights Geliştirici API'si hakkında ayrıntılı bilgi için resmi Govee API Belgelerine bakın. Belgelerde, API'yi uygulamalarınız ve iş akışlarınız içinde etkili bir şekilde tümleştirmenize ve kullanmanıza yardımcı olacak kapsamlı rehberlik ve örnekler sağlanır.

Bilinen Sorunlar ve Sınırlamalar

Şu anda bilinen bir sorun veya sınırlama yoktur. Güncelleştirilmiş bilgiler için her zaman bu bölüme bakın.

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:
Varsayılan Bağlantı oluşturmak için parametreler. Tüm bölgeler Paylaşılamaz

Temerrüt

Geçerli: Tüm bölgeler

Bağlantı oluşturmak için parametreler.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim Türü Description Gerekli
Govee API Anahtarı securestring Govee mobil uygulamasından istenebilen Govee API Anahtarı. Doğru

Azaltma Sınırları

Name Çağrılar Yenileme Dönemi
Bağlantı başına API çağrıları 100 60 saniye

Eylemler

Cihaz Bilgilerini Alma

Govee cihazlarınız hakkında ayrıntılı bilgilere erişin. Bu uç nokta, MAC adresi ve modeliyle birlikte sağlandığında belirli bir cihazın verilerini alır. Belirli bir cihaz belirtilmezse, uç nokta hesabınızla ilişkili tüm cihazlara ilişkin bilgileri döndürür. Yanıt, cihaz adı, denetlenebilirlik, alınabilirlik, desteklenen komutlar ve ek özellikler gibi cihaz ayrıntılarını içerir. Bu, Govee cihazlarınızın özelliklerini ve geçerli yapılandırmasını anlamak için kullanışlıdır.
Cihazda Komut Çalıştır

Govee cihazında belirli bir komutu yürütür. Bu uç nokta, cihazın güç durumu, parlaklık, renk ve renk sıcaklığı gibi çeşitli yönlerini denetlemenizi sağlar. Komut ayrıntılarıyla birlikte cihazın MAC adresini ve modelini sağlayın. Desteklenen komutlar arasında güç denetimi için 'turn', parlaklık düzeylerini ayarlamak için 'parlaklık', RGB renk değerlerini ayarlamak için 'renk' ve renk sıcaklığını ayarlamak için 'colorTem' bulunur.

Cihaz Bilgilerini Alma

İşlem Kimliği:
GetDeviceInformation

Govee cihazlarınız hakkında ayrıntılı bilgilere erişin. Bu uç nokta, MAC adresi ve modeliyle birlikte sağlandığında belirli bir cihazın verilerini alır. Belirli bir cihaz belirtilmezse, uç nokta hesabınızla ilişkili tüm cihazlara ilişkin bilgileri döndürür. Yanıt, cihaz adı, denetlenebilirlik, alınabilirlik, desteklenen komutlar ve ek özellikler gibi cihaz ayrıntılarını içerir. Bu, Govee cihazlarınızın özelliklerini ve geçerli yapılandırmasını anlamak için kullanışlıdır.

Parametreler

Name Anahtar Gerekli Tür Description
Cihaz MAC Adresi
 device string

Bilgilerin istendiği Govee cihazının MAC adresini temsil eden isteğe bağlı bir parametre. Sağlanırsa, API özellikle bu cihaz için ayrıntıları döndürür. Hesapla ilişkili tüm cihazların bilgilerini almak için bu parametreyi boş bırakın.
Cihaz Modeli
 model string

Govee cihazının modelini gösteren isteğe bağlı bir parametre. Belirtilirse, API bu modelle eşleşen cihazlar için bilgi döndürür. Bu parametre, Cihaz MAC Adresi ile birlikte kullanılabilir.

Döndürülenler

Name Yol Tür Description
Cihazlar
 data.devices array of object

Hesapla ilişkilendirilmiş cihazların listesi. Belirli bir cihaz istenirse, listede yalnızca bir cihaz bulunur.
Cihaz MAC Adresi
 data.devices.device string

Cihazın benzersiz MAC adresi
Cihaz Modeli
 data.devices.model string

Cihazın model numarası
Cihaz Adı
 data.devices.deviceName string

Cihazın adı
Kontrol
 data.devices.controllable boolean

Cihazın denetlenebilir olup olmadığını gösterir
Minimum
 data.devices.properties.colorTem.range.min integer

En düşük renk sıcaklığı değeri
Maximum
 data.devices.properties.colorTem.range.max integer

Maksimum renk sıcaklığı değeri
Alınabilir
 data.devices.retrievable boolean

Cihazın alınabilir olup olmadığını gösterir
Desteklenen Komutlar
 data.devices.supportCmds array of string

Cihaz için desteklenen komutlar
Message
 message string

İşlemin sonucunu açıklayan bir ileti
Durum Kodu
 code integer

Yanıtın HTTP durum kodu

Cihazda Komut Çalıştır

İşlem Kimliği:
RunCommandOnDevice

Govee cihazında belirli bir komutu yürütür. Bu uç nokta, cihazın güç durumu, parlaklık, renk ve renk sıcaklığı gibi çeşitli yönlerini denetlemenizi sağlar. Komut ayrıntılarıyla birlikte cihazın MAC adresini ve modelini sağlayın. Desteklenen komutlar arasında güç denetimi için 'turn', parlaklık düzeylerini ayarlamak için 'parlaklık', RGB renk değerlerini ayarlamak için 'renk' ve renk sıcaklığını ayarlamak için 'colorTem' bulunur.

Parametreler

Name Anahtar Gerekli Tür Description
Cihaz MAC Adresi
 device True string

Govee cihazının benzersiz MAC adresi. Bu tanımlayıcı, denetlemek istediğiniz cihazı belirtmek için kullanılır.
Cihaz Modeli
 model True string

Govee cihazınızın model numarası. Bu bilgiler, cihaz için kullanılabilen belirli özellikleri ve özellikleri tanımlamaya yardımcı olur.
Komut Adı
 name True string

Cihazda yürütülecek komut. Bu nesne komut adını (örneğin, 'turn', 'parlaklık', 'color', 'colorTem') ve ilişkili değerini içerir. Komut adı, cihazda gerçekleştirilecek eylem türünü belirler.
Dönmek
 turn string

Bu parametre, cihazı açmak veya kapatmak için kullanılır. Bunu yalnızca 'turn' komutu seçildiğinde kullanın. Geçerli değerler 'açık' veya 'kapalı'.
Parlaklık
 brightness integer

Cihaz için ayarlanacağı parlaklık düzeyi. Bu parametreyi yalnızca 'parlaklık' komutu seçildiğinde kullanın. 0 (minimum parlaklık) ile 100 (maksimum parlaklık) arasında bir değer girin.
Renk - Kırmızı
 r integer

Bu parametre, cihaz için RGB renk değerinin kırmızı bileşenini temsil eder. 'color' komutunun bir parçasıdır. 0 ile 255 arasında bir tamsayı değeri belirtin; burada 0, kırmızı olmadığı anlamına gelir ve 255 kırmızının maksimum yoğunluğunu temsil eder.
Renk - Yeşil
 g integer

Bu parametre, cihaz için RGB renk değerinin yeşil bileşenini tanımlar. 'color' komutuyla birlikte kullanılır. 0 ile 255 arasında, yeşil olmadığını belirten 0 ve en yüksek yeşil yoğunluğunu belirten 255 olan bir tamsayı değeri sağlayın.
Renk - Mavi
 b integer

Cihazda ayarlanacağı RGB renk değerinin mavi bileşeni. Bu parametre 'color' komutunun bir parçasıdır. Değer, 0 ile 255 arasında bir tamsayı olmalıdır; burada 0 mavinin olmamasıdır ve 255 en parlak maviyi gösterir.
Renk Sıcaklığı
 colorTem integer

Cihaz için ayarlanacağı renk sıcaklığı değeri. Bu parametreyi yalnızca 'colorTem' komutu seçildiğinde kullanın. Cihazınızın gerektirdiği renk sıcaklığı değerini girin.

Döndürülenler

Name Yol Tür Description
Durum Kodu
 code integer

Yanıtın HTTP durum kodu
Message
 message string

İşlemin sonucunu açıklayan bir ileti
veriler
 data object

Yanıtla birlikte döndürülen veriler.