decoder_zh.md

Decoder

翻译：English

Decoder 用于解码图片文件得到一个 Bitmap 或 Drawable，因此 Sketch 有两种 Decoder：

• BitmapDecoder：用于解码图片文件并将其转成 Bitmap
  • ApkIconBitmapDecoder：解码 Apk 文件的图标，了解更多
  • AppIconBitmapDecoder：解码已安装 App 的图标，了解更多
  • DefaultBitmapDecoder：最后的 Bitmap 解码器，采用 Android 内置的 BitmapFactory 解码图片
  • FFmpegVideoFrameBitmapDecoder：使用 wseemann /FFmpegMediaMetadataRetriever-project 库的 FFmpegMediaMetadataRetriever 类解码视频文件的帧，了解更多
  • SvgBitmapDecoder：使用 BigBadaboom/androidsvg 库解码静态 svg 文件，了解更多
  • VideoFrameBitmapDecoder：使用 Android 内置的 MediaMetadataRetriever 类解码视频文件的帧，了解更多
  • DrawableBitmapDecoder：解码 vector、shape 等 Android 支持的 xml drawable 图片
• DrawableDecoder： 用于解码图片文件并将其转成 Drawable
  • DefaultDrawableDecoder：最后的 Drawable 解码器，调用 BitmapDecoder 得到 Bitmap 再封装成 BitmapDrawable
  • GifAnimatedDrawableDecoder：使用 Android 内置的 ImageDecoder 类解码 gif ，了解更多
  • GifDrawableDrawableDecoder：使用 koral--/android-gif-drawable 库的 GifDrawable 类解码 gif 图片，了解更多
  • GifMovieDrawableDecoder：使用 Android 内置的 Movie 类解码 gif 图片，了解更多
  • HeifAnimatedDrawableDecoder：使用 Android 内置的 ImageDecoder 类解码 heif 动图，了解更多
  • WebpAnimatedDrawableDecoder：使用 Android 内置的 ImageDecoder 类解码 webp 动图，了解更多

BitmapDecoder 和 DrawableDecoder 各有一个 Decoder 列表，需要解码时 Sketch 会根据 ImageRequest 的类型依次遍历对应的 Decoder 列表，直到找到一个能解码当前类型图片的 Decoder，然后调用其 decode 方法得到解码结果

扩展新的 Decoder

1.首先需要实现 BitmapDecoder 或 DrawableDecoder 接口定义你的 Decoder 和它的 Factory，下面以 BitmapDecoder 为例，如下：

class MyBitmapDecoder : BitmapDecoder {

    override suspend fun decode(): Result<BitmapDecodeResult> {
        // 在这里解析图片
    }

    companion object {
        const val MY_MIME_TYPE = "image/mypng"
    }

    class Factory : BitmapDecoder.Factory {

        override fun create(
            sketch: Sketch,
            requestContext: RequestContext,
            fetchResult: FetchResult
        ): BitmapDecoder? {
            val mimeType = fetchResult.mimeType
            val dataSource = fetchResult.dataSource
            // 在这通过 mimeType 或 dataSource 判断当前图片是否是
            // MyBitmapDecoder 的目标类型，是的话返回一个新的 MyBitmapDecoder
            return if (fetchResult.mimeType == MY_MIME_TYPE) {
                MyBitmapDecoder()
            } else {
                null
            }
        }
    }
}

2.然后通过 addBitmapDecoder 注册，如下：

/* 为所有 ImageRequest 注册 */
class MyApplication : Application(), SketchFactory {

    override fun createSketch(): Sketch {
        return Sketch.Builder(this).apply {
            components {
                addBitmapDecoder(MyBitmapDecoder.Factory())
            }
        }.build()
    }
}

/* 为单个 ImageRequest 注册 */
imageView.displayImage("asset://sample.mypng") {
    components {
        addBitmapDecoder(MyBitmapDecoder.Factory())
    }
}

注意：自定义 Decoder 需要应用 ImageRequest 中的很多与图片质量和尺寸相关的属性，例如 bitmapConfig、resize、colorSpace 等，可参考其它 Decoder 实现

3.自定义 DrawableDecoder 和 BitmapDecoder 流程一样，唯一区别在于注册到 Sketch 时要调用 addDrawableDecoder() 方法

注意：如果你自定义的 DrawableDecoder 是解码动图的话一定要判断 ImageRequest .disallowAnimatedImage 参数