Android分享面板不显示视频预览问题求助

问题分析 #

你遇到的分享面板仅显示应用图标、不展示视频预览和标题的情况，核心原因在于Intent的ClipData设置错误，以及系统分享面板需要从Uri读取到完整的视频元数据（缩略图、标题等）才能生成预览。

修复步骤 #

1. 修正Intent的ClipData配置 #

原代码在apply块中错误使用了外部intent对象来设置clipData，应该用this指代当前正在构建的Intent；同时建议给ClipData设置合理的标签名称，而非null。修改后的分享代码如下：

private fun shareMediaItem(uri: Uri) {
    try {
        val shareIntent = Intent().apply {
            action = Intent.ACTION_SEND
            putExtra(Intent.EXTRA_STREAM, uri)
            putExtra(Intent.EXTRA_TITLE, "Share screen recording")
            type = "video/mp4"
            addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
            // 修正ClipData设置：使用当前Intent对象，补充合理标签
            clipData = ClipData("Screen Recording", arrayOf("video/mp4"), ClipData.Item(uri))
        }
        startActivity(Intent.createChooser(shareIntent, "Share your screen recording"))
    } catch (e: Exception) {
        Log.e("ShareMediaActivity", "Error sharing media item", e)
    }
}

2. 确保MediaStore写入完整视频元数据 #

系统分享面板的预览依赖MediaStore中存储的视频元数据，所以在保存视频到MediaStore时，必须写入标题、文件名等关键字段，示例代码如下：

fun saveVideoToMediaStore(context: Context, videoFile: File): Uri? {
    val contentValues = ContentValues().apply {
        put(MediaStore.Video.Media.DISPLAY_NAME, "ScreenRecording_${System.currentTimeMillis()}.mp4")
        put(MediaStore.Video.Media.TITLE, "Share screen recording") // 和分享标题保持一致
        put(MediaStore.Video.Media.MIME_TYPE, "video/mp4")
        put(MediaStore.Video.Media.RELATIVE_PATH, Environment.DIRECTORY_MOVIES + "/ScreenRecordings")
        // 若已生成视频缩略图，可写入此字段进一步优化预览
        // put(MediaStore.Video.Media.THUMBNAIL_URI, thumbnailUri)
    }

    return context.contentResolver.insert(MediaStore.Video.Media.EXTERNAL_CONTENT_URI, contentValues)?.also { uri ->
        context.contentResolver.openOutputStream(uri).use { outputStream ->
            videoFile.inputStream().use { inputStream ->
                inputStream.copyTo(outputStream!!)
            }
        }
    }
}

3. 确认Uri的权限与类型 #

确保分享的Uri是Content Uri（而非File Uri），Android 7.0+以上版本中File Uri无法跨应用访问，而通过MediaStore插入生成的Content Uri，配合FLAG_GRANT_READ_URI_PERMISSION可以安全授予其他应用读取权限。

为什么Google Photos能正常显示？ #

Google Photos作为系统级应用，拥有媒体文件的特殊访问权限，即便Intent配置存在小问题，它也能直接读取视频文件生成预览；但第三方应用依赖标准的Intent配置和元数据读取权限，因此必须完成上述修正才能让所有应用都正常显示预览。

内容的提问来源于stack exchange，提问作者Xi 张熹