You need to enable JavaScript to run this app. 已废弃的Context.externalMediaDirs的MediaStore替代方案是什么?
优惠活动
大模型
产品
解决方案
定价
更多

已废弃的Context.externalMediaDirs的MediaStore替代方案是什么?

Android存储适配:Context.externalMediaDirs的替代方案

问题

已知访问公共媒体文件夹时,可以用如下代码替代废弃的Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DCIM):

values.put(MediaStore.Media.RELATIVE_PATH, Environment.DIRECTORY_DCIM)

uri = resolver.insert(
    MediaStore.Media.getContentUri(MediaStore.VOLUME_EXTERNAL_PRIMARY),
    values
)

请问Context.externalMediaDirs有什么替代方案?还是说应用私有媒体文件夹已经完全废弃,不推荐使用?

解答

核心结论

Android 10(SDK 29)及以上版本推荐用MediaStore.getExternalVolumeNames(context)完全替代Context.externalMediaDirs,该接口支持返回内置存储、可移动MicroSD卡等所有存储卷的卷名,可直接将媒体文件保存到任意存储卷的公共媒体文件夹,解决了旧版本无法访问外置SD卡公共目录的问题。
如果需要兼容Android 5.0(SDK 21)到Android 9(SDK 28)的旧版本系统,仍可使用Context.externalMediaDirs访问外置SD卡的应用私有媒体路径,该区间版本不支持直接写入外置SD卡的公共媒体目录。全版本适配需要编写分层兼容逻辑。

适配代码示例

注:示例中硬编码的下标[0]、[1]仅为方便演示,实际开发中需添加空判断和数组越界保护。

Android 29及以上版本

val volumeNames = MediaStore.getExternalVolumeNames(context).toTypedArray()

val phoneSdCard: String = volumeNames[0]
// 返回值为external_primary,对应内置存储的 /storage/emulated/0/DCIM 路径

val removableMicroSdCard: String = volumeNames[1]
// 返回值为SD卡的唯一ID(例如12f7-270f),对应外置SD卡的 /storage/12F7-270F/DCIM 路径

// 配合MediaStore写入公共目录的逻辑:
values.put(MediaStore.Images.Media.RELATIVE_PATH, Environment.DIRECTORY_DCIM)
uri = resolver.insert(
    MediaStore.Images.Media.getContentUri(phoneSdCard /* 可替换为removableMicroSdCard写入外置SD卡 */),
    values
)

Android 21-28版本

val phoneSdCard: File = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DCIM)
// 对应内置存储路径 /storage/emulated/0/DCIM

val removableMicroSdCard: File = context.externalMediaDirs[1]
// 对应外置SD卡的应用私有媒体路径 /storage/12F7-270F/Android/media/com.example.app
// 该版本区间无法在外置SD卡的 /storage/12F7-270F/DCIM 公共路径下写入媒体文件

内容的提问来源于stack exchange,提问作者user924

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.08 03:15:02