# Home Assistant 集成（HACS）

用官方自定义集成把云瞰的摄像头、检测与录像带进 Home Assistant——通过 HACS 一键安装，无需 MQTT broker。

云瞰现已提供官方 Home Assistant 自定义集成。它是一个薄客户端，通过云瞰服务器常规 API 通信，把服务器能力映射成 Home Assistant 原生实体、媒体浏览器和服务——所有录制、检测和账号逻辑都留在服务器端。

[![Open in HACS](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=mrtian2016&repository=yunkan-hass-integration&category=integration)

以自定义仓库方式在你的 Home Assistant HACS 里打开本仓库。

## 你能得到什么

- **摄像头**：原生 WebRTC（低延迟，HLS 兜底）+ JPEG 快照——画面预览卡、区域仪表盘、导出 HomeKit、`camera.snapshot`。
- **检测传感器**（每相机）：人、车、动物、包裹、人脸、跌倒、婴儿哭声、移动——并带上识别到的姓名 / 车牌。
- **对象计数**传感器 + **识别人名 / 车牌**传感器。
- **开关**：AI 检测、录像、逐特性检测开关、PTZ 自动追踪——外加挂在 hub 上的服务器级检测开关。
- **设备页控件**：刷新快照与 PTZ 方向按钮、PTZ 预置位下拉、喊话输入框。
- **设备触发器与动作**用于自动化，另附开箱即用的通知蓝图。
- **媒体浏览器**浏览录像、事件与快照，全程经 Home Assistant 自身鉴权代理。

## 前置要求

- Home Assistant **2024.11** 或更新（原生 WebRTC 摄像头需要）。
- 一台可访问的云瞰服务器——填它的主入口地址（nginx 入口，通常端口 `23406`）。
- 一个云瞰账号。PTZ、检测开关和喊话需要 **管理员** 账号；查看用任意账号即可。

## 通过 HACS 安装

1. **在 HACS 中打开**

   点击上方 **在 HACS 中打开** 按钮（或在 HACS 里点右上角三点菜单 → 自定义仓库，填入仓库地址，类别选 *Integration*）。

2. **安装并重启**

   在 HACS 里搜索 **Yunkan** 安装，然后重启 Home Assistant。

3. **添加集成**

   进入 **设置 → 设备与服务 → 添加集成 → Yunkan**，填入服务器地址、用户名和密码。

> **ℹ️ 以自定义仓库方式安装**
>
> 云瞰还没上架 HACS 默认商店（收录申请审核中），所以以**自定义仓库**方式安装——上方按钮会帮你完成。上架后即可直接搜索安装。

## 免费档 vs Pro

摄像头、快照、事件、传感器、媒体浏览器和 PTZ 在任意云瞰服务器上都能用。**AI 检测** 和 **喊话** 是 Pro 功能；免费档下这些操作会弹升级提示，而不是静默失败。

> **💡 与 MQTT 发现并存**
>
> 如果你同时用了云瞰的 MQTT 发现，两条路线以不同实体 ID 并存。本集成是更完整、面向 Pro 的另一条路线，且不需要 MQTT broker。

---

来源:https://yun-kan.com/zh-CN/docs/home-assistant