video_frame_zh.md

Video Frame

翻译：English

Important

1. 必须导入 sketch-video 或 sketch-video-ffmpeg 模块
2. 仅支持 Android 平台

Sketch 支持解码视频帧，由以下 Decoder 提供支持：

• VideoFrameDecoder：使用 Android 内置的 MediaMetadataRetriever 类解码视频帧
  • 需要先导入 sketch-video 模块
  • 建议 Android 8.1 及以上版本使用，因为 8.0 及以下版本不支持读取帧的缩略图，在解码 4k 等较大的视频时将消耗大量的内存
• FFmpegVideoFrameDecoder：使用 wseemann/FFmpegMediaMetadataRetriever-project 库的 FFmpegMediaMetadataRetriever 类解码视频帧
  • 需要先导入 sketch-video-ffmpeg 模块
  • 库体积大概 23MB

注册

根据情况选择合适的 Decoder，然后注册它，如下：

// 在自定义 Sketch 时为所有 ImageRequest 注册
Sketch.Builder(context).apply {
    components {
        addDecoder(VideoFrameDecoder.Factory())
        //or
        addDecoder(FFmpegVideoFrameDecoder.Factory())
    }
}.build()

// 加载图片时为单个 ImageRequest 注册
ImageRequest(context, "file:///sdcard/sample.mp4") {
    components {
        addDecoder(VideoFrameDecoder.Factory())
        //or
        addDecoder(FFmpegVideoFrameDecoder.Factory())
    }
}

配置

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

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

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

    // 或获取提取中间的帧
    videoFramePercentDuration(0.5f)

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