MiCamera.Net 是使用 .NET 8 开发的小米摄像头视频桥接 SDK 与服务。它连接 Miloco 获取 H.264/H.265 视频，为多个摄像头通道提供 RTSP 直播、WebRTC 浏览器预览和 JPEG 截图 功能。
| 我想要了解… | 从这里开始 |
|---|---|
| 配置文件结构、字段与迁移 | ⚙️ 配置文件参考 |
| 部署服务、授权、升级与备份 | 🚀 桥接服务部署 |
| 项目分层、拉流与媒体处理原理 | 🧩 架构与实现 |
| HTTP/RTSP 接口与 .NET SDK 接入 | 🔌 接口与 SDK 接入 |
| 从源码开发、构建镜像和生成完整包 | 🛠️ 源码开发与构建包 |
| 登录、黑屏、连接失败与卡顿 | 🔍 故障排查 |
| 功能名称 | 说明 |
|---|---|
| 📷 多通道拉流 | 按配置连接 Miloco；各通道独立连接、超时与退避重连，共享上游认证会话 |
| 🎞️ RTSP 直播 | H.264/H.265 原编码直通，支持 Digest 认证，使用 RTP/RTCP over TCP |
| 📺 WebRTC 预览 | 浏览器接收 H.264；H.264 源直通，H.265 源通过 FFmpeg 按需转码 |
| 🖼️ JPEG 截图 | 关键帧解码与缓存截图，HTTP 获取；支持质量和生成间隔配置 |
| 🔐 访问认证 | HTTP Bearer、RTSP Digest、Miloco PEM 证书固定；Docker secrets 与独立 RTSP 凭据持久化 |
| 🔄 会话恢复 | 上游关键帧同步与重连，WebRTC 超时回收，示例前端解码停滞后重建会话 |
| 🌐 浏览器示例 | React/Vite 前端，摄像头状态、预览、截图历史与 RTSP 首次设置 |
| 📦 部署工具 | 三服务 Docker 向导、amd64/arm64 完整包生成、状态检查与配置备份 |
- 网络：向导面向可信局域网与原生 Linux rootful Docker。Docker Desktop 可构建包，不能直接套用 LAN 部署。首个网页访问者可初始化 RTSP；不要把默认 HTTP 服务或端口转发到公网。
- 编码：
Codec必须与 Miloco 实际输出一致。RTSP 只支持 TCP；NominalFrameRate是时间信息缺失时的回退值，不会提升摄像头帧率。 - 媒体依赖：缺少 FFmpeg 原生库时，RTSP 可直通，但 JPEG 与 H.265 WebRTC 转码不可用。H.265 转码使用 CPU，并发与流畅度需按实际硬件验收。
- 个人隐私：不要提交
.deploy、密码、Token、Cookie 或包含密钥的备份。旧静态 RTSP 部署升级后需网页初始化一次，之后重启和更新保留凭据。 - 验证范围：健康检查不代表真实画面或长期流畅；ARM64 QEMU 检查不等于原生 ARM 验证。具体证据与限制见验收和性能记录。
- 功能范围：当前提供视频、截图与预览，没有音频、录像、对讲、云台和开箱即用的异地访问。
欢迎通过 Issues 反馈问题或提交改进。
开始前阅读 源码开发与构建包；代码变更提交前运行 .NET Release 构建、前端 lint 与生产构建，部署文件变更另做 Bash/Compose 检查。
问题反馈请注明版本或提交、服务器架构、部署方式、摄像头型号/编码、复现步骤，以及脱敏状态和日志。媒体问题说明实际播放时长、帧率、丢包与停顿；不要公开设备 DID、账号数据或访问密钥。排查清单见 故障排查。
| 项目 / 组件 | 用途 |
|---|---|
| micam | 小米摄像头接入的参考项目，以及部署使用的 miiot/Miloco 社区镜像相关实现 |
| SIPSorcery | WebRTC peer、ICE、DTLS、SRTP 与 RTP/RTCP 基础能力 |
| SharpRTSP | 项目使用的 RTSP/RTP 相关依赖 |
适用范围 本项目为开源非营利项目，仅供学术研究或个人测试用途。严禁用于商业服务、网络攻击、数据窃取、系统破坏等违反《网络安全法》及使用者所在地司法管辖区的法律规定的场景。
非官方声明 本项目由第三方开发者独立开发，与小米集团及其关联方（下称"权利方"）无任何隶属/合作关系，亦未获其官方授权/认可或技术支持。项目中涉及的商标、Miloco 镜像固件、云服务的所有权利归属小米集团。若权利方主张权益，使用者应立即主动停止使用并删除本项目。
继续下载或运行本项目，即表示您已完整阅读并同意用户协议，否则请立即终止使用并彻底删除本项目。