Govee （獨立發行者） （預覽版）

使用 Govee Developer API 將 Govee 智慧燈裝置整合到您的應用程式中。 控制燈光、改變顏色、調整亮度和設置計時器。 存取即時設備狀態以進行進階應用程式開發。

此連接器適用於以下產品和區域：

戈維

提供與 Govee 智慧 照明系統的無縫集成，使用戶能夠輕鬆控制和管理其設備。 它允許廣泛的功能，包括調整燈光設定、更改顏色、修改亮度和存取即時設備狀態。

自動化和自訂照明設定的能力使該連接器對於增強智慧家庭的氛圍、為各種場合創建動態照明場景以及將智慧照明整合到更廣泛的家庭自動化系統中特別有用。 它為用戶提供了一種方便直觀的方式來個性化他們的照明體驗並充分利用 Govee 智能照明技術的功能。

出版商：理查德·威爾遜

先決條件

您必須先取得 Govee 開發人員 API 金鑰，才能使用 Govee 連接器。 請依照下列步驟取得金鑰：

取得 Govee 開發人員 API 金鑰

1. 下載 Govee Home 應用程序：

   • 適用於 iOS： App Store 上的 Govee Home
   • 對於 Android： Google Play 上的 Govee Home

2. 訪問您的個人資料：

   • 打開 Govee Home 應用程序並點擊個人資料圖標 （）👤 導航到“我的個人資料”頁面。

3. 前往設定：

   • 按一下右上角的設定圖示 （⚙️） 以存取「設定」選單。

4. 申請 API Key：

   • 在「設定」選單中選擇「申請 API 金鑰」。

5. 填寫申請表：

   • 填寫「姓名」和「申請理由」的必填欄位。
     • 示例原因包括家庭自動化、第三方集成或教育目的。

6. 同意服務條款：

   • 請仔細閱讀 Govee Developer API 服務條款。 理解條款後，請選中該框以表明您接受。

7. 提交申請：

   • 按一下「提交」以傳送您的 API 金鑰申請。 一旦獲得批准，您將收到您的 Govee API 密鑰，這是使用此連接器所必需的。

請注意，API 金鑰審批過程可能需要一些時間，批准由 Govee 自行決定。 請確定您的應用程式包含要求 API 金鑰的有效且明確的理由，以增加核准的可能性。

支援的作業

1. 在設備上運行命令

此操作允許您發送各種命令來控制您的 Govee 設備。

• 輸入屬性：
  • 設備MAC地址： 要控制的 Govee 裝置的唯一 MAC 位址。
  • 設備型號： Govee 裝置的型號。
  • 命令詳細資料： 包含要執行的命令的物件。 這包括：
    • 名字： 命令名稱（例如，'turn'、'brightness'、'color'、'colorTem'）。
  • 其他參數（基於命令）：
    • 轉動： （可選）“打開”或“關閉”- 當命令為“轉動”時使用。
    • 亮度： （可選）數值 （0-100） - 當命令為“亮度”時使用。
    • 顏色： （可選）具有 'r'、'g'、'b' 值的物件 - 當命令為 'color' 時使用。
    • 色溫： （選用）色溫的數值 - 當命令為 'colorTem' 時使用。

2. 獲取設備信息

檢索有關特定 Govee 設備或與您的帳戶關聯的所有設備的信息。

• 輸入屬性：
  • 裝置 MAC 位址： （選用）請求資訊的特定 Govee 裝置的 MAC 位址。 如果省略，則會傳回所有裝置的資訊。
  • 裝置型號： （可選）Govee 裝置的型號。 如果與MAC地址一起指定，則會將查詢細化到該特定裝置。

API 文件

有關 Govee Lights Developer API 的詳細信息，包括其功能、端點、參數和響應，請參閱 官方 Govee API 文件。 此文件提供全面的指導和範例，幫助您在應用程式和工作流程中有效地整合和利用 API。

已知問題和限制

目前，不存在已知問題或限制。 請務必參閱本節以取得更新資訊。

正在建立連線

連接器支援下列驗證類型：

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

節流限制

動作

取得裝置資訊

在裝置上執行命令