【插件教程】如何在Ulanzi Studio中实现Govee灯光直连控制
如何在Ulanzi Studio中实现Govee灯光直连控制介绍
Govee 插件是一款专为提升智能灯光控制效率而设计的强大工具，它允许您通过 Ulanzi Studio 宏键盘直接与您的 Govee 智能灯光设备进行通信，无需借助任何第三方平台（如 Home Assistant）。您可以将复杂的灯光场景和常用操作简化为一键触发，无论是为直播布光、营造观影氛围，还是优化工作环境，都能显著提高便利性和效率。
该插件支持以下核心功能：
1.**Power On / Off（开关灯光）**: 告别手机 App，实现毫秒级的灯光启停。
2.**Set Brightness（调节亮度）**: 精确控制灯光的明暗程度，一键切换阅读、工作或休憩模式。
3.**Set Color（设定颜色）**: 从 1600 万种颜色中随心选择，打造个性化氛围。
4.**Set Color Temperature（色温调节）**: 在冷暖光之间自由切换，营造最舒适的光线环境。
**适用人群：**
* **内容创作者与主播**：在直播或录制过程中，无需中断操作，即可一键切换预设的布光方案。
* **游戏玩家与影音爱好者**：根据游戏或电影场景，瞬间改变环境光，打造极致的沉浸式体验。
* **办公族与设计师**：快速调整照明以适应不同工作任务，保护视力，提升专注力。
* **智能家居爱好者**：将灯光控制集成到桌面工作流中，享受高效便捷的智能生活。
**使用价值：**
* **极致效率**：将多步操作简化为一键宏，大幅提升灯光控制的响应速度。
* **无缝集成**：直接集成在您的桌面控制中心，无需在手机和电脑间切换。
* **高度定制**：每个按键功能均可自定义，满足您多样化和个性化的场景需求。
* **简洁易用**：直观的图形化配置界面，无需任何编程基础即可轻松上手。
## 学习目标
* 掌握获取 Govee 官方 API 密钥的正确流程。
* 熟练在 Ulanzi Studio 中安装、配置并验证Govee插件。
* 能够独立创建并自定义控制 Govee 灯光**电源、亮度、颜色、色温**的快捷按键。
一、安装UlanziStudio及Govee插件
1.1、安装Ulanzi Studio
- 访问官网下载并安装UlanziStudio软件。
1.2、安装Govee插件
- 启动Ulanzi Studio，点击右上角的“应用商店”，搜索Govee并下载安装。
二、操作步骤
第一步：获取您的 Govee API 密钥
API密钥是让 Ulanzi Studio 与您的 Govee 账户安全通信的唯一凭证。
1.在您的智能手机上，下载并打开 **Govee Home** APP。
2.进入主界面后，点击右下角的 **“我的”** 标签，进入个人中心。
3.在个人中心页面，点击右上角的 **设置图标** (齿轮形状)。
4.在设置菜单中，找到并点击 **“申请API密钥”** 选项。
5.点击申请按钮，系统会为您生成一串独特的API密钥发送到您的邮箱。
6.打开邮箱，查看“Govee API Apply”主题的邮件，复制API KEY，并将其粘贴到安全的地方（如备忘录），以便稍后使用。
完整操作指南请参考官方文档： (https://developer.govee.com/reference/apply-you-govee-api-key)
第二步：在 Ulanzi Studio 中安装并配置 Govee 插件
这是连接软件和硬件的关键一步。
1.启动您电脑上的 Ulanzi Studio 软件，点击顶部导航栏的 **“应用商店”**。
2.在搜索框中输入 **“Govee”** 并回车，找到官方插件后点击 **“安装”**。
3.安装完成后，返回主编辑界面。从左侧的“按键”菜单中，将任意一个Govee动作（例如 **"Power On / Off"**）拖拽到您想设置的实体按键上。
4.此时，软件右侧的属性检查器会自动弹出配置窗口。点击 **“添加新的 Govee 账户”** 按钮。
5.在弹出的认证窗口中，将您在第一步中复制的 **Govee API密钥** 完整地粘贴到输入框内，然后点击 **“保存”**。
6.如果密钥无误，插件会立即开始同步您的设备。您可以在下方的设备下拉菜单中看到您Govee账户下的所有兼容设备，证明连接已成功。
第三步：创建您的专属灯光控制按键
现在，让我们为四个核心功能分别创建按键。
**按键1：智能电源开关 (Power On / Off)**
* **动作**: 从左侧拖动 **"Power On / Off"** 到按键上。
* **配置**:
* **Device**: 在下拉菜单中，选择您想要控制的具体Govee灯具。
* **Action**: 选择 **Toggle**。这能实现“按一下开灯，再按一下关灯”的智能切换效果，最大化利用按键。
**按键2：精准亮度调节 (Set Brightness)**
* **动作**: 拖动 **"Set Brightness"** 到按键上。
* **配置**:
* **Device**: 选择目标灯具。
* **Brightness**: 直接拖动滑块，或者在输入框中填入一个 **0** 到 **100** 之间的数字，代表您想要的亮度百分比。例如，`75` 代表75%的亮度。
**按键3：自定义氛围颜色 (Set Color)**
* **动作**: 拖动 **"Set Color"** 到按键上。
* **配置**:
* **Device**: 选择目标灯具。
* **Color**: 点击颜色预览框。您可以在弹出的调色板中直观地选取颜色，也可以输入精确的 **HEX颜色代码** (例如 `#FF5733` 代表亮橙色)。
**按键4：舒适色温设定 (Set Color Temperature)**
* **动作**: 拖动 **"Set Color Temperature"** 到按键上。
* **配置**:
* **Device**: 选择一个支持色温调节的灯具（部分RGB灯带可能不支持此功能）。
* **Color Temperature**: 输入一个开尔文(K)值。通常范围在 **2000K** (极暖光，类似烛光) 到 **9000K** (极冷光，类似晴空) 之间。例如，`4000K` 是一个非常适合工作的自然白光。
## 小贴士与故障排查
* **Q: 我的设备没有出现在设备列表里？**
* **A:** 首先，请确保您的 Govee 设备已成功连接到家中的 Wi-Fi 网络。其次，只有支持云端 API 控制的 Govee 设备才会显示，部分仅支持蓝牙的早期型号可能不兼容此插件。请在 Govee Home App 中检查设备网络状态。
* **Q: 点击按键后灯光没有反应？**
* **A:** 请检查您的Govee API密钥是否正确无误，尝试重新复制粘贴一次。同时，确保您的电脑网络连接正常，可以访问互联网。您可以尝试在 Govee Home App 中手动控制一下设备，确认设备本身是在线的。
* **Q: 我可以控制 Govee 的音乐律动模式吗？**
* **A:** 目前官方插件主要支持基础控制（开关、亮度、颜色、色温）。对于音乐模式、场景模式等更复杂的功能，支持情况可能因插件版本和设备型号而异。建议关注 Ulanzi Studio 的更新日志。
页:
[1]