从Google Photos等云存储提取Bitmap问题解决与实现

我尝试从设备本地以外的视频（比如Google Photos这类云媒体应用中的视频）提取Bitmap，本地录制的视频处理正常，但从其他设备同步到Google Photos的视频提取时仅返回null。

已更新实现，将视频下载到内存中处理，代码如下：

@Composable
fun VideoThumbnail(uri: Uri) {
    val context = LocalContext.current
    var bitmap by remember { mutableStateOf<Bitmap?>(null) }

    LaunchedEffect(uri) {
        val retriever = MediaMetadataRetriever()
        val contentResolver: ContentResolver = context.contentResolver

        try {
            if (uri.authority?.contains("com.google.android.apps.photos") == true) {
                // Download the file into memory
                val inputStream: InputStream? = contentResolver.openInputStream(uri)
                val tempFile = File.createTempFile("temp_video", null, context.cacheDir)
                val outputStream = FileOutputStream(tempFile)
                inputStream?.copyTo(outputStream)
                inputStream?.close()
                outputStream.close()

                retriever.setDataSource(tempFile.absolutePath)
            } else {
                retriever.setDataSource(context, uri)
            }

            // Try to get the thumbnail at 1 second (1000000 microseconds)
            bitmap = retriever.getFrameAtTime(1000000, MediaMetadataRetriever.OPTION_CLOSEST_SYNC)
            if (bitmap == null) {
                // Fallback to the first frame if 1 second frame is not available
                bitmap = retriever.getFrameAtTime(0, MediaMetadataRetriever.OPTION_CLOSEST_SYNC)
            }
        } catch (e: Exception) {
            // Handle exceptions
            e.printStackTrace()
        } finally {
            retriever.release()
        }
    }

    bitmap?.let {
        Image(
            modifier = Modifier
                .clip(RoundedCornerShape(10.dp))
                .fillMaxWidth(),
            bitmap = it.asImageBitmap(),
            contentDescription = "Video Thumbnail",
        )
    }
}

问题分析与优化方案 #

核心问题点

1. 输入流空处理缺失：openInputStream(uri)可能因权限或云文件未同步完成返回null，直接调用copyTo会引发隐性错误。
2. 流资源管理不严谨：手动关闭流存在遗漏风险，且未确保文件完整写入就调用MediaMetadataRetriever。
3. 临时文件格式标识缺失：未给临时文件添加视频后缀，可能导致MediaMetadataRetriever无法识别格式。
4. 数据源兼容性不足：直接使用文件路径不如FileDescriptor对特殊格式的支持性好。

修正后的代码实现

@Composable
fun VideoThumbnail(uri: Uri) {
    val context = LocalContext.current
    var bitmap by remember { mutableStateOf<Bitmap?>(null) }

    LaunchedEffect(uri) {
        val retriever = MediaMetadataRetriever()
        val contentResolver = context.contentResolver
        var tempFile: File? = null

        try {
            if (uri.authority?.contains("com.google.android.apps.photos") == true) {
                contentResolver.openInputStream(uri)?.use { inputStream ->
                    // 添加视频后缀帮助识别格式
                    tempFile = File.createTempFile("temp_video", ".mp4", context.cacheDir)
                    FileOutputStream(tempFile).use { outputStream ->
                        // 增大缓冲区提升写入效率
                        inputStream.copyTo(outputStream, bufferSize = 8192)
                    }
                    // 使用FileDescriptor提升兼容性
                    FileInputStream(tempFile).use { fileInputStream ->
                        retriever.setDataSource(fileInputStream.fd)
                    }
                } ?: run {
                    // 输入流为空时直接终止流程
                    return@LaunchedEffect
                }
            } else {
                retriever.setDataSource(context, uri)
            }

            // 优先获取1秒处的帧
            bitmap = retriever.getFrameAtTime(1000000, MediaMetadataRetriever.OPTION_CLOSEST_SYNC)
            //  fallback到第一帧
            if (bitmap == null) {
                bitmap = retriever.getFrameAtTime(0, MediaMetadataRetriever.OPTION_CLOSEST_SYNC)
            }
        } catch (e: IOException) {
            e.printStackTrace()
        } catch (e: IllegalArgumentException) {
            e.printStackTrace()
        } catch (e: Exception) {
            e.printStackTrace()
        } finally {
            retriever.release()
            // 清理临时文件避免缓存堆积
            tempFile?.delete()
        }
    }

    bitmap?.let {
        Image(
            modifier = Modifier
                .clip(RoundedCornerShape(10.dp))
                .fillMaxWidth(),
            bitmap = it.asImageBitmap(),
            contentDescription = "视频缩略图",
        )
    } ?: run {
        // 加载失败时显示占位UI
        Box(
            modifier = Modifier
                .clip(RoundedCornerShape(10.dp))
                .fillMaxWidth()
                .aspectRatio(16f/9f)
                .background(Color.Gray.copy(alpha = 0.3f)),
            contentAlignment = Alignment.Center
        ) {
            Text(text = "无法加载缩略图")
        }
    }
}

关键优化说明

• 用use函数自动管理流的生命周期，避免资源泄漏。
• 给临时文件添加.mp4后缀，确保MediaMetadataRetriever正确识别视频格式。
• 改用FileDescriptor设置数据源，提升对特殊编码视频的兼容性。
• 添加临时文件清理逻辑，防止缓存目录占用过多空间。
• 增加加载失败的占位UI，优化用户体验。
• 拆分异常类型，便于精准定位问题。

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