导入素材
- 输出文件夹已放入 iPad 的**「文件」**App
manifest.json与clips/文件夹在同一目录下、在一起
- 在主界面点击 导入素材
- 点击蓝色的 导入素材 按钮
- iOS 文件浏览器打开，已筛选为
.json文件 - 选择
manifest.json
处理过程中按钮显示 导入中…。成功后出现绿色的 已导入 N 个击球 卡片。
确认卡片下方可能出现琥珀色警告卡片。此时导入已经写入完成 —— 若警告较为严重，请在素材页删除该素材并从源头修正。
| 警告 | 含义 | 处理方式 |
|---|---|---|
| 视角警告 | 素材并非接球方视角 | 严重。结果无法与接球方视角结果比较，建议重新拍摄 |
| N 个片段文件在磁盘上缺失 | clips/ 文件夹未随清单一同传输 | 删除后连同片段一起重新传输并导入 |
| N 个击球帧未经确认 | 新导入时属正常 | 运行测试前先完成标注 |
| FL、BC 等区域没有击球 | 部分区域缺少样本 | 强制选择的实际范围比表面更窄，正确率会虚高。请补充缺失区域的击球 |
| 未标记知情同意 | 该素材未记录同意 | 涉及可识别个人的素材请记录知情同意 |
若清单无效，将出现红色 错误 卡片且不会导入任何内容。完整原因列表见清单格式。
最常见的几种：
- 清单架构版本不受支持 —— 桌面脚本与应用版本不一致
- 该视频已导入 —— 请先删除已有副本
- 区域代码未定义 —— 击球清单中使用了其他项目的区域代码
在主界面点击 素材 可查看全部已导入内容。每张卡片显示素材 id、帧率与分辨率，以及状态标签：
| 标签 | 含义 |
|---|---|
| 击球数：N | 该组素材的击球总数 |
| 待标注：N（琥珀色） | 击球帧尚未确认 |
| 就绪（绿色） | 全部击球已确认 —— 可安全用于测试 |
| 已排除：N | 标注过程中被您排除的击球 |
| 侧面视角（红色） | 非接球方视角 |
| 未记录同意（红色） | 同意字段为 false 或缺失 |
点击素材卡片上的垃圾桶图标。确认提示为：「删除该素材及其全部击球？已完成的测试将保留。」
删除素材不会删除已完成的测试 —— 但会失去追溯这些结果所用片段的能力。