视频帧

翻译：English

Sketch 提供了 sketch-video-* 系列模块以支持解码视频帧

Module	Decoder	Android	iOS	Desktop	Web
sketch-video	VideoFrameDecoder PhotosAssetVideoFrameDecoder FileVideoFrameDecoder	✅(API 27)	✅	❌	❌
sketch-video-ffmpeg	FFmpegVideoFrameDecoder	✅	❌	❌	❌

• VideoFrameDecoder：
  • 使用 Android 内置的 MediaMetadataRetriever 类解码视频帧
  • 建议 Android 8.1 及以上版本使用，因为 8.0 及以下版本不支持读取帧的缩略图，在解码 4k 等较大的视频时将消耗大量的内存
  • 仅支持 Android 平台
• FFmpegVideoFrameDecoder：
  • 使用 wseemann/FFmpegMediaMetadataRetriever-project 库的 FFmpegMediaMetadataRetriever 类解码视频帧
  • 仅支持 Android 平台
    • 库体积大概 23MB
• PhotosAssetVideoFrameDecoder：
  • 使用 AVAssetImageGenerator 类解码视频帧
  • 仅支持 file:///photos_asset/ 开头的 uri
  • 仅支持 ios 平台
• FileVideoFrameDecoder：
  • 使用 AVAssetImageGenerator 类解码视频帧
  • 仅支持本地 path uri
  • 仅支持 ios 平台

安装组件

${LAST_VERSION}: (不包含 'v')

implementation("io.github.panpf.sketch4:sketch-video:${LAST_VERSION}")
// or
implementation("io.github.panpf.sketch4:sketch-video-ffmpeg:${LAST_VERSION}")

配置

ImageRequest 和 ImageOptions 支持一些视频帧相关的配置，如下：

ImageRequest(context, "file:///sdcard/sample.mp4") {
    // 提取 1000000 微秒处的帧
    videoFrameMicros(1000000)

    // 或提取 10000 毫秒处的帧
    videoFrameMillis(10000)

    // 或获取提取中间的帧
    videoFramePercent(0.5f)
  
    // 优先获取内嵌的封面
    preferVideoCover(true)

    // 设置指定时间处无法提取帧时的处理策略。仅限 Android 平台
    videoFrameOption(MediaMetadataRetriever.OPTION_CLOSEST)
}