核心用法
Raspberry Pi Camera Service 是一款专为树莓派设计的摄像头控制 Skill，通过 HTTP API 实现对 CSI（树莓派官方摄像头模块）和 USB 摄像头的统一管理。用户可通过 Python SDK 快速完成拍照、录制 H264/MP4/GIF 等多种操作，支持会话级的心跳监控与自动超时保护机制。
典型使用流程包含两种模式：单次操作模式（如 capture() 拍照、record_video() 定长录制）和手动控制模式（start_recording() + stop_recording()），后者适用于需根据外部条件动态控制录制时长的场景，如配合舵机运动同步录制。SDK 会自动维护心跳以防止服务端因客户端异常断开而持续占用资源。
显著优点
- 硬件兼容性：自动检测 CSI 摄像头并回退到 USB 摄像头，降低部署门槛
- 格式灵活性：原生 H264 硬件编码速度快，后台异步转换为 MP4/GIF 不阻塞主流程
- 可靠性设计：会话隔离 + 心跳超时机制有效防止资源泄漏，多客户端场景下通过 423 状态码避免冲突
- 开发友好：FastAPI 提供的 HTTP 接口配合 Python SDK，集成成本极低
潜在缺点与局限性
- 部署依赖：需预先部署服务端，首次使用需阅读部署文档
- 硬件绑定：核心功能依赖树莓派硬件环境，无法跨平台使用
- 转换延迟：MP4/GIF 为后台异步转换，获取最终文件需等待或轮询
- 网络依赖：HTTP 通信对局域网稳定性有要求，高延迟场景可能影响心跳维护
适合人群
物联网开发者、树莓派爱好者、需要低成本视觉监控方案的自动化场景搭建者，尤其适合需要录制条件触发视频（如机械运动同步记录）的技术用户。
常规风险
- 资源占用：长时间录制可能产生大体积文件，需关注存储空间
- 会话泄漏：若客户端崩溃且未正常关闭，依赖心跳超时（默认 30 秒）释放资源
- 格式兼容性：H264 原始流需特定播放器支持，直接分享可能受限