更新记录

0.0.2（2025-09-01）

• fix: 去除多余函数。

0.0.1（2025-09-01）

• 初始版本
• 实现基础的Live Photo生成功能
• 支持自定义视频时长、尺寸和帧提取时间点
• 支持进度回调，实时监控生成过程
• 支持iOS平台
• 提供完整的错误处理机制
• 添加详细的接口文档和使用示例

平台兼容性

云端兼容性

uni-app(4.73)

uni-app x(4.74)

lime-live-photo Live Photo插件

一个实用的Live Photo生成插件，用于将视频转换为iOS风格的Live Photo。支持自定义视频时长、尺寸、帧提取时间点等配置。插件提供了多种自定义选项，可用于Live Photo生成需求。

文档链接

📚 插件详细文档请访问以下站点：

• Live Photo插件文档 - 站点1
• Live Photo插件文档 - 站点2
• Live Photo插件文档 - 站点3

安装方法

1. 在uni-app插件市场中搜索并导入lime-live-photo
2. 导入后可能需要重新编译项目

代码演示

基础用法

最简单的Live Photo组件用法，只需要设置视频路径即可。

// uniapp非ts无须导入type LivePhotoOptions
import { getLivePhoto, type LivePhotoOptions } from '@/uni_modules/lime-live-photo'

getLivePhoto({
  path: '视频文件路径',
  success: (res) => {
    console.log('生成成功', res.tempFilePaths)
  },
  fail: (err) => {
    console.error('生成失败', err)
  }
  // uniapp非ts无须as LivePhotoOptions
} as LivePhotoOptions)

自定义参数

可以自定义视频时长、尺寸和帧提取时间点。

import { getLivePhoto , type LivePhotoOptions } from '@/uni_modules/lime-live-photo'

getLivePhoto({
  path: '视频文件路径',
  duration: 1.5,        // 自定义时长(秒)
  width: 1080,          // 自定义宽度
  height: 1920,         // 自定义高度
  frameTime: 0.8,       // 自定义帧提取时间点(秒)
  success: (res) => {
    console.log('生成成功', res.tempFilePaths)
  },
  fail: (err) => {
    console.error('生成失败', err)
  }
} as LivePhotoOptions)

带进度回调

添加进度回调，实时监控Live Photo生成过程。

import { getLivePhoto, type LivePhotoOptions } from '@/uni_modules/lime-live-photo'

getLivePhoto({
  path: '视频文件路径',
  success: (res) => {
    console.log('生成成功', res.tempFilePaths)
  },
  fail: (err) => {
    console.error('生成失败', err)
  },
  progress: (status, percent) => {
    console.log(`当前状态: ${status}, 进度: ${percent}%`)
    // status可能的值: 'processing', 'extracting', 'generating', 'saving'
  }
} as LivePhotoOptions)

API文档

方法

getLivePhoto(options)

将视频转换为Live Photo格式。

Options 参数说明

LivePhotoResult 返回结果

LivePhotoStatus 状态类型

错误码

实现原理

Live Photo组件通过以下步骤将普通视频转换为iOS风格的Live Photo：

1. 调整视频时长为指定长度
2. 调整视频速度以匹配Live Photo标准时长
3. 调整视频尺寸为指定尺寸
4. 从视频中提取关键帧作为静态图像
5. 生成Live Photo静态图像部分(.heic文件)
6. 生成Live Photo视频部分(.mov文件)
7. 将生成的Live Photo保存到相册(可选)

平台支持

目前仅支持iOS平台。

支持与赞赏

如果你觉得本插件解决了你的问题，可以考虑支持作者：

支付宝赞助	微信赞助