生成媒体缩略图

媒体缩略图为用户提供了图像和视频的快速视觉预览，能够加快浏览速度，同时让应用界面更具视觉吸引力和互动性。由于缩略图小于全尺寸媒体文件，它们有助于节省内存、存储空间和带宽，同时提高媒体浏览性能。

根据文件类型、您在应用中拥有的文件访问权限以及媒体资产，您可以通过多种不同的方式创建缩略图。

使用图像加载库创建缩略图

图像加载库可以为您完成大量繁重工作；它们可以处理缓存以及根据 Uri 从本地或网络资源获取源媒体的逻辑。以下代码演示了 Coil 图像加载库的使用，它适用于图像和视频，并且适用于本地或网络资源。

// Use Coil to create and display a thumbnail of a video or image with a specific height
// ImageLoader has its own memory and storage cache, and this one is configured to also
// load frames from videos
val videoEnabledLoader = ImageLoader.Builder(context)
    .components {
        add(VideoFrameDecoder.Factory())
    }.build()
// Coil requests images that match the size of the AsyncImage composable, but this allows
// for precise control of the height
val request = ImageRequest.Builder(context)
    .data(mediaUri)
    .size(Int.MAX_VALUE, THUMBNAIL_HEIGHT)
    .build()
AsyncImage(
    model = request,
    imageLoader = videoEnabledLoader,
    modifier = Modifier
        .clip(RoundedCornerShape(20))    ,
    contentDescription = null
)

如果可能，请在服务器端创建缩略图。有关如何使用 Compose 加载图像的详细信息，请参阅加载图像；有关如何处理大型图像的指导，请参阅高效加载大型位图。

从本地图像文件创建缩略图

获取缩略图涉及在保持视觉质量的同时高效缩小，避免过多的内存使用，处理各种图像格式，并正确使用 Exif 数据。

如果您可以访问图像文件的路径，createImageThumbnail 方法可以完成所有这些操作。

val bitmap = ThumbnailUtils.createImageThumbnail(File(file_path), Size(640, 480), null)

如果您只有 Uri，从 Android 10（API 级别 29）开始，您可以使用 ContentResolver 中的 loadThumbnail 方法。

val thumbnail: Bitmap =
        applicationContext.contentResolver.loadThumbnail(
        content-uri, Size(640, 480), null)

ImageDecoder（从 Android 9，API 级别 28 开始可用）提供了一些可靠的选项，可以在解码时对图像进行重新采样，以防止额外的内存使用。

class DecodeResampler(val size: Size, val signal: CancellationSignal?) : OnHeaderDecodedListener {
    private val size: Size

   override fun onHeaderDecoded(decoder: ImageDecoder, info: ImageInfo, source:
       // sample down if needed.
        val widthSample = info.size.width / size.width
        val heightSample = info.size.height / size.height
        val sample = min(widthSample, heightSample)
        if (sample > 1) {
            decoder.setTargetSampleSize(sample)
        }
    }
}

val resampler = DecoderResampler(size, null)
val source = ImageDecoder.createSource(context.contentResolver, imageUri)
val bitmap = ImageDecoder.decodeBitmap(source, resampler);

您可以使用 BitmapFactory 为面向早期 Android 版本的应用创建缩略图。BitmapFactory.Options 有一个设置，用于仅解码图像的边界以便进行重新采样。

首先，将位图的边界解码到 BitmapFactory.Options 中

private fun decodeResizedBitmap(context: Context, uri: Uri, size: Size): Bitmap?{
    val boundsStream = context.contentResolver.openInputStream(uri)
    val options = BitmapFactory.Options()
    options.inJustDecodeBounds = true
    BitmapFactory.decodeStream(boundsStream, null, options)
    boundsStream?.close()

使用 BitmapFactory.Options 中的 width 和 height 来设置采样大小

if ( options.outHeight != 0 ) {
        // we've got bounds
        val widthSample = options.outWidth / size.width
        val heightSample = options.outHeight / size.height
        val sample = min(widthSample, heightSample)
        if (sample > 1) {
            options.inSampleSize = sample
        }
    }

解码流。所得图像的大小是根据 inSampleSize 按 2 的幂次采样的。

    options.inJustDecodeBounds = false
    val decodeStream = context.contentResolver.openInputStream(uri)
    val bitmap =  BitmapFactory.decodeStream(decodeStream, null, options)
    decodeStream?.close()
    return bitmap
}

从本地视频文件创建缩略图

获取视频缩略图面临许多与获取图像缩略图相同的挑战，但文件大小可能大得多，而且获取一个有代表性的视频帧并不总是像选择视频的第一帧那么简单。

如果您可以访问视频文件的路径，createVideoThumbnail 方法是一个不错的选择。

val bitmap = ThumbnailUtils.createVideoThumbnail(File(file_path), Size(640, 480), null)

如果您只能访问内容 Uri，您可以使用 MediaMetadataRetriever。

首先，检查视频是否嵌入了缩略图，如果可能，请使用该缩略图

private suspend fun getVideoThumbnailFromMediaMetadataRetriever(context: Context, uri: Uri, size: Size): Bitmap? {
    val mediaMetadataRetriever = MediaMetadataRetriever()
    mediaMetadataRetriever.setDataSource(context, uri)
    val thumbnailBytes = mediaMetadataRetriever.embeddedPicture
    val resizer = Resizer(size, null)
    ImageDecoder.createSource(context.contentResolver, uri)
    // use a built-in thumbnail if the media file has it
    thumbnailBytes?.let {
        return ImageDecoder.decodeBitmap(ImageDecoder.createSource(it));
    }

从 MediaMetadataRetriever 中获取视频的宽度和高度以计算缩放因子

val width = mediaMetadataRetriever.extractMetadata(MediaMetadataRetriever.METADATA_KEY_VIDEO_WIDTH)
            ?.toFloat() ?: size.width.toFloat()
    val height = mediaMetadataRetriever.extractMetadata(MediaMetadataRetriever.METADATA_KEY_VIDEO_HEIGHT)
            ?.toFloat() ?: size.height.toFloat()
    val widthRatio = size.width.toFloat() / width
    val heightRatio = size.height.toFloat() / height
    val ratio = max(widthRatio, heightRatio)

在 Android 9+（API 级别 28）上，MediaMetadataRetriever 可以返回缩放后的帧

if (ratio > 1) {
        val requestedWidth = width * ratio
        val requestedHeight = height * ratio
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
            val frame = mediaMetadataRetriever.getScaledFrameAtTime(
                -1, OPTION_PREVIOUS_SYNC,
                requestedWidth.toInt(), requestedHeight.toInt())
            mediaMetadataRetriever.close()
            return frame
        }
    }

否则，返回未缩放的第一帧

    // consider scaling this after the fact
    val frame = mediaMetadataRetriever.frameAtTime
    mediaMetadataRetriever.close()
    return frame
}