摄像头

本章说明如何把米家摄像头接到苹果「家庭」App 中查看实时画面，以及可选的 RTSP 输出。面向最终用户与部署管理员，不涉及协议或开发细节。

这篇讲什么

Olink 可以把已接入的米家摄像头：

1. 导出为 HomeKit 独立摄像头配件，在「家庭」里打开实时预览；
2. （可选）提供 RTSP 地址，供局域网内其他播放器或录像软件使用。

普通灯、开关等设备可以挂在桥接器下；摄像头必须走单配件，不能加入桥接器，也不能通过「一键转 HomeKit」批量创建。

能力说明

能力	状态	说明
在「家庭」中实时看画面	支持	打开摄像头配件即可直播
控制台 / 小程序内预览	支持	启用后可先确认 Olink 已拉到画面（一般需同一局域网）
直播时的声音（听）	支持	「家庭」实时预览可带声音（具体以设备与协商结果为准）；控制台预览通常以画面为主
RTSP 输出给其他播放器	支持	需在控制台启用/查看地址，通常限同一局域网
HomeKit Secure Video（家庭 App 云录像 / 智能通知那套）	暂不支持	请继续用米家 App 或第三方方案做录像
双向对讲（从「家庭」对摄像头说话）	暂不支持	只能看 / 听，不能从家庭 App 回传对讲
门铃按键、移动侦测等事件推送到「家庭」	暂不保证	以当前版本实际表现为准，不要按完整门铃配件预期
始终清晰的封面快照	有限	列表缩略图可能来自缓存；无人观看时不一定会主动唤醒摄像头刷新

能力会随版本演进。若界面或帮助与本文不一致，以当前版本界面提示为准。

使用前准备

1. 已按 快速开始 部署并打开 Olink 控制台（或小程序）。
2. 已完成 米家网关与映射：授权、加载设备，摄像头出现在设备列表且在线。
3. 运行 Olink 的机器与摄像头、手机处于可互通的网络环境（一般同一局域网更稳）。
4. 了解环境依赖（界面会提示安装，通常无需手动找包）：
   • 米家摄像头 SDK：启用摄像头拉流前需要就绪；
   • FFmpeg：创建 HomeKit 摄像头单配件、做画面转码前需要就绪。

接入步骤（三步）

心智记三步：启用 → 预览确认有画面 → 再做成家庭 App 可配对的独立配件。
中间预览可尽快发现问题；跳过也能做第三步，但不推荐。

第一步：在米家侧启用摄像头

1. 打开控制台 「米家」（或小程序对应设备列表）。
2. 若提示「米家摄像头 SDK 未就绪」，先按界面完成安装，再继续。
3. 找到目标摄像头，执行启用 / 接入（过程中可能有编码探测进度，请等待完成）。
4. 成功后：
   • 设备会出现在 Olink 接入结果中；
   • 摄像头管理页一般会出现该设备的输入流（表示 Olink 已登记该路画面来源）。

此时还不能在「家庭」里看到配件；建议先做第二步预览，再进入第三步。

第二步：在 Olink 里预览画面

在接到 HomeKit 之前，先确认 Olink 已经能拉到这台摄像头的画面。

管理后台：

1. 打开 摄像头管理 页。
2. 在输入流列表中找到刚启用的摄像头，点击该行打开预览。
3. 弹框中应出现实时画面。看完后关闭弹框即可（预览是临时会话，不会变成一条新的「输出流」）。

小程序：

1. 打开该摄像头的设备详情。
2. 在预览区域点击播放（默认不自动播）。
3. 能出画面即表示接入正常；离开页面或停止播放会结束本次预览。

注意：

• 预览一般要求浏览器 / 手机与 Olink 同一局域网；跨网或访客 Wi-Fi 隔离时可能提示仅支持局域网预览。
• 首次出画可能稍慢（尤其需要转码时），请稍等；长时间无画面再查米家是否在线、第一步是否启用成功。
• 控制台预览主要用于确认链路，与「家庭」里的正式直播不是同一条路径。

预览正常后，再做第三步；若预览已失败，先解决拉流问题，再创建 HomeKit 配件，可少走弯路。

第三步：创建 HomeKit 摄像头单配件

1. 打开控制台 「HomeKit」 区域中的摄像头 / 单配件入口（不是桥接器的「添加配件」，也不是「一键转 HomeKit」）。
2. 若提示 FFmpeg 未就绪，先按界面安装。
3. 从列表中选择已完成第一步、且尚未创建单配件的摄像头，创建独立配件。
4. 使用 iPhone / iPad「家庭」App 扫码配对该摄像头配件（一台摄像头对应一个独立配对信息）。
5. 配对成功后，在「家庭」中打开该摄像头，应能看到实时画面。

创建成功后，摄像头管理页通常还会出现转码流与 HomeKit 输出相关状态；真正出画面往往发生在有人预览或「家庭」打开直播时（按需拉流，空闲时可能显示已配置但未推流）。

为什么桥接器里找不到摄像头？

这是预期行为：摄像头不会出现在桥接器「添加配件」和「一键转 HomeKit」列表中。请始终使用摄像头专用的单配件入口。

可选：RTSP 输出

若你需要用 VLC、NAS、NVR 等拉取画面，可使用 RTSP：

1. 在控制台摄像头相关页面查看该设备的 RTSP 地址（或启用 RTSP 后再复制）。
2. 用播放器打开该地址；设备需能访问运行 Olink 的主机。
3. 注意访问控制：RTSP 会把画面暴露给能连上该地址的客户端，请勿把地址泄漏到公网，并按控制台提供的认证选项妥善配置。

仅完成第一步、未做 HomeKit 单配件时，仍可能先用 RTSP；是否已启用以控制台状态为准。

转码注意

接到 HomeKit 后，多数米家摄像头需要经 FFmpeg 转成家庭 App 可用的画面。转码会额外占资源，建议提前了解下面几点。

CPU 占用偏高是正常现象

默认多为软件编码（CPU 转码）。出现下列情况时，主机 CPU 会明显升高，属预期：

• 「家庭」或控制台正在看直播；
• 同时开多路摄像头；
• 源画面是高分辨率 / H.265，需要转成 H.264。

无人观看时一般会按需停流，CPU 会回落。若长期满载导致卡顿、掉线，请减少同时观看路数，或开启硬件转码（见下）。

硬件转码能减轻 CPU

在摄像头管理页的转码流工具栏，可尝试开启硬件转码。开启时会对本机 FFmpeg 做能力探测；探测失败则不会打开开关。

常见平台与引擎对应关系（以探测结果为准）：

环境	常见硬编引擎
macOS	VideoToolbox
Linux（Intel / AMD）	VAAPI
Linux / Windows（NVIDIA）	CUDA（NVENC）
部分 ARM 板卡	V4L2、Rockchip MPP（rkmpp）等

说明：

• 芯片标称支持硬编 ≠ 一定能开成功。必须以当前正在使用的那个 FFmpeg 探测通过为准。
• 默认自动下载的通用静态 FFmpeg，在不少板卡上不含对应硬编编码器，探测会全部失败——这时需要换成带硬编能力的 FFmpeg（见下节）。
• 开关变更后，正在运行的转码通常不会自动重建；按界面提示重启转码 / 重新打开直播后才会按新配置生效。
• 界面旁注一般会显示「软编」或「硬编·引擎名」，便于确认是否真的走了硬件。

FFmpeg 目录：可以自行替换

Olink 选用 FFmpeg 的大致顺序是：

1. 系统 PATH 里能直接运行的 ffmpeg；
2. 数据目录下的 {数据目录}/ffmpeg/ffmpeg（Docker 常见为挂载的 /data/ffmpeg/ffmpeg）；
3. 以上都没有时，再按需下载到上述目录。

因此你可以自行替换数据目录里的二进制，例如：

1. 准备一份本机可用的 ffmpeg（需带目标硬编编码器，且能在本机跑通）。
2. 备份原文件后，用新文件覆盖 {数据目录}/ffmpeg/ffmpeg（或做成指向新二进制的软链接），并保证可执行权限。
3. 若希望优先用系统已安装的 FFmpeg，也可把它放进 PATH，让 Olink 直接找到。
4. 替换后回到摄像头页重新做一次硬件转码探测 / 开启；也可打开 FFmpeg 相关调试页查看当前实际使用的路径与探测结果。

注意：替换错误或不兼容的二进制会导致转码失败、黑屏；请先在本机命令行验证 ffmpeg -version，以及目标编码器（如 h264_videotoolbox / h264_vaapi / h264_rkmpp 等）是否存在。

转码排查步骤

按顺序排查，多数问题能定位：

1. 确认是否在转码
   摄像头管理页是否出现转码流；无人观看时可能是空闲，打开「家庭」或预览后再看 CPU / 状态。

2. 确认 FFmpeg 可用
   界面是否仍提示未安装；数据目录下是否有 ffmpeg；必要时重新安装或按上一节替换。

3. 软件转码：CPU 是否顶满
   顶满时先减路数、关多余预览；仍不够再考虑硬编或换更强主机。

4. 硬件转码开不起来

   • 看提示是否为「未探测到可用硬编引擎」；
   • 确认当前用的不是「无硬编」的通用静态包；
   • 替换为带对应编码器的 FFmpeg 后重新探测；
   • 板卡还需内核设备节点、用户态库等齐全（以本机文档 / 发行版说明为准）。

5. 已开硬编但仍像软编
   看旁注是否仍是「软编」；开硬编后是否已按提示重启转码；调试页里实际编码参数是否已变为硬编编码器名。

6. 硬编后黑屏 / 花屏
   先关掉硬件转码回退软编验证链路；再换其他 FFmpeg 构建或更新驱动 / 固件后重试。

常见问题

第二步预览打不开 / 一直转圈

• 浏览器或手机是否与 Olink 同一局域网。
• 第一步是否启用成功；输入流列表里是否已有该设备。
• 摄像头在米家 App 中是否在线。
• 首次预览若提示转码中，可稍等再试；仍失败再看界面错误原文。

能配对，但打开一直加载或黑屏

• 先回到第二步：控制台 / 小程序预览是否正常。预览就没有画面时，先别在「家庭」里反复试。
• 摄像头在米家 App 中是否在线、能否正常看直播。
• 第一步是否启用成功；摄像头管理页是否有对应输入流。
• FFmpeg / SDK 是否仍显示异常；可按界面提示重试安装。
• Olink 主机 CPU / 网络是否过载；多路同时观看会明显加重负载。
• 手机与 Olink、摄像头是否跨网段或经访客 Wi-Fi 隔离。

画面卡顿、延迟高

• 优先保证有线或稳定的 5 GHz Wi-Fi；避免弱信号与远距离中继。
• 减少同时观看的客户端数量。
• 高分辨率摄像头转码更吃资源，可先只开一台验证。
• 主机 CPU 长期打满时，参阅上文 转码注意，尝试硬件转码或自行更换带硬编的 FFmpeg。

能看画面，但不能对讲

• 当前版本不支持从「家庭」向摄像头双向对讲。听得到环境声（若设备与链路支持）不等于能对讲。

没有 Secure Video 录像 / 人物通知

• 当前版本不支持 HomeKit Secure Video。录像与智能通知请继续使用米家或其他方案。

启用摄像头或创建配件失败

• 看界面错误提示：常见原因是 SDK / FFmpeg 未装好、探测失败、摄像头离线。
• 安装失败时可重试；探测失败通常表示该台未成功接入，修好后再启用，避免半成品状态。
• 仍失败时，记录提示原文与大致操作步骤，便于在交流群或售后渠道排查。

相关文档

• 米家网关与映射 — 授权、加载设备、映射
• HomeKit 桥接与配件 — 桥接器与普通配件（摄像头请用本文单配件流程）
• 接入设备与区域 — Olink 设备列表
• 常见问题 — 其他通用问题