项目分支: v0.7_camera_rtsp

PR 状态: 正在等待官方合并 (PR #149)


📖 简介

在使用 xiaomi-miloco 的过程中,为了增强系统的视觉感知能力和扩展性,我基于 官方v0.1.2 版本基础上开发了一个新的功能分支。

该分支重点实现了 RTSP 协议的全面支持。这不仅意味着你可以将外部的 IP摄像头接入 Miloco,还能将小米设备摄像头的画面以RTSP服务形式提供出去。目前该功能已提交 PR 给官方,在正式合并前,欢迎有动手能力的开发者拉取我的分支进行测试和交流。

✨ 主要功能特性

1. 支持 RTSP 摄像头接入 (RTSP In)

允许在配置文件中添加外部 RTSP 摄像头源,扩展视觉输入能力。

  • 多路支持: 支持配置多个 IP 摄像头。

  • 稳定性优化: 增加了针对 RTSP 摄像头的连接心跳检测机制。

2. 小米摄像头 RTSP 服务化 (RTSP Out)

除了接收视频流,我还实现了将小米设备的板载摄像头画面转化为 RTSP Server。

  • 实时监控: 你可以使用 VLC 等播放器连接设备的 IP 地址,实时查看摄像头的画面。

3. 跨平台验证

该功能代码已在以下环境中调试通过:

  • Linux (X86 架构)

  • macOS (Apple Silicon M2 / M系列芯片)


⚠️ 已知限制 (Known Issues)

在尝鲜之前,请注意以下技术细节:

  • Web UI 预览限制: 目前在 Miloco 的 Web 界面上查看视频流时,仅支持 H.265 编码格式。H.264 格式的视频流暂时无法在网页端直接播放。

  • AI 功能不受影响: 即使是 H.264 格式,虽然网页看不了视频,但后台的 AI 交互逻辑依然可以正常获取并处理图片帧。这应该属于 Web UI 前端的支持问题,暂时未深入修改前端代码。


🚀 如何尝鲜 (How to Test)

由于该功能尚未合并到官方主分支,你需要克隆我的个人 Fork 仓库并切换到对应分支:

1. 拉取代码

请使用 git 命令拉取 v0.7_camera_rtsp 分支:

Bash

git clone -b v0.7_camera_rtsp https://github.com/huangyajie/xiaomi-miloco.git
cd xiaomi-miloco
2. 修改配置

config/server_config.yaml 中配置:

参考:https://github.com/XiaoMi/xiaomi-miloco/pull/149

3. 启动服务

按照官方文档的常规步骤启动服务即可

注:源码方式安装及启动:https://github.com/XiaoMi/xiaomi-miloco/blob/main/docs/development/developer-setup_zh_Hans.md


🤝 反馈与交流

如果你在使用过程中遇到问题,或者有关于代码改进的建议,欢迎在我的 PR 下留言讨论,或者在仓库中提交 Issue。

Logo

openvela 操作系统专为 AIoT 领域量身定制,以轻量化、标准兼容、安全性和高度可扩展性为核心特点。openvela 以其卓越的技术优势,已成为众多物联网设备和 AI 硬件的技术首选,涵盖了智能手表、运动手环、智能音箱、耳机、智能家居设备以及机器人等多个领域。

更多推荐