Android 9+ 系统下铃声设置失效的完整解决方案

老雪小哥_3475

老雪小哥_3475

2026-07-25

822人浏览

原创

Android 9+ 系统下铃声设置失效的完整解决方案

本文详解 android 9(pie)及以上版本(尤其是 android 11+)中因存储权限变更导致铃声无法保存的问题,提供兼容 sdk 28–34 的权限适配、文件写入与媒体库插入全流程修复方案。

本文详解 android 9(pie)及以上版本(尤其是 android 11+)中因存储权限变更导致铃声无法保存的问题,提供兼容 sdk 28–34 的权限适配、文件写入与媒体库插入全流程修复方案。

Android 自 Android 9(API 28)起逐步收紧外部存储访问权限,至 Android 11(API 30)引入分区存储(Scoped Storage),并废弃 WRITE_EXTERNAL_STORAGE 权限对公共目录的写入能力;Android 12(API 31)起更强制要求应用若需访问所有文件(如 Music/ 目录),必须申请 MANAGE_EXTERNAL_STORAGE 权限,并通过系统设置页引导用户手动授权。原代码中直接使用 Environment.getExternalStoragePublicDirectory() + WRITE_EXTERNAL_STORAGE 在新系统上必然失败,且 MediaStore.Audio.Media.getContentUriForPath() 在 Android 10+ 已被弃用,需彻底重构。

✅ 关键修复点说明

  1. 动态权限逻辑分层适配

    • API :仍可请求 WRITE_EXTERNAL_STORAGE + READ_EXTERNAL_STORAGE(需在 AndroidManifest.xml 中声明);
    • API ≥ 31(Android 12+):必须使用 MANAGE_EXTERNAL_STORAGE,并通过 Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION(优先)或 Settings.ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION(兼容 fallback)跳转设置页;
    • 注意:MANAGE_EXTERNAL_STORAGE 需在 AndroidManifest.xml 中声明,并在 Google Play 上提交理由审核(仅限必要场景,如文件管理器类应用)。
  2. 文件路径与写入方式优化
    原代码使用已废弃的 Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_MUSIC),在分区存储下不可写。修复后改用 Environment.getExternalStorageDirectory()(虽不推荐,但为兼容旧逻辑且满足铃声场景可接受),并确保父目录创建逻辑健壮:

File file = new File(Environment.getExternalStorageDirectory() + "/AndRody", N2);
if (!file.getParentFile().exists()) {
    file.getParentFile().mkdirs(); // 递归创建目录
}

同时,I/O 操作升级为 try-with-resources,避免资源泄漏:

Control iOS and Android devices through a deterministic CLI for agent-driven mobile testing and debugging with agent-device
Control iOS and Android devices through a deterministic CLI for agent-driven mobile testing and debugging with agent-device

通过会话感知的CLI驱动真实的移动应用,使代理能够检查UI状态、确定性地操作,并在调试过程中收集日志、网络跟踪和性能证据。

下载
try (InputStream inputStream = contentResolver.openInputStream(parse);
     OutputStream outputStream = new FileOutputStream(file)) {
    byte[] buffer = new byte[1024];
    int bytesRead;
    while ((bytesRead = inputStream.read(buffer)) != -1) {
        outputStream.write(buffer, 0, bytesRead);
    }
} catch (IOException e) {
    e.printStackTrace();
}
  1. MediaStore 插入字段标准化
    原代码使用已弃用的 _data、_size 等私有字段,新版本必须使用 MediaStore.Audio.Media 提供的常量:
ContentValues contentValues = new ContentValues();
contentValues.put(MediaStore.Audio.Media.DATA, file.getAbsolutePath());      // 替代 "_data"
contentValues.put(MediaStore.Audio.Media.TITLE, N1);                        // 替代 "title"
contentValues.put(MediaStore.Audio.Media.MIME_TYPE, "audio/mpeg");         // 替代 "mime_type"
contentValues.put(MediaStore.Audio.Media.SIZE, file.length());             // 替代 "_size"
contentValues.put(MediaStore.Audio.Media.IS_RINGTONE, true);               // 替代 "is_ringtone"

⚠️ 重要提醒:

  • MediaStore.Audio.Media.getContentUriForPath() 在 Android 10+ 返回 null,不可再使用。正确做法是直接向 MediaStore.Audio.Media.EXTERNAL_CONTENT_URI 插入(系统自动处理路径映射):
    Uri uri = contentResolver.insert(MediaStore.Audio.Media.EXTERNAL_CONTENT_URI, contentValues);
  • 设置默认铃声时,RingtoneManager.setActualDefaultRingtoneUri() 的第三个参数应为插入后返回的 Uri(即 uri),而非依赖 getContentUriForPath()。

? 完整清单检查

项目 要求 示例
Manifest 声明

必须按 SDK 分级声明
targetSdkVersion 建议设为 33 或 34,启用分区存储强制模式 android:targetSdkVersion="34"
权限请求时机 requestPermission() 中根据 Build.VERSION.SDK_INT 分支调用不同流程 见上方修复代码
媒体扫描(可选) 插入后可发送广播触发媒体扫描:sendBroadcast(new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE, Uri.fromFile(file))); 提升文件可见性

通过以上改造,应用即可在 Android 9 至 Android 14 全系列版本中稳定完成铃声文件写入、媒体库注册及设为默认铃声操作。核心原则是:放弃路径直写思维,拥抱 MediaStore 标准化接口;按 SDK 版本精准申请对应权限;杜绝私有字段与已弃用 API。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

android

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
android开发三大框架
android开发三大框架

android开发三大框架是XUtil框架、volley框架、ImageLoader框架。本专题为大家提供android开发三大框架相关的各种文章、以及下载和课程。

2023.08.14

942

4

android是什么系统
android是什么系统

Android是一种功能强大、灵活可定制、应用丰富、多任务处理能力强、兼容性好、网络连接能力强的操作系统。本专题为大家提供android相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.22

2887

5

android权限限制怎么解开
android权限限制怎么解开

android权限限制可以使用Root权限、第三方权限管理应用程序、ADB命令和Xposed框架解开。详细介绍:1、Root权限,通过获取Root权限,用户可以解锁所有权限,并对系统进行自定义和修改;2、第三方权限管理应用程序,用户可以轻松地控制和管理应用程序的权限;3、ADB命令,用户可以在设备上执行各种操作,包括解锁权限;4、Xposed框架,用户可以在不修改系统文件的情况下修改应用程序的行为和权限。

2023.09.19

5917

7

android重启应用的方法有哪些
android重启应用的方法有哪些

android重启应用有通过Intent、PendingIntent、系统服务、Runtime等方法。本专题为大家提供Android相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.18

785

5

Android语音播放功能实现方法
Android语音播放功能实现方法

实现方法有使用MediaPlayer实现、使用SoundPool实现两种。可以根据具体的需求选择适合的方法进行实现。想了解更多语音播放的相关内容,可以阅读本专题下面的文章。

2024.03.01

984

5

CVE-2026-114938高危漏洞修复
CVE-2026-114938高危漏洞修复

Java4Shell是OpenJDK Base64解码路径中的远程代码执行漏洞,编号CVE-2026-114938,2026年11月17日披露,官方已发布17.0.21.1、21.0.13.1等修复版本,建议优先升级 。本专题围绕Java4Shell(CVE-2026-114938)持续更新,从漏洞原理、受影响版本、受影响产品到修复与自查一站式汇总,适合Java开发、运维与安全人员快速定位风险。ARM64环境不受影响,x86-64环境请

2026.11.22

0

11

Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

2026.11.20

20

7

Navicat入门教程大全
Navicat入门教程大全

本专题整理Navicat入门教程,从认识软件界面到开展数据库操作,介绍初次使用需要了解的知识和方法。内容兼顾连接配置、数据管理及日常使用中的疑问,方便用户按学习进度查阅,为后续实践和独立操作打好基础。

2026.11.20

20

17

Navicat数据库连接配置指南
Navicat数据库连接配置指南

从确认数据库信息到建立可用连接,本专题串联Navicat连接数据库的相关知识和操作方法。既有初次配置时需要了解的基础内容,也有连接后的检查思路,方便用户按实际需求查阅教程,逐步熟悉数据库连接的设置流程。

2026.11.20

0

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Excel 教程
Excel 教程

共162课时 | 46.1万人学习

Java 教程
Java 教程

共578课时 | 201.2万人学习

Uniapp从零开始实现新闻资讯应用
Uniapp从零开始实现新闻资讯应用

共64课时 | 9.8万人学习