在 Android 中实现 ImageDecoder API

在 Android 系统中，我们经常需要对图片进行处理和显示，而 ImageDecoder API 就是为了方便开发者处理传统的图片格式，比如 JPEG、PNG、GIF 等，并支持对 WebP 和 HEIF 这些较新的格式的支持，同时也更好地支持透明色，并能够有效地减少内存开销，提高图片的加载效率和显示质量。

在本文中，我们将介绍如何在 Android 中实现 ImageDecoder API。

导入依赖库

在使用 ImageDecoder API 前，需要在该项目的 build.gradle 文件中添加以下依赖库：

android {
    //...
}

dependencies {
    //...
    implementation 'androidx.core:core-ktx:1.5.0'
}

注意，我们这里引用了 androidx.core:core-ktx 库，因为 ImageDecoder API 是从 Android 9.0 (API level 28) 开始引入的，且仅仅在 AndroidX Core Library 中实现，因此需要添加该库的依赖。

加载和显示图片

下面是使用 ImageDecoder API 加载和显示图片的基本代码：

import android.graphics.Bitmap
import android.graphics.ImageDecoder
import android.graphics.drawable.Drawable
import androidx.annotation.DrawableRes
import androidx.annotation.RequiresApi
import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import android.widget.ImageView
import androidx.core.content.ContextCompat

class MainActivity : AppCompatActivity() {

    private lateinit var image: ImageView

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        image = findViewById(R.id.image)

        // 加载图片资源
        val drawableRes = R.drawable.sample_image
        val drawable = getDrawable(drawableRes)

        // 显示图片
        image.setImageDrawable(drawable)
    }

    @RequiresApi(Build.VERSION_CODES.P)
    private fun getDrawable(@DrawableRes drawableRes: Int): Drawable? {
        val source = ImageDecoder.createSource(
            applicationContext.resources,
            drawableRes
        )
        val drawable = ImageDecoder.decodeDrawable(source) ?: return null
        return ContextCompat.getDrawable(applicationContext, drawableRes) ?: return null
    }
}

上面代码中，我们首先在 onCreate() 方法中获取 ImageView 的实例，并加载图片资源。在 getDrawable() 方法中，我们使用 ImageDecoder API 创建图片资源的 Source，并使用 decodeDrawable() 方法将其解码成 Drawable 类型，然后通过 ContextCompat.getDrawable() 方法将其转换成 Drawable 对象。最后，在 setImageDrawable() 方法中将其显示出来。

加载大图

由于 ImageDecoder API 使用了 Incremental Decoding (逐步解码)，因此能够轻松地处理大图文件，并避免了一次性解码过大图像导致的内存爆炸问题。我们可以通过设置自定义的 DecodeOptions，来控制图片的加载和解码，从而达到更好的效果。

import android.graphics.Bitmap
import android.graphics.ImageDecoder
import android.graphics.drawable.Drawable
import android.net.Uri
import android.os.Build
import android.os.Bundle
import android.widget.ImageView
import androidx.annotation.DrawableRes
import androidx.annotation.RequiresApi
import androidx.appcompat.app.AppCompatActivity
import androidx.core.content.ContextCompat

class MainActivity : AppCompatActivity() {

    private lateinit var image: ImageView

    @RequiresApi(Build.VERSION_CODES.P)
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        image = findViewById(R.id.image)

        // 加载大图
        val uri = Uri.parse("content://com.android.providers.media.documents/document/image%3A8")
        val source = ImageDecoder.createSource(contentResolver, uri)
        val options = ImageDecoder.DecodeOptions().apply {
            // 设置解码方式，可选 ARGB_8888 或 RGB_565
            this.postProcessor = MyPostProcessor()
            // 设置解码起点和终点
            this.region = ImageDecoder.Region(2500, 2000, 3500, 3000)
            // 设置解码的缩放比例
            this.scale = 0.5f
            // 设置解码时的色彩空间
            this.colorSpace = ColorSpace.get(ColorSpace.Named.SRGB)
            // 设置是否针对透明像素做 alpha 处理
            this.postProcessAlpha = true
        }
        val drawable = ImageDecoder.decodeDrawable(source, options) ?: return

        // 显示图片
        image.setImageDrawable(drawable)
    }

    //自定义解码后的处理逻辑
    inner class MyPostProcessor : ImageDecoder.PostProcessor {
        override fun onPostProcess(bitmap: Bitmap) {
            // 在此处执行增加色彩饱和度等后期处理的逻辑
        }
    }
}

上面代码中，我们使用了 createSource() 方法来创建图片资源的 Source，然后使用 DecodeOptions 来控制图片的加载和解码。其中，我们采用了 PostProcessor 来进行自定义解码后的处理逻辑，使用 Region 来设置解码起点和终点，使用 scale 来设置解码的缩放比例，使用 colorSpace 来设置解码时的色彩空间，使用 postProcessAlpha 来设置是否针对透明像素做 alpha 处理。

需要注意的是，上面的代码中加载的是一张较大的图片，如果手机内存较小，可能会导致内存开销过大而崩溃，因此需要根据具体业务需求来判断，是否需要加载较大的图片。

小结

本文介绍了在 Android 中如何使用 ImageDecoder API 进行图片的处理和显示，并提供了加载大图的示例代码供参考。ImageDecoder API 提供了一种更好的方式来处理图片，能够有效地减少内存开销，提高图片的加载效率和显示质量。对于 Android 开发者来说，了解和掌握 ImageDecoder API 的使用方法是必要的。