Skip to content

摄像头 ​

本章说明如何把已纳入 Olink 的摄像头(含经品牌适配器接入的型号)导出到苹果「家庭」查看实时画面,以及可选的 RTSP 输出。面向最终用户与部署管理员,不涉及协议或开发细节。

摄像头能力属于融合中枢的媒体管线 + 出口,与具体品牌适配器解耦:适配器负责把设备拉进统一模型,再按需出桥。

这篇讲什么 ​

Olink 可以把已接入的摄像头:

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

普通灯、开关等设备可以挂在桥接器下;摄像头必须走单配件(不能塞进多配件桥接器)。控制台可用「一键转 HomeKit」把摄像头做成单配件,并在此选择摄像头协议(经典 / 直通)。

能力说明 ​

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

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

使用前准备 ​

  1. 已按 快速开始 部署并打开 Olink 控制台(或小程序)。
  2. 已完成对应适配器接入(例如 品牌适配器:米家):授权、加载设备,摄像头出现在设备列表且在线。
  3. 运行 Olink 的机器与摄像头、手机处于可互通的网络环境(一般同一局域网更稳)。
  4. 了解环境依赖(界面会提示安装,通常无需手动找包):
    • 适配器侧摄像头 SDK(若该适配器需要):启用拉流前需就绪;
    • FFmpeg:选经典协议、需要转码时要就绪;直通 / 低延时不强制安装。

接入步骤(三步) ​

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

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

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

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

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

管理后台:

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

小程序:

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

注意:

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

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

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

  1. 打开控制台 「一键转 HomeKit」(或 HomeKit 区域中的摄像头 / 单配件入口)。摄像头走的是单配件桥接器,不是多配件桥接器里的「添加配件」。
  2. 选择已完成第一步、且尚未做成 HomeKit 单配件的摄像头。
  3. 在 摄像头协议 中选择 经典 或 直通 / 低延时(选型见 HomeKit 摄像头接入)。选经典且 FFmpeg 未就绪时,可按界面安装,或在点「完成接入」时自动安装。
  4. 使用 iPhone / iPad「家庭」App 扫码配对该摄像头配件(一台摄像头对应一个独立配对信息)。
  5. 配对成功后,在「家庭」中打开该摄像头,应能看到实时画面。

创建成功后,摄像头管理页通常还会出现转码流与 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 做能力探测;探测失败则不会打开开关。

常见平台与引擎对应关系(以探测结果为准):

环境常见硬编引擎
macOSVideoToolbox
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 中是否在线。
  • 首次预览若提示转码中,可稍等再试;仍失败再看界面错误原文。

能看,但每次首次打开很慢 ​

默认无人观看会停上游;再开要重新开流并等关键帧。可在输入流 编辑 → 输入空闲策略 勾选 一直拉取不休眠(耗带宽,建议有线)。见 首次打开比较慢。

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

逐步排查(先确认 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 与多路识别。
  • 安装失败时可重试;探测失败通常表示该台未成功接入,修好后再启用,避免半成品状态。
  • 仍失败时,记录提示原文与大致操作步骤,便于在交流群或售后渠道排查。

相关文档 ​