🤖AI-generated documentation✓ curatedAI Generated
About content generation types
(e.g., docs generated from codebase analysis)
(e.g., livestream → blog post, meeting notes → docs)
(e.g., hand-written tutorial)
初学者教程
本教程在快速开始的基础上，详细介绍摄像头选择、配置和录制。
选择摄像头
当您点击检测摄像头时，SkellyCam 会扫描所有可用的 USB 视频类（UVC）摄像头。这包括大多数 USB 网络摄像头（如 Logitech C270、C920）和笔记本电脑内置摄像头。虚拟摄像头（如 OBS 虚拟摄像头）默认会被过滤掉。
检测完成后，您将看到可用摄像头列表。选择您要使用的摄像头，然后点击应用创建摄像头组。每个选定摄像头都会显示实时预览画面。
检测摄像头：POST /skellycam/camera/detect — 创建或更新摄像头组：POST /skellycam/camera/group/apply。详见 API 参考。
配置摄像头
界面中摄像头配置面板的截图，展示分辨率、帧率、曝光、曝光模式和旋转设置，并标注各控制项。
摄像头组中的每个摄像头都可以独立配置。界面中的配置面板允许您调整以下设置：
| 设置 | 默认值 | 描述 |
|---|---|---|
| 分辨率 | 1280 x 720 | 以像素为单位的捕获分辨率。如果摄像头不支持请求的分辨率，OpenCV 会回退到最接近的支持分辨率。 |
| 帧率 | 摄像头默认值 | 目标捕获帧率。保持默认值（-1）以硬件允许的最快速度运行，或设置特定值（如 30）。 |
| 曝光 | -7 | 与硬件相关的曝光值。数值越负 = 曝光时间越短。有效范围取决于您的摄像头型号。 |
| 曝光模式 | MANUAL | 在 MANUAL、AUTO 或 RECOMMENDED 之间选择。 |
| 旋转 | 无 | 捕获后通过软件旋转图像：顺时针 90°、180° 或逆时针 90°。 |
RECOMMENDED 模式不会简单地设置一个默认值。它会循环测试多个曝光设置，并选择比将平均像素亮度最接近半最大值（大约 255 中的 127.5）的设置低一级的选项。这会产生比我们通常为标准摄像头使用选择的稍暗的图像——这是一个经过深思熟虑的选择，在可见性和低曝光时间之间取得平衡，以最大限度减少运动模糊。注意：界面会记住会话之间的摄像头设置。使用 Ctrl+R（强制刷新）可清除已保存的设置。
摄像头配置作为摄像头组的一部分发送：POST /skellycam/camera/group/apply。完整请求模式详见 API 参考。
录制音频
在开始录制之前，您可以选择麦克风来同时捕获音频和视频。界面会显示可用的音频输入设备——选择一个即可在录制中包含音频。
检测麦克风：GET /skellycam/camera/microphone/detect。详见 API 参考。
点击录制开始。所有摄像头捕获同步帧，同时并行录制音频。点击停止完成录制。
音频录制是一个正在积极开发的领域：
查看录制内容
导航到录制内容页面浏览已保存的会话。每个录制显示以下元数据：
- 摄像头数量
- 文件大小
- 时长
- 帧率
- 帧数
录制按最新优先排序。
回放
选择一个录制以打开帧锁定回放查看器。主要功能：
- 帧锁定同步 — 所有摄像头始终显示相同的帧号，没有偏移
- 逐帧步进 — 逐帧前进和后退
- 可变速度 — 调整回放速度
- 键盘快捷键 — 通过键盘控制回放
录制保存位置
默认情况下，录制保存在 ~/skellycam_data/recordings/。每次录制会话都有自己的文件夹，包含同步视频文件和时间戳数据。
要详细了解录制文件夹结构和数据模型，请参阅进阶教程。