摄像头
本章说明如何把已纳入 Olink 的摄像头(含经品牌适配器接入的型号)导出到苹果「家庭」查看实时画面,以及可选的 RTSP 输出。面向最终用户与部署管理员,不涉及协议或开发细节。
摄像头能力属于融合中枢的媒体管线 + 出口,与具体品牌适配器解耦:适配器负责把设备拉进统一模型,再按需出桥。
这篇讲什么
Olink 可以把已接入的摄像头:
- 导出为 HomeKit 独立摄像头配件,在「家庭」里打开实时预览;
- (可选)提供 RTSP 地址,供局域网内其他播放器或录像软件使用。
普通灯、开关等设备可以挂在桥接器下;摄像头必须走单配件(不能塞进多配件桥接器)。控制台可用「一键转 HomeKit」把摄像头做成单配件,并在此选择摄像头协议(经典 / 直通)。
能力说明
| 能力 | 状态 | 说明 |
|---|---|---|
| 在「家庭」中实时看画面 | 支持 | 打开摄像头配件即可直播 |
| 控制台 / 小程序内预览 | 支持 | 启用后可先确认 Olink 已拉到画面(一般需同一局域网) |
| 直播时的声音(听) | 支持 | 「家庭」实时预览可带声音(具体以设备与协商结果为准);控制台预览通常以画面为主 |
| RTSP 输出给其他播放器 | 支持 | 需在控制台启用/查看地址,通常限同一局域网 |
| HomeKit Secure Video(家庭 App 云录像 / 智能通知那套) | 暂不支持 | 请继续用米家 App 或第三方方案做录像 |
| 双向对讲(从「家庭」对摄像头说话) | 暂不支持 | 只能看 / 听,不能从家庭 App 回传对讲 |
| 门铃按键、移动侦测等事件推送到「家庭」 | 暂不保证 | 以当前版本实际表现为准,不要按完整门铃配件预期 |
| 始终清晰的封面快照 | 有限 | 列表缩略图可能来自缓存;无人观看时不一定会主动唤醒摄像头刷新 |
能力会随版本演进。若界面或帮助与本文不一致,以当前版本界面提示为准。
使用前准备
- 已按 快速开始 部署并打开 Olink 控制台(或小程序)。
- 已完成对应适配器接入(例如 品牌适配器:米家):授权、加载设备,摄像头出现在设备列表且在线。
- 运行 Olink 的机器与摄像头、手机处于可互通的网络环境(一般同一局域网更稳)。
- 了解环境依赖(界面会提示安装,通常无需手动找包):
- 适配器侧摄像头 SDK(若该适配器需要):启用拉流前需就绪;
- FFmpeg:选经典协议、需要转码时要就绪;直通 / 低延时不强制安装。
接入步骤(三步)
心智记三步:启用 → 预览确认有画面 → 再做成家庭 App 可配对的独立配件。
中间预览可尽快发现问题;跳过也能做第三步,但不推荐。
第一步:在米家侧启用摄像头
- 打开控制台 「米家」(或小程序对应设备列表)。
- 若提示「米家摄像头 SDK 未就绪」,先按界面完成安装,再继续。
- 找到目标摄像头,执行启用 / 接入(过程中可能有编码探测进度,请等待完成)。
- 成功后:
- 设备会出现在 Olink 接入结果中;
- 摄像头管理页一般会出现该设备的输入流(表示 Olink 已登记该路画面来源)。
此时还不能在「家庭」里看到配件;建议先做第二步预览,再进入第三步。
第二步:在 Olink 里预览画面
在接到 HomeKit 之前,先确认 Olink 已经能拉到这台摄像头的画面。
管理后台:
- 打开 摄像头管理 页。
- 在输入流列表中找到刚启用的摄像头,点击该行打开预览。
- 弹框中应出现实时画面。看完后关闭弹框即可(预览是临时会话,不会变成一条新的「输出流」)。
小程序:
- 打开该摄像头的设备详情。
- 在预览区域点击播放(默认不自动播)。
- 能出画面即表示接入正常;离开页面或停止播放会结束本次预览。
注意:
- 预览一般要求浏览器 / 手机与 Olink 同一局域网;跨网或访客 Wi-Fi 隔离时可能提示仅支持局域网预览。
- 首次出画可能稍慢(尤其需要转码时),请稍等;长时间无画面再查米家是否在线、第一步是否启用成功。
- 控制台预览主要用于确认链路,与「家庭」里的正式直播不是同一条路径。
预览正常后,再做第三步;若预览已失败,先解决拉流问题,再创建 HomeKit 配件,可少走弯路。
第三步:创建 HomeKit 摄像头单配件
- 打开控制台 「一键转 HomeKit」(或 HomeKit 区域中的摄像头 / 单配件入口)。摄像头走的是单配件桥接器,不是多配件桥接器里的「添加配件」。
- 选择已完成第一步、且尚未做成 HomeKit 单配件的摄像头。
- 在 摄像头协议 中选择 经典 或 直通 / 低延时(选型见 HomeKit 摄像头接入)。选经典且 FFmpeg 未就绪时,可按界面安装,或在点「完成接入」时自动安装。
- 使用 iPhone / iPad「家庭」App 扫码配对该摄像头配件(一台摄像头对应一个独立配对信息)。
- 配对成功后,在「家庭」中打开该摄像头,应能看到实时画面。
创建成功后,摄像头管理页通常还会出现转码流与 HomeKit 输出相关状态;真正出画面往往发生在有人预览或「家庭」打开直播时(按需拉流,空闲时可能显示已配置但未推流)。
为什么多配件桥接器里找不到摄像头?
这是预期行为:摄像头不会作为普通配件塞进多配件桥接器。请用「一键转 HomeKit」或摄像头单配件入口单独配对。
摄像头协议:经典 vs 直通 / 低延时
接入单配件时需选择推流协议:经典(H.264,兼容最好,H.265 源需转码)或 直通 / 低延时(H.265 免转码,需 iOS 27+)。
功能对比、截图与怎么选,见常见问题专题 HomeKit 摄像头接入。转码占用、软硬编解概念见 软编硬编与软解硬解;逐步操作仍见下文 转码注意。
可选:RTSP 输出
米家摄像头经 SDK 拉流 → 本机 RTSP 服务 → 新建输出流 可得到局域网 RTSP 地址,供 VLC / NAS / NVR 使用。完整步骤与截图见常见问题 如何提取米家摄像头的 RTSP?。
摘要:启用摄像头出现输入流 → 输出流服务启用 RTSP(端口 / 账号)→ 新建输出流选上游并复制 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 的大致顺序是:
- 系统 PATH 里能直接运行的
ffmpeg; - 数据目录下的
{数据目录}/ffmpeg/ffmpeg(Docker 常见为挂载的/data/ffmpeg/ffmpeg); - 以上都没有时,再按需下载到上述目录。
因此你可以自行替换数据目录里的二进制,例如:
- 准备一份本机可用的
ffmpeg(需带目标硬编编码器,且能在本机跑通)。 - 备份原文件后,用新文件覆盖
{数据目录}/ffmpeg/ffmpeg(或做成指向新二进制的软链接),并保证可执行权限。 - 若希望优先用系统已安装的 FFmpeg,也可把它放进 PATH,让 Olink 直接找到。
- 替换后回到摄像头页重新做一次硬件转码探测 / 开启;也可打开 FFmpeg 相关调试页查看当前实际使用的路径与探测结果。
注意:替换错误或不兼容的二进制会导致转码失败、黑屏;请先在本机命令行验证 ffmpeg -version,以及目标编码器(如 h264_videotoolbox / h264_vaapi / h264_rkmpp 等)是否存在。
转码排查步骤
按顺序排查,多数问题能定位:
确认是否在转码
摄像头管理页是否出现转码流;无人观看时可能是空闲,打开「家庭」或预览后再看 CPU / 状态。确认 FFmpeg 可用
界面是否仍提示未安装;数据目录下是否有ffmpeg;必要时重新安装或按上一节替换。软件转码:CPU 是否顶满
顶满时先减路数、关多余预览;仍不够再考虑硬编或换更强主机。硬件转码开不起来
- 看提示是否为「未探测到可用硬编引擎」;
- 确认当前用的不是「无硬编」的通用静态包;
- 替换为带对应编码器的 FFmpeg 后重新探测;
- 板卡还需内核设备节点、用户态库等齐全(以本机文档 / 发行版说明为准)。
已开硬编但仍像软编
看旁注是否仍是「软编」;开硬编后是否已按提示重启转码;调试页里实际编码参数是否已变为硬编编码器名。硬编后黑屏 / 花屏
先关掉硬件转码回退软编验证链路;再换其他 FFmpeg 构建或更新驱动 / 固件后重试。
常见问题
第二步预览打不开 / 一直转圈
- 浏览器或手机是否与 Olink 同一局域网。
- 第一步是否启用成功;输入流列表里是否已有该设备。
- 摄像头在米家 App 中是否在线。
- 首次预览若提示转码中,可稍等再试;仍失败再看界面错误原文。
能看,但每次首次打开很慢
默认无人观看会停上游;再开要重新开流并等关键帧。可在输入流 编辑 → 输入空闲策略 勾选 一直拉取不休眠(耗带宽,建议有线)。见 首次打开比较慢。
能配对,但打开一直加载或黑屏
逐步排查(先确认 H.264 / H.265,仍不行再输入抓取交给开发者)见常见问题:配对后一直转圈。
简要清单:
- 先回到第二步:控制台 / 小程序预览是否正常。预览就没有画面时,先别在「家庭」里反复试。
- 输入流 codec 是 H.264 还是 H.265;当前协议是经典还是直通,二者是否匹配。
- 摄像头在米家 App 中是否在线;FFmpeg / 转码流在打开「家庭」时是否在跑。
- Olink 主机 CPU / 网络是否过载;手机与 Olink、摄像头是否跨网段或访客 Wi-Fi 隔离。
画面卡顿、延迟高
- 优先保证有线或稳定的 5 GHz Wi-Fi;避免弱信号与远距离中继。
- 减少同时观看的客户端数量。
- 高分辨率摄像头转码更吃资源,可先只开一台验证。
- 主机 CPU 长期打满时,参阅上文 转码注意,尝试硬件转码或自行更换带硬编的 FFmpeg。
能看画面,但不能对讲
- 当前版本不支持从「家庭」向摄像头双向对讲。听得到环境声(若设备与链路支持)不等于能对讲。
没有 Secure Video 录像 / 人物通知
- 当前版本不支持 HomeKit Secure Video。录像与智能通知请继续使用米家或其他方案。
启用摄像头或创建配件失败
- 看界面错误提示:常见原因是 SDK / FFmpeg 未装好、探测失败、摄像头离线。
- 米家开了隐私密码却未在接入配置填 隐私 PIN,也会导致拉流失败;双摄少一路时检查 通道数。见 隐私 PIN 与多路识别。
- 安装失败时可重试;探测失败通常表示该台未成功接入,修好后再启用,避免半成品状态。
- 仍失败时,记录提示原文与大致操作步骤,便于在交流群或售后渠道排查。
相关文档
- 米家网关与映射 — 授权、加载设备、映射
- HomeKit 桥接与配件 — 桥接器与普通配件(摄像头请用本文单配件流程)
- 接入设备与区域 — Olink 设备列表
- HomeKit 摄像头接入 — 经典 vs 直通选型
- 如何提取米家摄像头的 RTSP? — SDK 转 RTSP、新建输出流
- 配对后一直转圈 — H.264/H.265 与输入抓取
- 软编硬编与软解硬解 — 硬件转码概念
- RK 系列硬解调试 — Rockchip 硬解排查
- 常见问题 — 其他专题