常见问题
这里汇总使用 Olink 时最常遇到的概念与选型说明。左侧为二级导航;每篇可独立阅读,需要逐步操作时文内会链到对应帮助文档。
HomeKit 配对与配件
| 专题 | 说明 |
|---|---|
| 配对卡在连接中 | 未认证弹窗、搜索页、mDNS / 网卡 / 重名 |
| 无法添加配件(Accessory out of compliance) | 复制映射交给 AI 初步排查;多设备先拆复杂设备 |
| 配件输出配置:补温度 / 湿度 | 原理、跨设备 attr_id、保存后如何核对服务/特征 |
| 自适应灯光 | 使用、运行原理(曲线→写色温);首次开启可能自动开灯 |
摄像头与视频
| 专题 | 说明 |
|---|---|
| HomeKit 摄像头接入 | 单配件怎么接、经典 vs 直通 / 低延时怎么选 |
| 配对后一直转圈 | 确认 H.264 / H.265,不行再抓输入流给开发者 |
| 如何提取米家摄像头的 RTSP? | SDK 转 RTSP、服务设置、新建输出流拿地址 |
| 隐私 PIN 与多路识别 | pin_code、同型号多台区分、双摄 channel_count |
| 首次打开比较慢 | 开流 + 等关键帧;「一直拉取不休眠」换速度、耗带宽 |
| 软编 / 硬编与软解 / 硬解 | 经典转码时 CPU 与硬件加速怎么选 |
| RK 系列硬解调试 | Rockchip rkmpp:探测、输入抓取、板上对照 |
设备与 AI
| 专题 | 说明 |
|---|---|
| 米家授权后网络错误 | .local mDNS 失败;粘贴完整回调或改成 IP |
| 为何监听 / 接管 8123 | 米家回调必须 :8123;与 HA 冲突可关监听并手动粘贴 |
| 设备常离线问题 | 三路 OR 原理、云/本地网关差异、force_online |
| 连接小智 AI | MCP 原理、接入流程、Olink 提供的控制工具 |
排障与版本
| 专题 | 说明 |
|---|---|
| 如何开启 Debug 日志 | 改 log4rs.yaml 的 root.level: debug |
| 如何开启远程调试 | 仅硬件版;输入管理员调试码,内网穿透临时隧道 |
| 抓取 iOS 日志 | Mac 上 idevicesyslog -p homed,配对/转圈排查 |
| 开发版(Beta)功能页 | /#/beta 安装开发包;Docker 不支持 |
| 后续规划 | MQTT、Matter 等后续方向 |
版本更新见顶栏 更新日志。
排障步骤(黑屏、配对失败、转码等)仍以帮助文档 摄像头 为主。