2025.3.4
首页 ▸ Integrations ▸

Avi-on

支持 Avi-on 蓝牙调光开关 Avi-on。

设置

如果您想手动添加设备（如下面的示例），则需要获取 API 密钥。可以通过执行以下命令来获得 API 密钥：

$ curl -X POST -H "Content-Type: application/json" \
    -d '{"email": "fakename@example.com", "password": "password"}' \
    https://api.avi-on.com/sessions | jq

其中，电子邮件和密码字段替换为通过移动应用程序注册设备时使用的字段。输出的密码短语字段应作为配置中的 API 密钥使用。

配置

要启用这些灯光，请将以下行添加到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中。 在更改了configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件后，重启 Home Assistant 以应用更改。 该集成现在显示在集成页面的 设置 > 设备与服务 下。其实体在集成卡片上以及实体标签上列出。

# 示例 configuration.yaml 条目
light:
  - platform: avion

配置此集成有两种方式：用户名和密码，或设备列表。您必须选择其中一种。

Configuration Variables

Looking for your configuration file?
username string (Optional)

在 Avion 应用中使用的用户名。如果同时提供了用户名和密码，则所有关联的开关将自动添加到您的配置中。

password string (Optional)

在 Avion 应用中使用的密码。

devices list (Optional)

一个可选的设备列表及其蓝牙地址。

name string (Optional)

在前端使用的自定义名称。

api_key string Required

API 密钥。

id string Required

调光器的 ID。仅在独立控制多个设备时需要。

完整示例

如果未提供用户名和密码，则必须像下面这样手动配置设备：

# 手动设备 configuration.yaml 条目
light:
  - platform: avion
    devices:
      00:21:4D:00:00:01:
        name: 灯光 1
        api_key: YOUR_API_KEY

要独立控制多个设备，必须指定每个设备的 ID（从 1 开始的整数）。每个开关的 ID 可以从 Avi-on API 中猜测或检测到。

# 手动设备 configuration.yaml 条目
light:
  - platform: avion
    devices:
      00:21:4D:00:00:01:
        name: 灯光 1
        api_key: YOUR_API_KEY
        id: 1
      00:21:4D:00:00:02:
        name: 灯光 1
        api_key: YOUR_API_KEY
        id: 2