Ant-Media-Server Android SDK 屏幕共享功能在TargetSdkVersion 34下的适配问题解析

问题背景

在Ant-Media-Server的Android SDK中，屏幕共享功能在将targetSdkVersion升级到34后出现了兼容性问题。开发者反馈在Android 14设备上运行时会出现崩溃，而在targetSdkVersion 33及以下版本则工作正常。这一问题直接影响了应用在Google Play商店的上架，因为Google要求新应用必须至少以API级别34为目标。

错误分析

初始崩溃日志分析

当尝试启动屏幕共享服务时，系统抛出了安全异常：

SecurityException: Starting FGS with type mediaProjection 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]

这表明在Android 14中，使用媒体投影服务作为前台服务时，需要额外的权限声明。这与Android 14对前台服务和媒体投影权限的强化管理有关。

添加权限后的二次崩溃

开发者在Manifest中添加了以下权限后：

<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PROJECTION" />
<uses-permission android:name="android.permission.CAPTURE_VIDEO_OUTPUT"
    tools:ignore="ProtectedPermissions" />
<uses-permission android:name="android.permission.PROJECT_MEDIA" />

系统又抛出了新的安全异常：

SecurityException: Don't re-use the resultData to retrieve the same projection instance, 
and don't use a token that has timed out. Don't take multiple captures by invoking 
MediaProjection#createVirtualDisplay multiple times on the same instance.

这表明媒体投影令牌的使用方式不符合Android 14的新规范，可能存在令牌重用或超时使用的问题。

技术解决方案

权限适配

针对Android 14(targetSdkVersion 34)的媒体投影服务，需要在AndroidManifest.xml中添加以下权限：

1. FOREGROUND_SERVICE_MEDIA_PROJECTION - 允许将媒体投影服务作为前台服务运行
2. CAPTURE_VIDEO_OUTPUT - 视频输出捕获权限(需要特殊签名)
3. PROJECT_MEDIA - 媒体投影权限

媒体投影令牌管理

Android 14对媒体投影API的使用实施了更严格的限制：

1. 禁止重用投影实例：不能重复使用同一个ResultData获取投影实例
2. 令牌时效性：不能使用已超时的令牌
3. 单一捕获原则：不能在同一实例上多次调用createVirtualDisplay

解决方案包括：

• 确保每次屏幕共享都使用新的媒体投影令牌
• 及时释放不再使用的投影实例
• 避免在同一个MediaProjection实例上创建多个虚拟显示

前台服务类型声明

在Service的onCreate方法中，需要正确声明前台服务类型：

@Override
public void onCreate() {
    super.onCreate();
    Notification notification = createNotification();
    startForeground(NOTIFICATION_ID, notification);
    // 在Android 14+需要指定服务类型
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
        startForeground(NOTIFICATION_ID, notification, 
            ServiceInfo.FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION);
    } else {
        startForeground(NOTIFICATION_ID, notification);
    }
}

实现建议

1. 版本兼容处理：针对不同Android版本实现不同的权限申请和媒体投影处理逻辑
2. 生命周期管理：确保及时释放媒体投影资源，避免内存泄漏
3. 错误处理：增强对媒体投影失败情况的处理，提供友好的用户反馈
4. 测试覆盖：特别针对Android 14设备进行充分测试

总结

Ant-Media-Server Android SDK在targetSdkVersion 34下的屏幕共享功能适配，主要涉及三个方面：新增权限声明、媒体投影API的合规使用以及前台服务类型的正确指定。通过遵循Android 14的新规范，开发者可以确保屏幕共享功能在不同版本Android设备上的稳定运行，同时满足Google Play的上架要求。这一案例也反映了随着Android系统的演进，开发者需要持续关注平台安全策略的变化，及时调整应用实现方式。