如何在Android中使用Coil加载音频文件缩略图

方案1：直接通过MediaStore URI加载 #

Coil原生支持加载content://开头的MediaStore URI，只要你持有读取音频文件的权限（Android 13+用READ_MEDIA_AUDIO，低版本用READ_EXTERNAL_STORAGE），可以直接用Coil的load方法加载，无需手动调用loadThumbnail：

// 假设你有一个ImageView和音频文件的Uri
imageView.load(audioUri) {
    size(200, 200) // 指定缩略图尺寸
    placeholder(R.drawable.default_album_art) // 加载中占位图
    error(R.drawable.default_album_art) // 加载失败占位图
}

Coil会自动在后台线程处理加载逻辑，并且会缓存加载结果，避免重复耗时操作，完全解决UI延迟问题。

方案2：自定义Fetcher包装loadThumbnail（更定制化场景） #

如果需要严格复用ContentResolver.loadThumbnail的逻辑（比如特定的Size参数或加载配置），可以自定义一个Coil的Fetcher，把loadThumbnail的逻辑封装进去，让Coil统一管理后台任务和缓存：

步骤1：定义自定义Fetcher

class AudioThumbnailFetcher(
    private val context: Context,
    private val uri: Uri
) : Fetcher {

    override suspend fun fetch(): FetchResult {
        val bitmap = context.contentResolver.loadThumbnail(
            uri,
            Size(200, 200),
            null
        )
        return BitmapResult(bitmap)
    }

    // 定义对应的Factory，让Coil能创建Fetcher
    class Factory(private val context: Context) : Fetcher.Factory<Uri> {
        override fun create(data: Uri, options: Options, imageLoader: ImageLoader): Fetcher? {
            // 判断是否是音频文件的MediaStore URI
            if (data.scheme == "content" && data.authority == "media") {
                return AudioThumbnailFetcher(context, data)
            }
            return null
        }
    }
}

步骤2：配置Coil的ImageLoader

在初始化Coil的时候，把自定义的Fetcher Factory添加进去：

val imageLoader = ImageLoader.Builder(context)
    .components {
        add(AudioThumbnailFetcher.Factory(context))
    }
    .build()

// 如果用的是Coil的单例，可以在Application里初始化：
// Coil.setImageLoader(imageLoader)

步骤3：使用自定义Fetcher加载

和直接加载URI的方式一样，Coil会自动匹配到自定义的Fetcher：

imageView.load(audioUri) {
    size(200, 200)
    placeholder(R.drawable.default_album_art)
}

关键优势 #

• Coil自动处理后台线程加载，不会阻塞UI线程，解决渲染延迟问题
• 内置内存缓存和磁盘缓存，重复加载同一缩略图时直接取缓存，大幅提升性能
• 统一的图片加载API，无需手动管理线程和缓存逻辑

内容的提问来源于stack exchange，提问作者Ahmad Njres