使用ActivityResultContracts.OpenDocument()限制选择音频文件的正确方法

问题出在部分设备的文件选择器对audio/*这类通配符MIME类型的支持不够完善，导致无法识别已有的音频文件。解决办法是同时传入具体的音频MIME类型和通配符类型，既覆盖常见音频格式，又保留兜底逻辑。

具体实现步骤 #

1. 列出常见音频格式对应的MIME类型，比如MP3（audio/mpeg）、WAV（audio/wav）、OGG（audio/ogg）、AAC（audio/aac）等；
2. 将这些具体类型与audio/*一起作为参数传入launch()方法，文件选择器会优先识别具体类型，同时兼容支持通配符的场景。

代码示例 #

Kotlin

// 注册文件选择启动器
val pickAudioLauncher = registerForActivityResult(ActivityResultContracts.OpenDocument()) { uri ->
    uri?.let {
        // 处理选中的音频文件URI，比如读取文件内容、获取文件名等
    }
}

// 启动选择器，传入限定的音频MIME类型数组
pickAudioLauncher.launch(arrayOf(
    "audio/mpeg",    // MP3
    "audio/wav",     // WAV
    "audio/ogg",     // OGG
    "audio/aac",     // AAC
    "audio/*"        // 兜底，兼容更多音频格式
))

Java

// 注册文件选择启动器
ActivityResultLauncher<String[]> pickAudioLauncher = registerForActivityResult(
    new ActivityResultContracts.OpenDocument(),
    uri -> {
        if (uri != null) {
            // 处理选中的音频文件URI
        }
    }
);

// 启动选择器，传入限定的音频MIME类型数组
pickAudioLauncher.launch(new String[]{
    "audio/mpeg",
    "audio/wav",
    "audio/ogg",
    "audio/aac",
    "audio/*"
});

补充说明 #

• 部分第三方文件管理器可能对MIME类型过滤的逻辑有差异，但系统原生文件选择器会严格按照传入的类型过滤；
• 如果仍有个别音频文件无法显示，大概率是该文件的MIME类型未被系统正确识别，可通过文件属性确认其类型是否在你指定的列表中。

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