You need to enable JavaScript to run this app. Android 10 MediaPlayer prepareAsync抛出IllegalStateException异常
优惠活动
大模型
产品
解决方案
定价
更多

Android 10 MediaPlayer prepareAsync抛出IllegalStateException异常

根因定位
  • 异常的直接触发原因是MediaPlayer状态机校验失败:prepareAsync()方法要求调用时MediaPlayer必须处于Initialized状态(即setDataSource()已成功完成、拿到有效文件数据源)。从异常栈来看,此时MediaPlayer还停留在Idle状态,说明之前的setDataSource()操作实际没有成功初始化数据源,但未被Java层的异常捕获逻辑感知。
  • 深层原因是Android 10分区存储(Scoped Storage)规则的限制:
    • 低于Android10的版本上,应用拿到MediaStore.Audio.Media.DATA列返回的外部存储物理路径后,可以直接通过文件路径访问MP3文件,setDataSource(File)能正常打开文件、切换到合法的初始化状态。
    • Android10开始默认开启分区存储,应用不再具备直接通过物理文件路径访问外部共享目录文件的权限,即使从MediaStore查询到的路径存在,直接通过File对象打开也会被系统拒绝。这种场景下setDataSource()不会抛出可被捕获的Java层IO异常,仅在Native层标记数据源无效,最终导致状态机不满足prepareAsync()的调用前置条件,抛出IllegalStateException。
适配方案
  • 替换物理文件路径的数据源获取逻辑,不再依赖MediaStore.Audio.Media.DATA列:
    • MediaStore查询时新增读取MediaStore.Audio.Media._ID列,通过ContentUris.withAppendedId(MediaStore.Audio.Media.EXTERNAL_CONTENT_URI, id)拼接生成对应的内容URI,将该URI作为音频文件的唯一标识保存,不再存储物理路径字符串。
  • 修改MediaPlayer的数据源设置方式:
    • 弃用传入File对象的setDataSource()方法,改用支持Content URI的重载方法setDataSource(context, audioUri),由系统通过ContentResolver为应用授权打开目标文件,绕过分区存储对直接路径访问的限制。
  • 修正错误流程的中断逻辑:
    • 在setDataSource()的异常捕获块中,明确中断后续执行流程,避免在数据源初始化失败的情况下继续调用prepareAsync(),从代码层面规避状态机异常。
  • 兼容低版本的临时适配(非长期方案):
    • 如果需要短期兼容Android10设备且不想立刻迁移URI访问逻辑,可在AndroidManifest.xml的application节点下声明android:requestLegacyExternalStorage="true",临时关闭Android10的分区存储限制。注意该配置在Android11及以上系统会失效,仅作为过渡方案使用。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.09 02:06:05