cc6e137994
CLAUDE.md: - 新增「文档管理」章节，明确文档分类和更新策略 - 核心原则：不创建需要手工同步的文档 删除过时文档: - PROJECT_STRUCTURE.md（代码即结构） - docs_index.md（直接浏览目录） 归档历史设计文档: - PRD/TECHSPEC/IXSPEC 移入 docs/archive/ 统一应用名称: - 所有文档中 "Live Photo Maker" → "Live Photo Studio" 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
253 lines
5.8 KiB
Markdown
253 lines
5.8 KiB
Markdown
# Live Photo Studio 用户手册
|
||
|
||
## 快速开始
|
||
|
||
### 第一步：导入视频
|
||
|
||
1. 打开 App，在首页点击「选择视频」按钮
|
||
2. 从相册中选择一段视频（建议 2-5 秒）
|
||
3. 等待视频加载完成，自动跳转到编辑页
|
||
|
||
> 💡 **提示**：首次使用需要授权相册访问权限
|
||
|
||
---
|
||
|
||
### 第二步：编辑参数
|
||
|
||
#### 比例模板
|
||
- **iPhone 锁屏**：9:19.5，适合设置为锁屏壁纸
|
||
- **全面屏**：9:16，适合全面屏手机
|
||
- **4:3**：经典比例
|
||
|
||
#### 时长调整
|
||
- 使用滑块选择视频片段（1-1.5 秒）
|
||
- Live Photo 标准时长约 0.9 秒
|
||
|
||
#### 画面裁剪
|
||
- **双指缩放**：调整画面大小
|
||
- **拖拽移动**：调整画面位置
|
||
|
||
#### 封面帧选择
|
||
- 滑动选择器选择静态封面帧
|
||
- 预览区域实时显示效果
|
||
|
||
#### 兼容模式（推荐开启）
|
||
- 自动将视频转换为最兼容的格式
|
||
- 参数：720p / 30fps / H.264 / SDR
|
||
- 适用于：4K 视频、HDR 视频、HEVC 编码视频
|
||
|
||
---
|
||
|
||
### 第三步：生成 Live Photo
|
||
|
||
1. 点击「生成 Live Photo」按钮
|
||
2. 等待处理完成（通常 10-30 秒）
|
||
3. 生成成功后自动保存到相册
|
||
|
||
#### 处理阶段说明
|
||
| 阶段 | 说明 |
|
||
|------|------|
|
||
| normalize | 视频格式标准化 |
|
||
| extractKeyFrame | 提取封面帧 |
|
||
| writePhotoMetadata | 写入照片元数据 |
|
||
| writeVideoMetadata | 写入视频元数据 |
|
||
| saveToAlbum | 保存到相册 |
|
||
| validate | 校验 Live Photo |
|
||
|
||
---
|
||
|
||
### 第四步：设置为壁纸
|
||
|
||
#### iOS/iPadOS 17+ 设置方法
|
||
|
||
1. 打开系统「照片」App
|
||
2. 找到刚保存的 Live Photo（左上角有 LIVE 标识）
|
||
3. 点击左下角「分享」按钮
|
||
4. 选择「用作壁纸」
|
||
5. **重要**：确保 Live Photo 图标已开启（高亮状态）
|
||
6. 点击「添加」完成设置
|
||
7. 锁屏后长按屏幕测试动态效果
|
||
|
||
#### iOS/iPadOS 16 限制
|
||
|
||
⚠️ iOS/iPadOS 16 系统不支持将 Live Photo 设置为带动态效果的锁屏壁纸。
|
||
|
||
- 可以设置为普通静态壁纸
|
||
- 升级到 iOS/iPadOS 17+ 可获得完整体验
|
||
|
||
---
|
||
|
||
## 设置页功能
|
||
|
||
### 权限状态
|
||
- 显示当前相册权限状态
|
||
- 如未授权，可点击「前往设置授权」
|
||
|
||
### 清理缓存
|
||
- 显示当前缓存大小
|
||
- 清理缓存不会影响已保存的 Live Photo
|
||
|
||
### 清空最近作品记录
|
||
- 仅清除 App 内的作品记录
|
||
- 不会删除相册中的 Live Photo
|
||
|
||
### 导出诊断报告
|
||
- 用于反馈问题时附带
|
||
- 仅包含日志和参数，不含媒体内容
|
||
|
||
---
|
||
|
||
## 常见问题 FAQ
|
||
|
||
### Q1: 为什么长按壁纸没有动画效果？
|
||
|
||
**可能原因及解决方案**：
|
||
|
||
1. **低电量模式已开启**
|
||
- 前往「设置 → 电池」关闭低电量模式
|
||
|
||
2. **Live Photo 效果未开启**
|
||
- 设置壁纸时，确保 Live Photo 图标为高亮状态
|
||
|
||
3. **系统版本不支持**
|
||
- iOS/iPadOS 16 不支持锁屏动态效果
|
||
- 升级到 iOS/iPadOS 17+ 可解决
|
||
|
||
4. **照片不是 Live Photo**
|
||
- 在相册中确认照片左上角有「LIVE」标识
|
||
|
||
---
|
||
|
||
### Q2: 生成失败怎么办？
|
||
|
||
**尝试以下步骤**：
|
||
|
||
1. **开启兼容模式**
|
||
- 适用于高分辨率、HDR、特殊编码的视频
|
||
|
||
2. **缩短选择时长**
|
||
- 选择 1 秒左右的片段
|
||
|
||
3. **更换视频素材**
|
||
- 尝试使用 iPhone 原生拍摄的视频
|
||
|
||
4. **清理缓存后重试**
|
||
- 前往「设置 → 清理缓存」
|
||
|
||
5. **重启 App**
|
||
- 完全退出后重新打开
|
||
|
||
---
|
||
|
||
### Q3: 相册里找不到 LIVE 标识？
|
||
|
||
**可能原因**：
|
||
|
||
1. **照片未正确保存**
|
||
- 检查保存时是否提示成功
|
||
|
||
2. **查看方式不对**
|
||
- 在「照片」App 中查看，不是「文件」App
|
||
|
||
3. **滤镜显示**
|
||
- 在「照片」App 中，点击「相簿 → 媒体类型 → Live Photo」查看
|
||
|
||
---
|
||
|
||
### Q4: 为什么建议开启兼容模式？
|
||
|
||
某些视频格式可能不被系统完全支持为 Live Photo 的配对视频：
|
||
|
||
| 素材类型 | 建议 |
|
||
|---------|------|
|
||
| 4K 视频 | 开启兼容模式 |
|
||
| HDR 视频 | 开启兼容模式 |
|
||
| HEVC (H.265) | 开启兼容模式 |
|
||
| H.264 1080p | 可不开启 |
|
||
|
||
兼容模式会将视频转换为：
|
||
- 分辨率：720p
|
||
- 帧率：30fps
|
||
- 编码：H.264
|
||
- 色彩：SDR
|
||
|
||
---
|
||
|
||
### Q5: 支持哪些视频格式？
|
||
|
||
**支持的格式**：
|
||
- MP4 / MOV / M4V
|
||
- H.264 / HEVC (H.265) 编码
|
||
- SDR / HDR 色彩空间
|
||
- 任意分辨率（会自动缩放）
|
||
- 任意帧率（会自动调整）
|
||
|
||
**不支持**：
|
||
- 网络视频链接
|
||
- 非视频文件
|
||
|
||
---
|
||
|
||
### Q6: Live Photo 占用多少存储空间？
|
||
|
||
单个 Live Photo 通常占用 **2-5 MB**：
|
||
- 静态照片：约 1-2 MB
|
||
- 配对视频：约 1-3 MB
|
||
|
||
开启兼容模式后，文件体积会更小。
|
||
|
||
---
|
||
|
||
## 错误代码说明
|
||
|
||
| 错误代码 | 含义 | 建议操作 |
|
||
|---------|------|---------|
|
||
| LPB-001 | 导入失败 | 检查视频格式，换一个视频重试 |
|
||
| LPB-101 | 标准化失败 | 开启兼容模式重试 |
|
||
| LPB-201 | 提取帧失败 | 缩短视频时长，开启兼容模式 |
|
||
| LPB-301 | 元数据写入失败 | 清理缓存后重试 |
|
||
| LPB-401 | 保存失败 | 检查相册权限，检查存储空间 |
|
||
| LPB-901 | 未知错误 | 导出诊断报告并反馈 |
|
||
|
||
---
|
||
|
||
## 技术规格
|
||
|
||
### 输出参数
|
||
|
||
| 参数 | 标准模式 | 兼容模式 |
|
||
|------|---------|---------|
|
||
| 照片分辨率 | 最高 1080p | 720p |
|
||
| 视频分辨率 | 最高 1080p | 720p |
|
||
| 视频帧率 | 60fps | 30fps |
|
||
| 视频编码 | 保持原编码 | H.264 |
|
||
| 色彩空间 | 保持原色彩 | SDR |
|
||
| 时长 | ~0.9 秒 | ~0.9 秒 |
|
||
|
||
### 系统要求
|
||
|
||
- **最低支持**：iOS/iPadOS 16.0
|
||
- **完整体验**：iOS/iPadOS 17.0+
|
||
- **存储空间**：建议剩余 100 MB 以上
|
||
|
||
---
|
||
|
||
## 隐私说明
|
||
|
||
- 所有处理均在本地完成
|
||
- 不上传任何媒体内容到服务器
|
||
- 仅在用户明确操作时访问相册
|
||
- 诊断报告不包含媒体内容
|
||
|
||
---
|
||
|
||
## 反馈与支持
|
||
|
||
如遇到问题，请通过以下方式反馈：
|
||
|
||
1. 在 App 内「设置 → 导出诊断报告」
|
||
2. 将诊断报告通过邮件发送给我们
|
||
3. 描述问题发生的步骤和现象
|
||
|
||
我们会尽快处理您的反馈！
|