Flutter WebRTC 在 Android 14 上的屏幕录制权限问题深度解析

背景介绍

随着 Android 系统的不断升级，Google 对用户隐私和安全性的要求越来越高。Android 14 针对媒体投影(Media Projection)功能引入了更严格的权限控制机制，这对使用 Flutter WebRTC 进行屏幕录制的开发者带来了新的挑战。本文将深入分析这一问题的根源，并提供完整的解决方案。

问题现象

在 Android 14 设备上，当开发者尝试使用 Flutter WebRTC 进行屏幕录制时，应用会出现崩溃，错误日志中会显示类似以下内容：

java.lang.SecurityException: Media projections require a foreground service of type ServiceInfo.FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION

或者

java.lang.SecurityException: Starting FGS with type mediaProjection requires permissions

这些错误表明应用缺少必要的权限或服务类型声明，导致系统拒绝屏幕录制请求。

问题根源分析

Android 14 对媒体投影功能做了以下重要变更：

1. 前台服务类型要求：必须使用特定类型的前台服务(Foreground Service)才能进行屏幕录制
2. 权限细化：新增了专门的媒体投影权限，与普通的前台服务权限区分
3. 运行时检查：系统会在运行时严格验证权限和服务配置

这些变更旨在防止应用在后台偷偷进行屏幕录制，保护用户隐私。但同时也要求开发者必须正确配置应用才能使用屏幕录制功能。

完整解决方案

1. AndroidManifest.xml 配置

在 Android 清单文件中需要添加以下关键配置：

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

<service
    android:name="de.julianassmann.flutter_background.IsolateHolderService"
    android:enabled="true"
    android:exported="false"
    android:foregroundServiceType="mediaProjection" />

2. 动态权限请求

在 Dart 代码中需要请求以下权限：

await [
  Permission.systemAlertWindow,
  Permission.camera,
  Permission.microphone,
  // 其他必要权限...
].request();

3. 正确的调用顺序

在 Android 14 上，必须遵循以下调用顺序：

1. 先获取用户授权进行屏幕录制
2. 然后启动前台服务
3. 最后开始实际的屏幕录制

这个顺序不能颠倒，否则会导致权限检查失败。

常见问题排查

1. 服务启动失败：检查是否正确定义了前台服务类型
2. 权限拒绝：确认所有必要权限都已声明并获取
3. 后台限制：Android 14 不允许在后台启动屏幕录制
4. 厂商定制系统：某些厂商系统可能有额外的限制

最佳实践建议

1. 优雅降级处理：当检测到 Android 14+ 设备时，采用新的权限请求流程
2. 用户引导：清晰解释为什么需要这些权限
3. 错误处理：捕获并妥善处理权限拒绝的情况
4. 测试覆盖：在各种 Android 版本和设备上充分测试

总结

Android 14 的权限变更虽然增加了开发复杂度，但确实提升了用户隐私保护水平。通过正确配置权限和服务，并遵循新的调用顺序，开发者可以顺利实现屏幕录制功能。理解这些变更背后的设计理念，有助于我们开发出既功能强大又尊重用户隐私的应用。

对于 Flutter WebRTC 项目，建议密切关注官方更新，因为随着 Android 系统的演进，相关的适配工作可能会持续进行。同时，也要注意不同 Flutter 插件之间的兼容性问题，确保整个技术栈都能支持最新的 Android 特性。