let5see/to-live-photo
1
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity
Files
5aba93e967f6598301e14ff9875ba81cc7af980e
to-live-photo/docs/USER_GUIDE.md
empty 5aba93e967 feat: M2-M4 完成，添加 AI 增强、设计系统、App Store 准备 
新增功能：
- AI 超分辨率模块 (Real-ESRGAN Core ML)
- Soft UI 设计系统 (DesignSystem.swift)
- 设置页、隐私政策页、引导页
- 最近作品管理器

App Store 准备：
- 完善截图 (iPhone 6.7"/6.5", iPad 12.9")
- App Store 元数据文档
- 修复应用图标 alpha 通道
- 更新显示名称为 Live Photo Studio

工程配置：
- 配置 Git LFS 跟踪 mlmodel 文件
- 添加 Claude skill 开发指南
- 更新 .gitignore 规则

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-16 10:24:31 +08:00

5.8 KiB
Raw Blame History

Live Photo Maker 用户手册

快速开始

第一步：导入视频

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

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

Reference in New Issue View Git Blame Copy Permalink