Question

Home Assistant 当中各类智能家居设备以组件（Components）的形式，通过配置 configuration.yaml 文件接入。本文档整合了中国大陆地区常用的平台组件的接入及配置方法，并以符合中文逻辑的层级展现。

注意： 配置文件修改保存后，请至 配置 —— 通用 —— 配置检查 检查文件格式的正确性！！

请至左侧栏或善用搜索寻找希望适配的设备。

设备分类

Home Assistant 以设备类型作为设备接入的参考及分类依据，目前支持以下类型：

• Alarm - 警报
• Automation - 自动化
• Binary Sensor - 二进制传感器
• Calendar - 日历
• Camera - 摄像机
• Climate - 气象
• Cover - 屏障，如窗帘、车库门、卷帘门
• DIY
• Downloading - 下载工具
• Energy - 能源
• Fan - 风扇
• Finance - 金融
• Front End - 前端
• Health - 健康
• History - 历史记录
• Hub - 中枢
• Image Processing - 图像处理
• Intent - 动机
• Light - 灯具
• Lock - 锁
• Mailbox - 邮箱
• Media Player - 媒体播放器
• Notification - 通知推送
• Organization - 组织
• Presence Detection - 存在性监测
• Remote - 遥控
• Scene - 场景
• Sensor - 传感器
• Social - 社交媒体
• Switch - 开关
• System Monitor - 系统控制
• Telegram chatbot
• Text-to-speech - 文字转语音
• Transport - 交通工具
• Utility -
• Vacuum - 吸尘器&扫地机
• Voice - 语音
• Weather - 天气
• Other

---

接入方法

大部分的设备遵循 Home Assistant 的分类逻辑，配置时需要遵循分类原则，即

同类设备需包含在大类下，以枚举的方式加入平台。例如：

light:  #灯具
  - platform: yeelight  #yeelight 灯 
  •••
  - platform: xiaomi_miio #小米灯
  •••
  •••
media_player:       #媒体播放器
  - platform: kodi
  •••
  - platform: itunes
•••
•••

同时，同一大类在 configuration.yaml 中不可重复出现。如以下的错误示例：

light:  #灯具
  - platform: yeelight  #yeelight 灯 
  •••
  •••
light:
  - platform: xiaomi_miio #小米灯

以上的配置是绝对错误的，出现了 2 次 light大类，将导致系统出错，设备接入失败。

---

特殊情况

部分设备的组件开发较早或者比较特殊，未纳入系统分类，可以独立配置。如 Hub 中枢内的大部分平台，都需要独立配置。例如：

xiaomi_aqara:
•••
alexa:
•••

本文档将帮助大家淡化 Home Assistant 杂乱无章的分类。

文档中所有『示例配置』都将包括所属大类，应用时请注意各设备间的内部整合。如果没有，则表明该设备独立成类。