Android：如何让getExternalFilesDir存储的视频文件在系统相册中显示？

嘿，我来帮你搞定这个问题！你当前的代码有两个关键问题导致视频没出现在系统相册里，咱们一步步拆解解决：

问题出在哪？ #

1. RELATIVE_PATH参数用法错误：这个字段需要填写的是相对于公共存储目录的路径（比如"Movies/MyAppVideos"），而不是你应用专属文件夹的绝对路径。应用专属文件夹（Android/data/com.myapp/Videos）属于应用私有空间，MediaStore默认不会主动索引这里的文件，直接填绝对路径也不符合该参数的设计逻辑。
2. 应用专属文件夹的隐私限制：即使你用MediaStore插入记录，系统也不会自动识别私有文件夹里的文件，必须主动触发媒体扫描才能让相册感知到。

两种解决方案，按需选择 #

方案一：继续使用应用专属文件夹，触发媒体扫描 #

如果你坚持把视频存在应用专属目录（卸载应用时文件会被删除），可以通过MediaScannerConnection主动让系统扫描这个文件，这样相册就能识别它了：

val file = File(path)
MediaScannerConnection.scanFile(
    requireActivity(),
    arrayOf(file.path),
    arrayOf("video/mp4")
) { scannedPath, mediaUri ->
    // 扫描完成后的回调，mediaUri就是该视频在媒体库中的标识
    Log.d("MediaScan", "视频已被扫描，媒体URI：$mediaUri")
}

注意：这种方式不需要额外申请存储权限（因为是应用私有目录），但部分定制化系统可能会对私有目录的媒体扫描做限制，导致相册无法显示。

方案二：存到公共存储目录，让系统自动索引 #

如果希望视频在应用卸载后依然保留，且更稳定地被相册识别，推荐把文件存到公共存储的视频目录（比如Movies或DCIM），这时候用MediaStore的方式更可靠：

import android.os.Build
import android.os.Environment
import android.provider.MediaStore

// 定义公共存储下的子目录，比如Movies下的MyAppVideos
val relativePath = "${Environment.DIRECTORY_MOVIES}/MyAppVideos"

val contentValues = ContentValues().apply {
    put(MediaStore.Video.Media.TITLE, "My video title")
    put(MediaStore.Video.Media.MIME_TYPE, "video/mp4")
    put(MediaStore.Video.Media.RELATIVE_PATH, relativePath)
    
    // 针对Android Q以下版本（API < 29），需要手动指定文件路径
    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.Q) {
        val publicDir = Environment.getExternalStoragePublicDirectory(relativePath)
        if (!publicDir.exists()) publicDir.mkdirs()
        val targetFile = File(publicDir, "clip1.mp4")
        put(MediaStore.Video.Media.DATA, targetFile.path)
    }
}

// 插入到媒体库，获取写入URI
val mediaUri = requireActivity().contentResolver.insert(
    MediaStore.Video.Media.EXTERNAL_CONTENT_URI,
    contentValues
)

// 通过URI写入视频数据（替换成你实际的下载逻辑）
mediaUri?.let { uri ->
    requireActivity().contentResolver.openOutputStream(uri).use { outputStream ->
        // 这里将下载的视频输入流复制到outputStream中
        // 例如：downloadInputStream.copyTo(outputStream)
    }
}

权限说明：

• Android 13+：需要申请READ_MEDIA_VIDEO权限
• Android 10-12：无需额外权限（通过MediaStore操作公共存储）
• Android Q以下：需要WRITE_EXTERNAL_STORAGE权限

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