# 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. 描述问题发生的步骤和现象

我们会尽快处理您的反馈！