RK3588 Android 12 异显功能开发实战：命令行与Presentation双方案解析

1. 初识RK3588的异显能力不止是“多接一个屏幕”如果你手头有一块搭载了瑞芯微RK3588芯片的开发板比如Firefly的ITX-3588J或者Rock 5B并且已经刷好了Android 12系统那你手里握着的其实是一个“多屏怪兽”的潜力股。很多朋友刚开始玩RK3588可能只把它当做一个性能更强的电视盒子或者迷你主机接上一个显示器就完事了。但今天我要跟你聊的是把它真正的实力榨出来——异显功能。所谓“异显”听起来有点技术范儿说白了就是让不同的屏幕显示完全不同的内容。这和你用Windows系统扩展桌面是一个道理主屏写代码副屏查文档互不干扰。但在嵌入式领域尤其是在Android系统上这个功能的意义就大不一样了。想象一下这些场景商场的数字标牌主屏播放促销视频旁边的副屏展示二维码和商品详情智能座舱里中控大屏导航副驾娱乐屏看电影工业控制台上主屏显示总控界面副屏实时监控设备状态。这些都是异显的典型应用。RK3588凭借其强大的多媒体处理能力和丰富的显示接口支持多路HDMI、eDP、MIPI-DSI等在硬件上为多屏异显提供了坚实的基础。而Android 12系统则从软件框架层面给予了更好的支持。我们开发者要做的就是学会如何“指挥”Android系统把指定的应用界面精准地投放到指定的屏幕上去。这篇文章我就结合自己实际在RK3588上折腾Android 12的经验给你掰开揉碎了讲两种最核心的实现方案直接了当的命令行控制和灵活强大的Presentation框架。无论你是想快速验证功能还是要开发稳定的商业应用都能找到适合你的路子。2. 命令行方案快速验证与系统级控制的利器当你拿到一个新板子或者需要快速测试多屏显示是否正常时命令行方式是你的最佳拍档。它不需要你编写复杂的应用代码直接通过ADBAndroid Debug Bridge工具就能操作非常高效。这种方式更像是直接与Android系统的显示服务“对话”进行底层配置。2.1 核心命令将Activity定点投放到指定屏幕整个命令行方案的核心其实就围绕一个非常强大的amActivity Manager命令展开。它的基本格式如下adb shell am start --display display_id activity_name我来解释一下这几个参数--display display_id这是关键。它指定了目标显示器的ID。在Android系统中主屏的ID通常是0。当你接入第二个屏幕比如通过HDMI系统会为其分配一个新的ID可能是1、2等等。你可以通过adb shell dumpsys display命令来查看所有已连接屏幕的详细信息其中就包括它们的DisplayId。activity_name这就是你想要启动的应用界面的完整组件名。格式通常是包名/包名.活动名。例如你想启动系统设置可能就是com.android.settings/.Settings。实战操作一下假设你的RK3588开发板已经连接了两个显示器主屏ID0显示着桌面。现在你想把“计算器”应用单独拉到副屏ID1上去显示。你可以这样做首先找到计算器应用的包名和主Activity名。一个简单的方法是先在主屏上打开计算器然后执行adb shell dumpsys window | grep mCurrentFocus输出可能会是mCurrentFocusWindow{... com.google.android.calculator/com.android.calculator2.Calculator}。那么Activity名就是com.google.android.calculator/com.android.calculator2.Calculator。然后执行我们的核心命令adb shell am start --display 1 com.google.android.calculator/com.android.calculator2.Calculator如果一切顺利你就会看到计算器应用在副屏上弹出来了而主屏的桌面不受影响。这个方法非常适合做快速的功能演示或者当你开发了一个新的Launcher桌面应用想让它默认在某个副屏上启动时这个命令就派上用场了。2.2 控制屏幕旋转应对横屏与竖屏设备在实际项目中我们连接的副屏可能是各种形态的横屏的广告屏、竖屏的查询机等等。这就需要我们能控制每个屏幕的旋转方向。RK3588的Android系统通过一系列持久化属性persist.sys.rotation.*来管理这个功能。对于双屏场景主屏的旋转通常由系统自动感应或通过标准设置管理。而副屏假设接在某个特定的端口比如HDMI-1的旋转则可以通过以下属性控制adb shell setprop persist.sys.rotation.einit-1 value这里的value取值为0、1、2、3分别代表0: 旋转0度默认方向1: 旋转90度2: 旋转180度3: 旋转270度例如你想让副屏顺时针旋转90度变成竖屏显示就执行adb shell setprop persist.sys.rotation.einit-1 1重要提示修改这个属性后需要重启设备才能生效。这是因为屏幕方向是在系统服务初始化早期就确定的热修改无法触发生效。所以这更适合在出厂前或固件定制时进行预设。对于更复杂的三屏甚至四屏场景RK3588同样支持。系统会为不同的物理显示端口定义对应的属性。例如你可能有persist.sys.rotation.einit-1对应port1比如第一个HDMI口persist.sys.rotation.einit-2对应port2比如第二个HDMI口或eDP接口你需要根据硬件连接的实际布局为每个副屏单独设置相应的属性。这为工业控制、多屏信息发布等需要多个不同方向屏幕的场景提供了极大的灵活性。2.3 实现鼠标跨屏穿梭提升交互体验当屏幕多起来后一个很自然的需求就是能不能让鼠标像在电脑上那样从一个屏幕边缘直接移动到另一个屏幕这个功能在RK3588的Android 12上默认可能是关闭的但我们可以通过一个简单的属性开关来激活它。adb shell setprop sys.mouse.presentation 1将这个属性值设置为1就开启了鼠标跨屏切换功能。开启后系统启动时鼠标指针默认会停留在主屏。当你把鼠标向主屏的边缘比如右边缘移动时指针不会卡住而是会“穿越”到相邻副屏的中心位置出现反之亦然。这个功能极大地提升了多屏使用的交互连贯性让体验更接近桌面操作系统。需要注意的一点这个属性sys.mouse.presentation和前面的旋转属性persist.sys.rotation.*前缀不同一个是sys.一个是persist.sys.。这意味著sys.mouse.presentation的修改在当前运行周期内立即生效但重启后会恢复默认值。而persist.sys.开头的属性则会持久化保存即使重启也会保留。所以如果你希望鼠标跨屏功能一直存在可能需要考虑在系统启动脚本如init.rc或某个服务中自动设置这个属性。3. Presentation框架方案构建稳定、可控的异显应用命令行方式虽然快捷但它更偏向于系统配置和调试。当我们真正要开发一个需要稳定运行、界面复杂的多屏应用时就必须深入到应用层使用Android SDK为我们提供的标准武器——Presentation类。你可以把Presentation理解成一个特殊的对话框Dialog但它的使命不是弹出在主屏幕上而是专门为了在副屏上显示内容而生的。它拥有自己的窗口和视图层级DecorView你可以在里面像构建普通Activity界面一样使用各种布局和控件。3.1 第一步搞定“画中画”权限由于Presentation需要将内容绘制到其他屏幕这涉及“在其他应用上层显示”的能力因此需要一个特殊的权限SYSTEM_ALERT_WINDOW也就是常说的“悬浮窗权限”。这是一个危险权限申请方式和我们熟悉的相机、定位权限不太一样。首先在项目的AndroidManifest.xml文件中声明权限uses-permission android:nameandroid.permission.SYSTEM_ALERT_WINDOW / !-- Android 10及以上版本有时也需要这个 -- uses-permission android:nameandroid.permission.SYSTEM_OVERLAY_WINDOW /然后在代码中动态申请。关键点在于不能使用ActivityCompat.requestPermissions那一套而是需要引导用户跳转到系统的专门设置页面。下面是一个典型的申请代码块// 检查是否是Android 6.0 (Marshmallow) 及以上版本并且应用目标版本也23 if (Build.VERSION.SDK_INT Build.VERSION_CODES.M getApplicationInfo().targetSdkVersion Build.VERSION_CODES.M) { if (!Settings.canDrawOverlays(this)) { // 没有权限跳转到设置页面 Intent intent new Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION); // 关键指定自己的包名直接定位到本应用的权限设置页用户体验更好 intent.setData(Uri.parse(package: getPackageName())); intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); startActivity(intent); // 注意这里不建议用startActivityForResult等待回调因为用户可能在系统设置页停留很久甚至不返回。 // 更佳实践是在onResume中再次检查权限状态。 } else { // 已有权限可以开始进行异显相关操作了 Toast.makeText(this, 悬浮窗权限已获取可以启动异显, Toast.LENGTH_SHORT).show(); setupPresentation(); } }在实际开发中我习惯在应用主Activity的onResume()方法里检查这个权限状态因为用户从系统设置页面返回后会触发onResume我们可以在这里判断是否授权成功然后执行后续逻辑。3.2 第二步找到你的“第二块画布”——获取Display对象有了权限接下来就要找到你要投放内容的那个屏幕Display。Android系统通过DisplayManager来管理所有显示器。这里有几种常用的获取副屏Display对象的方法各有适用场景。方式一通过MediaRouter获取适合无线投屏场景这种方式最初是为无线显示如Chromecast Miracast设计的。如果你的副屏是通过无线协议连接的这个方法比较合适。MediaRouter mediaRouter (MediaRouter) getSystemService(Context.MEDIA_ROUTER_SERVICE); MediaRouter.RouteInfo routeInfo mediaRouter.getSelectedRoute(MediaRouter.ROUTE_TYPE_LIVE_VIDEO); // 注意类型 Display presentationDisplay (routeInfo ! null) ? routeInfo.getPresentationDisplay() : null; if (presentationDisplay ! null) { showPresentation(presentationDisplay); } else { // 没有找到可用的无线显示设备 }方式二获取所有演示用显示器最常用这是我最推荐也是最稳定可靠的方法。DISPLAY_CATEGORY_PRESENTATION这个分类基本上就代表了除了主屏之外可用于内容演示的屏幕包括有线连接的HDMI、DP等。DisplayManager displayManager (DisplayManager) getSystemService(Context.DISPLAY_SERVICE); Display[] presentationDisplays displayManager.getDisplays(DisplayManager.DISPLAY_CATEGORY_PRESENTATION); if (presentationDisplays.length 0) { // 通常取第一个如果你有多个副屏可能需要根据Display的ID或名称来区分 showPresentation(presentationDisplays[0]); } else { Toast.makeText(this, 未检测到可用的扩展显示屏, Toast.LENGTH_SHORT).show(); }方式三获取所有显示器并手动筛选这个方法会拿到包括主屏在内的所有显示器列表。你需要自己判断哪个是副屏通常DisplayId不为0的就是。DisplayManager displayManager (DisplayManager) getSystemService(Context.DISPLAY_SERVICE); Display[] allDisplays displayManager.getDisplays(); for (Display display : allDisplays) { if (display.getDisplayId() ! Display.DEFAULT_DISPLAY) { // 排除默认主屏 // 这里你可以进一步检查display的flags、type等确定是否适合做Presentation showPresentation(display); break; } }3.3 第三步创建并展示你的Presentation拿到目标Display对象后创建和展示Presentation就很简单了。你需要继承Presentation类并在其onCreate方法中设置你的界面。public class MyPresentation extends Presentation { private Context mContext; public MyPresentation(Context context, Display display) { super(context, display); this.mContext context; } Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); // 这里可以设置你的自定义视图 setContentView(R.layout.presentation_layout); // 像在Activity里一样初始化你的UI控件 TextView textView findViewById(R.id.tv_on_presentation); Button button findViewById(R.id.btn_on_presentation); button.setOnClickListener(v - { Toast.makeText(mContext, 按钮在副屏上被点击了, Toast.LENGTH_SHORT).show(); }); } Override protected void onStop() { super.onStop(); // 释放资源 } }在宿主Activity中这样使用它private MyPresentation mPresentation; private Display mTargetDisplay; private void showPresentation(Display display) { if (mPresentation ! null mPresentation.isShowing()) { mPresentation.dismiss(); } mTargetDisplay display; mPresentation new MyPresentation(MainActivity.this, display); // 关键一步必须设置窗口类型为系统警告窗口否则可能无法显示 mPresentation.getWindow().setType(WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY); try { mPresentation.show(); } catch (WindowManager.InvalidDisplayException e) { // 处理异常例如显示器已断开 Log.e(Presentation, 无法在指定的Display上显示, e); } }一个非常重要的坑我踩过在show()之前务必调用getWindow().setType()设置窗口类型。在旧版本Android上常用TYPE_SYSTEM_ALERT但在新版本尤其是Android 8.0以上更推荐使用TYPE_APPLICATION_OVERLAY并且需要配合前面申请的SYSTEM_ALERT_WINDOW权限。不设置这个类型Presentation很可能显示不出来。4. 双方案对比与实战场景选择聊了这么多你可能有点懵到底该用命令行还是Presentation别急我画个表格帮你理清思路再分享几个我实际项目中的使用场景。特性维度命令行方案Presentation框架方案上手速度⭐⭐⭐⭐⭐ 极快几条命令即可⭐⭐⭐ 需要编写应用代码理解API控制粒度较粗针对整个Activity⭐⭐⭐⭐⭐ 极细可控制到每个View自定义UI灵活性较低依赖系统命令和属性⭐⭐⭐⭐⭐ 极高可动态创建、销毁、交互稳定性高系统级命令高Android官方标准API适用阶段功能验证、快速测试、系统定制产品级应用开发、需要复杂交互的UI交互能力无仅启动和配置⭐⭐⭐⭐⭐ 完整支持触摸、按键等所有事件生命周期管理无随Activity生命周期有可监听onStart/onStop管理资源场景一固件出厂预配置命令行方案主场假设你在做一款商显主板需要出厂时就把副屏竖屏广告屏旋转90度并且让一个定制的信息发布App在副屏上自启动。这个场景下Presentation就太重了。你可以在系统编译时直接修改init.rc或设备配置文件设置persist.sys.rotation.einit-11。然后修改系统属性让副屏在启动时自动执行am start --display 1 com.yourcompany.ads/.MainActivity。这样设备一开机所有显示状态就都到位了稳定可靠。场景二交互式自助终端Presentation方案主场开发一个银行自助终端主屏是操作界面取款、查询副屏是广告和宣传视频。你需要主屏App运行时动态检测副屏连接。在副屏上播放高清视频并显示一些动态促销信息。当用户在主屏进行敏感操作如输入密码时副屏内容需要暂停或切换为静态logo。副屏的界面布局和交互可能与主屏完全不同。这种动态、强交互、UI自定义要求高的场景就必须用Presentation了。你可以在主App里创建两个Presentation一个用于播放视频使用SurfaceViewMediaPlayer一个用于显示图文信息。根据业务逻辑灵活地在副屏上切换或组合显示它们用户体验会非常好。场景三开发调试与问题排查双剑合璧在实际开发中两种方案经常混合使用。比如我用Presentation开发了一个复杂的副屏界面但偶尔发现副屏不亮。我首先会用adb shell dumpsys display命令查看副屏的物理连接状态、分辨率、刷新率是否正常。然后用命令行am start一个简单的测试Activity到副屏确认硬件和基础驱动没问题。排除了硬件问题后再回头检查自己的Presentation代码比如权限是否真的授权成功、窗口类型是否设置正确、Display对象是否获取到了。这种组合排查法效率非常高。最后无论选择哪种方案在RK3588上进行异显开发时都要时刻关注性能。多屏显示会占用更多的GPU和内存带宽。尤其是在副屏播放高分辨率视频或进行复杂动画时需要做好性能优化比如使用硬件解码、减少视图层级等。另外记得处理好屏幕热插拔事件DisplayManager.DisplayListener让你的应用在用户插拔HDMI线时能优雅地应对而不是直接崩溃。多屏的世界很精彩希望这些实战经验能帮你少走弯路更快地把想法变成现实。