米家摄像头:隐私 PIN 与多路识别
米家摄像头在 Olink 里常见两类配置问题:
- 隐私 PIN:米家 App 开了隐私密码后,不填 PIN 则拉流失败。
- 多路识别:同型号多台、或双摄多通道时,分不清是哪一路 / 通道数不对。
二者都在设备的 接入配置 里处理(表单字段或 TOML:pin_code、channel_count)。
在哪里改
- 打开控制台 米家 设备列表,找到目标摄像头。
- 进入该设备 → 接入配置(弹窗标题多为「… · 接入配置」)。
- 表单里有 隐私 PIN、通道数;也可在下方 TOML 里写
pin_code/channel_count。 - 保存 后再生效;改 PIN / 通道后建议重新预览或重新启用摄像头确认。
toml
# 米家开启隐私密码时必填,4 位数字
pin_code = "1234"
# 双摄等:覆盖通道数(1–8);不写则机型表 / 默认 1
channel_count = 2隐私 PIN(pin_code)
什么时候要填
米家 App 里给摄像头设置了 隐私密码 后,SDK 开流需要同一组 PIN。未提供时,常见错误含义包括:
| 情况 | 说明 |
|---|---|
| 已设隐私密码但未提供 PIN | Olink 侧未配置 pin_code,开流被拒绝 |
| 读取隐私密码状态失败 | 设备侧状态读不到,先确认米家在线、再核对 SDK / 网络 |
预览黑屏、启用失败、日志里出现隐私相关错误时,优先核对是否开了隐私密码。
怎么填
- 与米家 App 中设置的 同一组 4 位数字。
- 在接入配置 隐私 PIN 填入并保存(空 = 清除;须恰好 4 位数字)。
- 再打开 摄像头管理 预览,或重新启用后看输入流是否出画。
注意:PIN 写在设备接入配置里,按 该台摄像头的 MIoT did 生效;多台摄像头各自填各自的,不要混用。
多路摄像头:怎么认、怎么配
「多路」常见两种场景,不要混为一谈。
1. 家里多台摄像头(同型号尤甚)
同型号多台时,列表名往往很像,容易接错、配对错。
建议:
- 看 did(米家数字 ID /
mijia.{did}.cam),与米家 App 设备信息对照。 - 在 Olink 里改 显示名、划到不同 区域,便于一眼区分。
- HomeKit 单配件配对时,一次只开一台确认画面,再编下一台;名称在「家庭」里也可再改成「客厅」「门口」等。
隐私 PIN、通道数都是 按台 配的;不要把 A 机的 PIN 填到 B 机接入配置上。
2. 一台双摄 / 多通道机(channel_count)
部分机型一个物理设备有多路镜头。Olink 可按通道拆成多路逻辑摄像头:
| 通道 | 逻辑 did 示例 | 展示名 |
|---|---|---|
| 第 1 路(ch0) | mijia.{did}.cam | 原名 |
| 第 2 路(ch1) | mijia.{did}.cam.ch1 | 原名·镜头2 |
| 第 N 路 | mijia.{did}.cam.ch{N-1} | 原名·镜头N |
- 不写
channel_count:用机型表或默认 1(只出一路.cam)。 - 双摄却只出现一路:在接入配置把 通道数 设为
2(或实际镜头数,最大 8),保存后重新启用 / 刷新摄像头。 - 多通道共用同一会话与同一
pin_code;PIN 仍填在该物理设备的接入配置上即可。 - 每一路仍是 独立 HomeKit 单配件(或独立 RTSP 输出);配对 / 预览时用「·镜头2」等后缀区分。
机型表已正确时不必手写通道数;只有识别成单路、或多出来的路不对时再覆盖。
排查顺序
- 米家 App 能否正常看该摄像头;是否开了隐私密码。
- 开了密码 → 接入配置填对 隐私 PIN → 再预览。
- 多台同型号 → 用 did / 改名 / 分区认机,避免串配。
- 双摄缺路 → 调 通道数,看是否出现
·镜头2等输入流。 - 仍失败 → 看界面错误原文;需要时可按 配对后一直转圈 做输入抓取。
相关文档
- 摄像头 — 启用 → 预览 → HomeKit 单配件
- HomeKit 摄像头接入
- 如何提取米家摄像头的 RTSP?
- 设备常离线问题 — 同属接入配置的
force_online - 常见问题总览