2025.3.4
首页 ▸ Integrations ▸

小米

本节介绍如何将 小米路由器 或小米摄像头集成到 Home Assistant 中。

相机

小米 相机集成允许您在 Home Assistant 中使用小米摄像头。

前提条件

  • 为了成功实现此集成，Home Assistant 主机应能够进行多次同时读取。
    • 对于每个并发的 Home Assistant 用户，每 10 秒将与摄像头建立一次连接。这通常不会有问题。

准备设备

  1. 要将相机与 Home Assistant 集成，必须在设备上安装自定义固件。
  2. 安装完成后，请确保已启用 FTP。

Warning

当前，支持的自定义固件版本是 0.1.4-beta2。高于此版本的固件使用 Pure-FTPd，该固件存在一个错误，导致 FFmpeg 无法正确渲染视频文件。

Important

Raspbian 用户：请不要忘记在您的平台上安装 ffmpeg 支持，否则您将看不到视频。

Note

当 Home Assistant 通过 FTP 读取 Yi 720p 和小方摄像头时，相机的实时流写入不是支持的格式，因此该平台检索的是早于 1 分钟保存的视频。

Tip

如果您启用了 RTSP 服务器，您可以通过其他 Home Assistant 摄像头平台连接到您的相机。然而，这个 RTSP 服务器禁用了使用非常有用的米家应用程序的能力。为了维护 Home Assistant 兼容性 和 本地应用程序，该平台通过 FTP 检索视频。

配置

要启用相机，请将以下行添加到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中：

camera:
  - platform: xiaomi
    name: Camera
    host: "192.168.1.100"
    model: "yi"
    password: YOUR_PASSWORD

Configuration Variables

Looking for your configuration file?
name string Required

相机的友好名称。

host template Required

相机的 IP 地址或主机名。

model string Required

小米相机的型号，目前支持 yi 和 xiaofang。

password string Required

相机上 FTP 服务器的密码（如上所述），可以是任何字符串，因为当前固件不允许设置 ftp 密码。

path string (Optional)

原始 MP4 文件的路径。

Default:

/media/mmcblk0p1/record

username string (Optional, default: root)

可以访问 FTP 服务器的用户。

ffmpeg_arguments string (Optional)

传递给 ffmpeg 的额外选项。

Important

path: 的默认值并不适用于所有相机。可能需要您添加该键以适应您的设备的确切路径。

图像质量

通过 ffmpeg_arguments 配置参数，可以利用任何由 ffmpeg 相机 支持的选项。

一个特别有用的调整与视频大小有关。由于 Yi 视频相当大（尤其是在 1080p 摄像头上），以下配置将其缩小到可管理的大小：

camera:
  - platform: xiaomi
    name: My Camera
    host: "192.168.1.100"
    model: "xiaofang"
    password: YOUR_PASSWORD
    path: /home/camera/feed
    ffmpeg_arguments: "-vf scale=800:450"

主机名模板

主机名/IP 地址可以提供一个值或来自现有的 entity实体表示 Home Assistant 中的传感器、执行器或功能。实体用于监控物理属性或控制其他实体。实体通常是设备或服务的一部分。 [Learn more] 属性。

camera:
  - platform: xiaomi
    name: Front Camera
    host: ""
    model: "yi"
    password: 1234
    path: /tmp/sd/record

路由器

小米 路由器集成通过查看连接到 小米 路由器的设备提供存在检测。

配置

要在您的安装中使用小米路由器，请将以下内容添加到您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中：

# 示例 configuration.yaml 条目
device_tracker:
  - platform: xiaomi
    host: YOUR_ROUTER_IP
    password: YOUR_ADMIN_PASSWORD

Configuration Variables

Looking for your configuration file?
host string Required

您路由器的 IP 地址，例如 192.168.0.1。

username string (Optional, default: admin)

管理员用户名。

password string Required

管理员帐户的密码。

请参阅 设备跟踪器集成页面 以获取配置要跟踪人员的说明。

兼容性测试

要确保您的路由器兼容，请导航到 http://YOUR_ROUTER_IP/api/misystem/devicelist。 您应该会看到当前连接到路由器的设备列表。

然而，一些用户报告说，即使前面的 URL 不起作用，他们也能够将 Mi Router 3 集成到 Home Assistant 中。例如，一些使用 Mi Router 3 和固件版本 2.10.46 稳定版的用户成功集成了他们的路由器，测试集成的替代 URL 是 http://YOUR_ROUTER_IP/cgi-bin/luci/api/misystem/devicelist。导航到此页面应显示 {"code":401,"msg":"Invalid token"} 消息。

相关主题