XXPermissions项目在Android 14上处理录音权限的注意事项

在Android 14系统中，开发者在使用XXPermissions库处理录音权限时需要注意一些新的权限要求变化。本文将详细分析这些变化及其解决方案。

问题现象

部分Android 14设备在使用XXPermissions库申请录音权限时，可能会遇到以下安全异常：

SecurityException: Starting FGS with type mediaProjection callerApp=ProcessRecord{...} targetSDK=34 requires permissions: all of the permissions allOf=true [android.permission.FOREGROUND_SERVICE_MEDIA_PROJECTION] any of the permissions allOf=false [android.permission.CAPTURE_VIDEO_OUTPUT, android:project_media]

问题分析

这个异常实际上与XXPermissions库本身无关，而是Android 14系统对前台服务的新要求导致的。在Android 14中，当应用需要启动与媒体投影相关的前台服务时，系统会额外检查以下权限：

1. FOREGROUND_SERVICE_MEDIA_PROJECTION权限
2. CAPTURE_VIDEO_OUTPUT或project_media权限

需要注意的是，FOREGROUND_SERVICE_MEDIA_PROJECTION既不属于危险权限，也不属于特殊权限，因此不需要通过动态权限申请流程获取。

解决方案

要解决这个问题，开发者需要在应用的AndroidManifest.xml文件中声明以下权限：

<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PROJECTION"/>

这个权限属于普通权限，只需要在清单文件中声明即可，不需要动态申请。添加此声明后，应用在Android 14设备上启动与媒体投影相关的前台服务时就不会再出现上述异常。

注意事项

1. 这个问题主要出现在targetSdkVersion为34的应用在Android 14设备上运行时
2. 本地测试可能难以复现，建议通过Firebase等远程错误报告工具监控
3. 即使添加了权限声明，仍需确保应用正确处理了录音权限(RECORD_AUDIO)的动态申请

总结

Android 14引入了一些新的权限要求，特别是对于前台服务的特殊用途权限。开发者在使用XXPermissions库处理录音权限时，除了关注传统的危险权限外，还需要注意这些新的普通权限要求。通过在清单文件中正确声明FOREGROUND_SERVICE_MEDIA_PROJECTION权限，可以避免在Android 14设备上出现相关异常。