Ulanzi Docs

Home Assistant 插件使用指南 ​

借助 Ulanzi Studio 和 Home Assistant 插件，你可以将复杂的智能家居控制变成一键操作：开关灯光、启动场景、控制空调、触发自动化……都只需轻轻一按！

一、准备工作 ​

在开始前，请确保你已经完成以下准备：

  1. Ulanzi Deck 设备：任意型号（如 Ulanzi Deck、Ulanzi Deck Dock 等）。
  2. Ulanzi Studio 软件：已安装，建议最新版。
  3. Home Assistant ：正常运行，建议开启 HTTPS 和创建长令牌。
  4. 局域网访问：Home Assistant 与 Ulanzi Studio 处于同一网络。

二、安装 Home Assistant 插件到 Ulanzi Studio ​

运行 PC 上的 Ulanzi Studio 应用程序，点击右上角的 【应用商店】，在搜索框中输入 Home Assistant，找到插件点击 【安装】 进行安装。

三、连接你的 Home Assistant 账户 ​

步骤 1：获取 Home Assistant 的长期访问令牌（Long-Lived Access Token） ​

  1. 登录 Home Assistant Web 界面（http://your-ip:8123）。
  2. 点击右上角个人头像 > “Long-Lived Access Tokens”。
  3. 创建一个新令牌，例如命名为 Deck，复制保存备用。

注意 ⚠️

该令牌只显示一次，请妥善保存。

步骤 2：在插件中配置连接信息 ​

  1. 在 Ulanzi Studio 插件面板中，拖一个 Home Assistant 实体到任意空位。
  2. 在右侧属性面板中，填写以下信息：
    • Server URL: 填写你的 Home Assistant 本地地址或外网地址，如 http://192.168.1.100:8123
    • Access Token：粘贴你的长期访问令牌。
  3. 点击 “connect”，确保插件能成功连接 Home Assistant。