RootEncoder项目在Android 14适配中的关键问题解析

背景概述

随着Android 14的发布，许多开发者在使用RootEncoder项目进行屏幕流媒体传输时遇到了兼容性问题。本文针对从Android 13升级到Android 14过程中出现的关键技术问题进行深入分析，并提供完整的解决方案。

核心问题分析

1. 权限变更导致的崩溃问题

在Android 14中，Google引入了更严格的媒体投影权限控制机制。当应用尝试使用MediaProjection API时，系统会强制要求特定的前台服务类型声明。错误信息表现为：

_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]_

2. 类文件版本不兼容问题

在尝试升级RootEncoder库版本时，开发者遇到了Java版本兼容性问题：

com/pedro/rtmp/flv/video/ProfileIop.class) class file has wrong version 61.0, should be 55.0

这是由于新版本库使用了Java 17编译，而项目环境可能仍在使用较低版本的Java。

详细解决方案

前台服务配置

针对权限问题，必须在AndroidManifest.xml中正确声明前台服务类型：

<service 
    android:name=".YourStreamService"
    android:foregroundServiceType="mediaProjection|camera|microphone" />

根据实际使用场景选择需要的服务类型组合：

• 仅屏幕录制：mediaProjection
• 包含音频录制：增加microphone
• 包含摄像头：增加camera

Java版本兼容性处理

有两种推荐方案：

1. 保持旧版本：继续使用2.1.9版本库，避免Java版本冲突
2. 升级项目环境：将项目Java版本升级至17以兼容新版本库

MediaProjection回调注册问题

Android 14新增了强制回调注册要求，错误表现为：

java.lang.IllegalStateException: Must register a callback before starting capture

解决方案需要修改DisplayBase类，在startEncoders方法中添加回调注册：

mediaProjection.registerCallback(new MediaProjection.Callback() {
    @Override
    public void onStop() {
        stopStream();
    }
}, handler);

对于无法直接修改库的情况，建议：

1. 复制DisplayBase和RtmpDisplay类到项目中
2. 修改复制的DisplayBase类，添加回调注册逻辑
3. 让RtmpDisplay继承修改后的DisplayBase

最佳实践建议

1. 渐进式升级：先解决权限和服务问题，再处理Java版本升级
2. 兼容性测试：在Android 14设备上充分测试各功能模块
3. 代码隔离：对库的修改尽量通过继承方式实现，便于后续升级
4. 权限管理：动态检查并请求所有必要权限，包括新引入的权限类型

总结

Android 14对媒体投影和前台服务的限制更加严格，RootEncoder项目需要相应调整才能保证兼容性。通过正确配置服务声明、处理Java版本兼容性以及添加必要的回调注册，开发者可以顺利完成从Android 13到14的迁移工作。建议开发者在进行此类升级时，仔细阅读Android 14的行为变更文档，特别是关于前台服务和权限管理的变化部分。