1. 项目概述当你的应用在辅助屏上“罢工”最近在做一个需要双屏展示的Android项目遇到了一个挺典型的问题应用在辅助屏上要么黑屏要么直接崩溃控制台抛出的错误信息五花八门核心指向一个点——应用不支持在辅助屏上显示。这可不是简单地在AndroidManifest.xml里加个supportsPictureInPicture就能解决的。双屏异显尤其是利用Activity和Presentation类来实现涉及到Android显示系统、窗口管理、生命周期等一系列复杂机制的协同。很多开发者包括我自己在第一次深入时都容易掉进一些“坑”里比如主副屏生命周期不同步、资源释放不及时导致内存泄漏或者因为对Display对象的理解偏差而无法正确创建展示窗口。这个问题的本质是开发者对Android多屏显示架构的理解不够深入以及Activity与Presentation在异显场景下的特殊交互模式没有处理好。它不仅仅是一个API调用问题更是一个关于如何协调两个独立显示表面、管理两套可能独立的UI组件生命周期的系统工程。适合阅读这篇内容的是那些正在或计划开发需要投屏、演讲辅助、车载双屏、零售双屏展示等功能的Android开发者。无论你是刚刚接触Presentation类还是在双屏开发中遇到了奇怪的兼容性问题希望这篇从实际踩坑中总结的经验能帮你理清思路避开那些我趟过的雷区。2. 核心问题拆解为什么Activity双屏异显会出问题当我们谈论“应用不支持在辅助屏上显示”时通常不是指系统层面禁止而是我们的代码实现没有满足多屏显示的正确条件。Android从4.2API Level 17开始引入了对多显示器的官方支持核心类是Presentation。它本质上是一个特殊的Dialog但其窗口会与一个特定的Display显示设备关联。问题往往出在我们将Activity的逻辑与Presentation的显示生硬结合的过程中。2.1 显示Display对象的获取与有效性第一个拦路虎是如何正确获取并持有代表辅助屏的Display对象。很多初学者的代码是这样的在Activity的onCreate中通过DisplayManager获取显示列表然后假设第二个Display就是外接屏幕随即创建Presentation。这里有几个隐患显示列表动态变化外接屏幕可能随时插拔如HDMI热插拔。你onCreate时获取的Display可能在几秒后就无效了。直接使用一个可能失效的Display对象去创建Presentation是导致“不支持显示”的常见原因之一。Display类型判断错误并非所有Display都适合展示内容。系统内置的虚拟显示、无线显示如Miracast可能有不同的特性。你需要检查Display.FLAG_PRESENTATION标志或者更具体地通过Display.getType()方法判断是否为TYPE_EXTERNAL类型并且其状态STATE_ON。主副屏混淆在有多于两个屏幕的场景例如设备自带屏两个外接显示器你需要有策略地选择哪个是“辅助屏”。简单地取数组第二个元素是不可靠的。注意Display对象只是一个描述符它本身不包含图形缓冲区。创建Presentation时系统会检查这个Display是否仍然有效且具备渲染能力。无效的Display会直接导致Presentation构造失败。2.2 Activity与Presentation的生命周期纠缠这是最核心、也最易出错的部分。Presentation依附于一个Activity作为其上下文但它的显示生命周期与Activity并不同步却又深受其影响。创建时机不当在Activity的onCreate或onResume中立即创建Presentation可能失败因为此时窗口可能还未完全准备好或者Display的详细信息还未完全同步。更稳妥的做法是在onWindowFocusChanged确认获得焦点后或者在接收到DisplayManager的显示变化回调后再尝试创建。销毁时机不当这是内存泄漏的重灾区。常见的错误是在Activity的onPause或onStop中忘记销毁Presentation。虽然Presentation是Dialog的子类但如果你没有显式调用dismiss()它所持有的视图层级、位图等资源不会被释放。更复杂的是当Activity因配置变更如旋转屏幕重建时旧的Activity实例被销毁新实例创建。如果Presentation持有旧Activity上下文的引用例如通过内部类就会导致旧Activity无法被GC回收。上下文Context的误用Presentation需要传入一个上下文通常我们传入宿主Activity。这意味着Presentation内部的视图和资源解析都基于这个Activity的上下文。如果Presentation中使用了Activity特有的资源或主题而该Activity进入后台或销毁就可能引发异常。一种最佳实践是使用Application上下文来创建Presentation内部的视图如LayoutInflater.from(context.applicationContext)但这又可能带来主题应用的问题需要权衡。2.3 窗口类型与标志的冲突Presentation在创建窗口时可以设置一些窗口标志Window Flags。有时这些标志会与系统策略或其他应用冲突导致窗口无法显示。例如如果你为Presentation的窗口设置了FLAG_SECURE防截图在某些要求共享内容的场景如无线投屏到某些电视下系统可能会拒绝显示。再比如没有正确设置FLAG_LOCAL_FOCUS_MODE可能导致输入焦点在双屏间混乱。3. 双屏异显的稳健实现方案基于以上问题我们需要一套更健壮的实现方案。这个方案的核心思想是监听显示变化按需创建/销毁Presentation并严格管理其生命周期使其与宿主Activity解耦。3.1 显示管理器的注册与监听我们不应该在某个时间点静态地获取Display而应该动态监听显示设备的变化。class DualScreenActivity : AppCompatActivity() { private lateinit var displayManager: DisplayManager private var presentation: MyPresentation? null private val displayListener object : DisplayManager.DisplayListener { override fun onDisplayAdded(displayId: Int) { // 有新屏幕接入 updatePresentation(displayId) } override fun onDisplayRemoved(displayId: Int) { // 有屏幕移除 if (presentation?.display?.displayId displayId) { dismissPresentation() } } override fun onDisplayChanged(displayId: Int) { // 屏幕属性改变如分辨率、旋转 if (presentation?.display?.displayId displayId) { // 通常需要重建Presentation以适应新的显示参数 recreatePresentationForDisplay(displayId) } } } override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) displayManager getSystemService(Context.DISPLAY_SERVICE) as DisplayManager } override fun onResume() { super.onResume() // 注册监听器监听所有显示设备的变化 displayManager.registerDisplayListener(displayListener, null) // 检查当前已连接的屏幕并尝试为辅助屏创建Presentation val displays displayManager.displays for (display in displays) { if (display.displayId ! windowManager.defaultDisplay.displayId isValidExternalDisplay(display)) { createPresentationIfNeeded(display) break // 假设只处理第一个有效的外接屏 } } } override fun onPause() { super.onPause() // 可选在Activity不可见时销毁Presentation以节省资源。 // 但需根据业务决定例如演讲时希望副屏在Activity onPause时如接电话保持显示。 // dismissPresentation() displayManager.unregisterDisplayListener(displayListener) } override fun onDestroy() { super.onDestroy() // 最终保障确保资源释放 dismissPresentation() } }关键点在于isValidExternalDisplay(display)函数它需要执行我们之前提到的检查private fun isValidExternalDisplay(display: Display): Boolean { // 检查是否为物理外部显示 if (display.type ! Display.TYPE_EXTERNAL) { return false } // 检查显示是否已开启且就绪 if (display.state ! Display.STATE_ON) { return false } // 可选检查标志确认适合做演示 if (display.flags and Display.FLAG_PRESENTATION 0) { return false } // 检查显示模式是否有效避免一些虚拟或无效显示 val mode display.mode if (mode null || mode.physicalWidth 0 || mode.physicalHeight 0) { return false } return true }3.2 Presentation类的实现与资源管理MyPresentation类的实现需要特别注意上下文和资源。class MyPresentation(context: Context, display: Display) : Presentation(context, display) { init { // 设置窗口标志例如允许触摸、保持屏幕常亮等 window?.apply { addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON) // 谨慎设置FLAG_SECURE // addFlags(WindowManager.LayoutParams.FLAG_SECURE) } } override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) // 关键使用Application Context来Inflate视图避免持有Activity引用 val inflater LayoutInflater.from(context.applicationContext) val rootView inflater.inflate(R.layout.presentation_layout, null) as ViewGroup setContentView(rootView) // 初始化Presentation内的UI组件 val infoTextView rootView.findViewByIdTextView(R.id.tv_info) infoTextView.text 显示在副屏${display.name} // 处理副屏上的用户交互 rootView.findViewByIdButton(R.id.btn_action).setOnClickListener { // 与主Activity通信推荐使用广播、LiveData或接口回调避免直接持有Activity引用 sendActionToMainScreen(click_from_presentation) } } override fun onDisplayChanged(display: Display?) { super.onDisplayChanged(display) // 当关联的Display属性变化时调用可能需要调整UI布局 Log.d(Presentation, Display changed: $display) } override fun onDisplayRemoved() { super.onDisplayRemoved() // 当Display被移除时调用应进行清理 Log.d(Presentation, Display removed) dismiss() // 主动关闭自己 } private fun sendActionToMainScreen(action: String) { // 使用LocalBroadcastManager或EventBus等解耦方式通信 LocalBroadcastManager.getInstance(context.applicationContext) .sendBroadcast(Intent(ACTION_FROM_PRESENTATION).putExtra(data, action)) } }在宿主Activity中创建和销毁Presentationprivate fun createPresentationIfNeeded(display: Display) { if (presentation null || presentation?.display?.displayId ! display.displayId) { dismissPresentation() // 销毁旧的 try { presentation MyPresentation(this, display) // 传入Activity作为Context presentation?.show() } catch (e: WindowManager.InvalidDisplayException) { Log.e(DualScreen, 无法在显示设备上创建Presentation: ${display.name}, e) presentation null } catch (e: Exception) { Log.e(DualScreen, 创建Presentation失败, e) presentation null } } } private fun dismissPresentation() { presentation?.dismiss() presentation null } private fun recreatePresentationForDisplay(displayId: Int) { val display displayManager.getDisplay(displayId) display?.let { if (isValidExternalDisplay(it)) { createPresentationIfNeeded(it) } } }3.3 主副屏间的数据同步与通信双屏异显不仅仅是显示两个画面更需要数据状态同步。绝对要避免在Presentation中直接持有并操作主Activity的UI组件或数据。推荐几种通信方式ViewModel LiveData如果主Activity和Presentation共享同一个ViewModel通过ViewModelProvider传入相同的ViewModelStoreOwner如Activity那么数据变化可以自动同步。但要注意Presentation的生命周期。LocalBroadcastManager / EventBus适用于发送一次性事件或命令解耦效果好。接口回调弱引用如果必须使用回调确保Presentation持有对Activity的弱引用WeakReference防止内存泄漏。共享数据源数据层如Repository独立于UI层主副屏都观察同一个数据源如Room数据库的Flow、Retrofit的响应。4. 深度排查当问题依然出现时即使按照上述方案你可能还是会遇到一些棘手的情况。下面是一个常见问题排查清单。问题现象可能原因排查步骤与解决方案Presentation.show() 抛出WindowManager.InvalidDisplayException1. 传入的Display对象已失效如屏幕已拔出。2. 该Display不支持Presentation如某些虚拟显示。3. 窗口标志冲突。1. 在调用show()前再次检查display.isValid()。2. 检查Display的type和flags确保其FLAG_PRESENTATION。3. 尝试创建一个最简单的Presentation仅空白视图排除布局文件问题。4. 查看adb shell dumpsys window displays确认目标显示的状态和参数。副屏显示黑屏但日志无报错1.Presentation的布局文件加载失败或根视图宽高为0。2. 渲染线程问题如OpenGL上下文错误。3. 副屏的显示模式色彩空间、刷新率不兼容。1. 在Presentation.onCreate中打印布局加载日志检查视图层级。2. 为Presentation的根视图设置一个醒目的背景色如红色以确认是否绘制。3. 检查是否在非UI线程更新了Presentation内的视图。4. 尝试在创建Presentation时通过window?.setBackgroundDrawableResource(Color.RED)设置窗口背景。主屏Activity旋转或重建后副屏内容异常或消失1.Presentation未在Activity销毁前正确释放新Activity实例又创建了新的Presentation导致冲突。2.Presentation持有旧Activity的视图引用导致旧实例泄漏。1. 确保在Activity.onDestroy()中调用dismissPresentation()。2. 在Activity中重写onConfigurationChanged并手动处理Presentation的重建逻辑或在AndroidManifest.xml中为Activity配置configChangesorientation副屏触摸事件无响应1.Presentation的窗口未获得焦点或触摸事件被拦截。2. 布局中的视图设置了clickablefalse或enabledfalse。3. 输入通道可能被其他窗口独占。1. 检查Presentation的窗口是否设置了FLAG_NOT_FOCUSABLE或FLAG_NOT_TOUCHABLE。2. 确保按钮等可交互视图的clickable属性为true。3. 在Presentation的根视图上设置setOnTouchListener打印日志确认是否收到事件。内存泄漏LeakCanary报警1.Presentation内部类如匿名OnClickListener隐式持有外部Activity引用。2. 静态变量或单例持有了Presentation或Activity的引用。3.Handler或Timer任务未及时取消。1. 使用Application上下文创建Presentation内部视图。2. 将内部类改为静态内部类并使用弱引用与Activity通信。3. 在Presentation.dismiss()或onStop()中取消所有异步任务和监听器注册。4. 使用LeakCanary等工具进行精准定位。在特定设备如某些电视、车载系统上不工作1. 设备制造商定制了显示栈管理对Presentation支持不完整。2. 设备需要特定的显示模式或认证。3. 权限问题如SYSTEM_ALERT_WINDOW。1. 查阅设备制造商的开发者文档。2. 尝试使用MediaRouterAPI用于投屏作为备选方案。3. 检查是否需要在清单中声明特殊权限并动态请求。4. 联系设备厂商获取技术支持。5. 高级技巧与性能考量当基础功能稳定后我们可以关注一些提升体验和性能的方面。5.1 适配不同副屏的尺寸与密度外接显示器的尺寸、分辨率和密度可能千差万别。Presentation的上下文会使用其关联Display的指标但这可能和主屏不同。override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) val metrics DisplayMetrics() display.getMetrics(metrics) Log.d(Presentation, 副屏密度: ${metrics.densityDpi}, 分辨率: ${metrics.widthPixels}x${metrics.heightPixels}) // 根据密度加载不同的资源 val resources context.resources val configuration Configuration(resources.configuration) configuration.densityDpi metrics.densityDpi val contextForResources context.createConfigurationContext(configuration) val localInflater LayoutInflater.from(contextForResources) val rootView localInflater.inflate(R.layout.presentation_adaptive_layout, null) setContentView(rootView) }对于布局应尽量使用ConstraintLayout等弹性布局或为不同屏幕尺寸提供不同的布局文件使用swNdp等限定符但注意资源上下文。5.2 使用Presentation实现低延迟渲染对于游戏、视频播放等需要高性能、低延迟渲染到副屏的场景Presentation的默认SurfaceView可能不够。你可以考虑GLSurfaceView in Presentation在Presentation中使用GLSurfaceView进行OpenGL ES渲染可以获得直接控制Surface的能力延迟较低。TextureView如果需要在副屏上显示来自MediaPlayer或Camera的视频流TextureView是更好的选择因为它可以将纹理内容合成到视图层级中。SurfaceControl (API 29)对于需要极致控制的应用如录屏、合成Android 9引入了SurfaceControl和SurfaceView.setChildSurfaceControl允许更精细的Surface层次管理但这属于更底层的API。5.3 电源与性能优化长时间在副屏显示内容会增加功耗。动态刷新率如果副屏支持且你的内容是静态或低帧率的可以尝试通过Window.setFrameRate()API 30来降低刷新率以省电。及时休眠当副屏内容不再需要时例如用户最小化应用应立即dismiss()掉Presentation。监听Activity的onUserLeaveHint()或onTrimMemory()回调在这些时机释放副屏资源。后台限制注意Android对后台应用的限制。如果你的应用退到后台副屏的Presentation可能会被系统强制关闭。确保你的业务逻辑能处理这种中断。6. 测试策略与真机调试双屏开发的测试环境搭建是关键一步。模拟器测试Android Studio模拟器支持创建多显示设备。在AVD Manager中编辑设备添加“Secondary Display”。这是最方便的初步测试方法。开发者选项-模拟辅助显示在部分真机的开发者选项中有“模拟辅助显示”或“Simulate secondary displays”功能可以虚拟出一个副屏非常有用。真机HDMI/Wi-Fi连接通过Type-C转HDMI线缆连接显示器或电视。对于无线显示可以使用Chromecast、Miracast兼容设备或智能电视的投屏功能。注意无线显示的延迟和稳定性可能与有线连接有显著差异必须进行真机测试。ADB调试当应用运行在副屏时adb logcat仍然可以捕获日志。你可以通过adb shell dumpsys window displays和adb shell dumpsys SurfaceFlinger命令来详细查看所有显示设备和Surface的状态这对于诊断黑屏、图层顺序问题至关重要。自动化测试UI自动化测试框架如Espresso、UI Automator可以操作多屏吗目前支持有限。你可能需要编写基于坐标的脚本或者为副屏内容设计独立的可测试组件。我个人在实际开发中会先在模拟器上完成基本逻辑和UI适配然后立刻用一台旧手机连接电视进行真机测试。真机测试阶段最容易暴露Display生命周期管理的问题比如快速插拔HDMI线模拟不稳定的连接环境。同时要准备不同分辨率、比例的显示器进行兼容性测试特别是带鱼屏或超高清屏你的布局是否能正确缩放和显示。最后别忘了在低端设备上测试性能双屏渲染对GPU和内存的压力是单屏的两倍以上需要关注是否有掉帧或内存激增的情况。
Android双屏异显实战：解决Presentation黑屏、崩溃与内存泄漏
发布时间：2026/7/31 3:07:02
1. 项目概述当你的应用在辅助屏上“罢工”最近在做一个需要双屏展示的Android项目遇到了一个挺典型的问题应用在辅助屏上要么黑屏要么直接崩溃控制台抛出的错误信息五花八门核心指向一个点——应用不支持在辅助屏上显示。这可不是简单地在AndroidManifest.xml里加个supportsPictureInPicture就能解决的。双屏异显尤其是利用Activity和Presentation类来实现涉及到Android显示系统、窗口管理、生命周期等一系列复杂机制的协同。很多开发者包括我自己在第一次深入时都容易掉进一些“坑”里比如主副屏生命周期不同步、资源释放不及时导致内存泄漏或者因为对Display对象的理解偏差而无法正确创建展示窗口。这个问题的本质是开发者对Android多屏显示架构的理解不够深入以及Activity与Presentation在异显场景下的特殊交互模式没有处理好。它不仅仅是一个API调用问题更是一个关于如何协调两个独立显示表面、管理两套可能独立的UI组件生命周期的系统工程。适合阅读这篇内容的是那些正在或计划开发需要投屏、演讲辅助、车载双屏、零售双屏展示等功能的Android开发者。无论你是刚刚接触Presentation类还是在双屏开发中遇到了奇怪的兼容性问题希望这篇从实际踩坑中总结的经验能帮你理清思路避开那些我趟过的雷区。2. 核心问题拆解为什么Activity双屏异显会出问题当我们谈论“应用不支持在辅助屏上显示”时通常不是指系统层面禁止而是我们的代码实现没有满足多屏显示的正确条件。Android从4.2API Level 17开始引入了对多显示器的官方支持核心类是Presentation。它本质上是一个特殊的Dialog但其窗口会与一个特定的Display显示设备关联。问题往往出在我们将Activity的逻辑与Presentation的显示生硬结合的过程中。2.1 显示Display对象的获取与有效性第一个拦路虎是如何正确获取并持有代表辅助屏的Display对象。很多初学者的代码是这样的在Activity的onCreate中通过DisplayManager获取显示列表然后假设第二个Display就是外接屏幕随即创建Presentation。这里有几个隐患显示列表动态变化外接屏幕可能随时插拔如HDMI热插拔。你onCreate时获取的Display可能在几秒后就无效了。直接使用一个可能失效的Display对象去创建Presentation是导致“不支持显示”的常见原因之一。Display类型判断错误并非所有Display都适合展示内容。系统内置的虚拟显示、无线显示如Miracast可能有不同的特性。你需要检查Display.FLAG_PRESENTATION标志或者更具体地通过Display.getType()方法判断是否为TYPE_EXTERNAL类型并且其状态STATE_ON。主副屏混淆在有多于两个屏幕的场景例如设备自带屏两个外接显示器你需要有策略地选择哪个是“辅助屏”。简单地取数组第二个元素是不可靠的。注意Display对象只是一个描述符它本身不包含图形缓冲区。创建Presentation时系统会检查这个Display是否仍然有效且具备渲染能力。无效的Display会直接导致Presentation构造失败。2.2 Activity与Presentation的生命周期纠缠这是最核心、也最易出错的部分。Presentation依附于一个Activity作为其上下文但它的显示生命周期与Activity并不同步却又深受其影响。创建时机不当在Activity的onCreate或onResume中立即创建Presentation可能失败因为此时窗口可能还未完全准备好或者Display的详细信息还未完全同步。更稳妥的做法是在onWindowFocusChanged确认获得焦点后或者在接收到DisplayManager的显示变化回调后再尝试创建。销毁时机不当这是内存泄漏的重灾区。常见的错误是在Activity的onPause或onStop中忘记销毁Presentation。虽然Presentation是Dialog的子类但如果你没有显式调用dismiss()它所持有的视图层级、位图等资源不会被释放。更复杂的是当Activity因配置变更如旋转屏幕重建时旧的Activity实例被销毁新实例创建。如果Presentation持有旧Activity上下文的引用例如通过内部类就会导致旧Activity无法被GC回收。上下文Context的误用Presentation需要传入一个上下文通常我们传入宿主Activity。这意味着Presentation内部的视图和资源解析都基于这个Activity的上下文。如果Presentation中使用了Activity特有的资源或主题而该Activity进入后台或销毁就可能引发异常。一种最佳实践是使用Application上下文来创建Presentation内部的视图如LayoutInflater.from(context.applicationContext)但这又可能带来主题应用的问题需要权衡。2.3 窗口类型与标志的冲突Presentation在创建窗口时可以设置一些窗口标志Window Flags。有时这些标志会与系统策略或其他应用冲突导致窗口无法显示。例如如果你为Presentation的窗口设置了FLAG_SECURE防截图在某些要求共享内容的场景如无线投屏到某些电视下系统可能会拒绝显示。再比如没有正确设置FLAG_LOCAL_FOCUS_MODE可能导致输入焦点在双屏间混乱。3. 双屏异显的稳健实现方案基于以上问题我们需要一套更健壮的实现方案。这个方案的核心思想是监听显示变化按需创建/销毁Presentation并严格管理其生命周期使其与宿主Activity解耦。3.1 显示管理器的注册与监听我们不应该在某个时间点静态地获取Display而应该动态监听显示设备的变化。class DualScreenActivity : AppCompatActivity() { private lateinit var displayManager: DisplayManager private var presentation: MyPresentation? null private val displayListener object : DisplayManager.DisplayListener { override fun onDisplayAdded(displayId: Int) { // 有新屏幕接入 updatePresentation(displayId) } override fun onDisplayRemoved(displayId: Int) { // 有屏幕移除 if (presentation?.display?.displayId displayId) { dismissPresentation() } } override fun onDisplayChanged(displayId: Int) { // 屏幕属性改变如分辨率、旋转 if (presentation?.display?.displayId displayId) { // 通常需要重建Presentation以适应新的显示参数 recreatePresentationForDisplay(displayId) } } } override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) displayManager getSystemService(Context.DISPLAY_SERVICE) as DisplayManager } override fun onResume() { super.onResume() // 注册监听器监听所有显示设备的变化 displayManager.registerDisplayListener(displayListener, null) // 检查当前已连接的屏幕并尝试为辅助屏创建Presentation val displays displayManager.displays for (display in displays) { if (display.displayId ! windowManager.defaultDisplay.displayId isValidExternalDisplay(display)) { createPresentationIfNeeded(display) break // 假设只处理第一个有效的外接屏 } } } override fun onPause() { super.onPause() // 可选在Activity不可见时销毁Presentation以节省资源。 // 但需根据业务决定例如演讲时希望副屏在Activity onPause时如接电话保持显示。 // dismissPresentation() displayManager.unregisterDisplayListener(displayListener) } override fun onDestroy() { super.onDestroy() // 最终保障确保资源释放 dismissPresentation() } }关键点在于isValidExternalDisplay(display)函数它需要执行我们之前提到的检查private fun isValidExternalDisplay(display: Display): Boolean { // 检查是否为物理外部显示 if (display.type ! Display.TYPE_EXTERNAL) { return false } // 检查显示是否已开启且就绪 if (display.state ! Display.STATE_ON) { return false } // 可选检查标志确认适合做演示 if (display.flags and Display.FLAG_PRESENTATION 0) { return false } // 检查显示模式是否有效避免一些虚拟或无效显示 val mode display.mode if (mode null || mode.physicalWidth 0 || mode.physicalHeight 0) { return false } return true }3.2 Presentation类的实现与资源管理MyPresentation类的实现需要特别注意上下文和资源。class MyPresentation(context: Context, display: Display) : Presentation(context, display) { init { // 设置窗口标志例如允许触摸、保持屏幕常亮等 window?.apply { addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON) // 谨慎设置FLAG_SECURE // addFlags(WindowManager.LayoutParams.FLAG_SECURE) } } override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) // 关键使用Application Context来Inflate视图避免持有Activity引用 val inflater LayoutInflater.from(context.applicationContext) val rootView inflater.inflate(R.layout.presentation_layout, null) as ViewGroup setContentView(rootView) // 初始化Presentation内的UI组件 val infoTextView rootView.findViewByIdTextView(R.id.tv_info) infoTextView.text 显示在副屏${display.name} // 处理副屏上的用户交互 rootView.findViewByIdButton(R.id.btn_action).setOnClickListener { // 与主Activity通信推荐使用广播、LiveData或接口回调避免直接持有Activity引用 sendActionToMainScreen(click_from_presentation) } } override fun onDisplayChanged(display: Display?) { super.onDisplayChanged(display) // 当关联的Display属性变化时调用可能需要调整UI布局 Log.d(Presentation, Display changed: $display) } override fun onDisplayRemoved() { super.onDisplayRemoved() // 当Display被移除时调用应进行清理 Log.d(Presentation, Display removed) dismiss() // 主动关闭自己 } private fun sendActionToMainScreen(action: String) { // 使用LocalBroadcastManager或EventBus等解耦方式通信 LocalBroadcastManager.getInstance(context.applicationContext) .sendBroadcast(Intent(ACTION_FROM_PRESENTATION).putExtra(data, action)) } }在宿主Activity中创建和销毁Presentationprivate fun createPresentationIfNeeded(display: Display) { if (presentation null || presentation?.display?.displayId ! display.displayId) { dismissPresentation() // 销毁旧的 try { presentation MyPresentation(this, display) // 传入Activity作为Context presentation?.show() } catch (e: WindowManager.InvalidDisplayException) { Log.e(DualScreen, 无法在显示设备上创建Presentation: ${display.name}, e) presentation null } catch (e: Exception) { Log.e(DualScreen, 创建Presentation失败, e) presentation null } } } private fun dismissPresentation() { presentation?.dismiss() presentation null } private fun recreatePresentationForDisplay(displayId: Int) { val display displayManager.getDisplay(displayId) display?.let { if (isValidExternalDisplay(it)) { createPresentationIfNeeded(it) } } }3.3 主副屏间的数据同步与通信双屏异显不仅仅是显示两个画面更需要数据状态同步。绝对要避免在Presentation中直接持有并操作主Activity的UI组件或数据。推荐几种通信方式ViewModel LiveData如果主Activity和Presentation共享同一个ViewModel通过ViewModelProvider传入相同的ViewModelStoreOwner如Activity那么数据变化可以自动同步。但要注意Presentation的生命周期。LocalBroadcastManager / EventBus适用于发送一次性事件或命令解耦效果好。接口回调弱引用如果必须使用回调确保Presentation持有对Activity的弱引用WeakReference防止内存泄漏。共享数据源数据层如Repository独立于UI层主副屏都观察同一个数据源如Room数据库的Flow、Retrofit的响应。4. 深度排查当问题依然出现时即使按照上述方案你可能还是会遇到一些棘手的情况。下面是一个常见问题排查清单。问题现象可能原因排查步骤与解决方案Presentation.show() 抛出WindowManager.InvalidDisplayException1. 传入的Display对象已失效如屏幕已拔出。2. 该Display不支持Presentation如某些虚拟显示。3. 窗口标志冲突。1. 在调用show()前再次检查display.isValid()。2. 检查Display的type和flags确保其FLAG_PRESENTATION。3. 尝试创建一个最简单的Presentation仅空白视图排除布局文件问题。4. 查看adb shell dumpsys window displays确认目标显示的状态和参数。副屏显示黑屏但日志无报错1.Presentation的布局文件加载失败或根视图宽高为0。2. 渲染线程问题如OpenGL上下文错误。3. 副屏的显示模式色彩空间、刷新率不兼容。1. 在Presentation.onCreate中打印布局加载日志检查视图层级。2. 为Presentation的根视图设置一个醒目的背景色如红色以确认是否绘制。3. 检查是否在非UI线程更新了Presentation内的视图。4. 尝试在创建Presentation时通过window?.setBackgroundDrawableResource(Color.RED)设置窗口背景。主屏Activity旋转或重建后副屏内容异常或消失1.Presentation未在Activity销毁前正确释放新Activity实例又创建了新的Presentation导致冲突。2.Presentation持有旧Activity的视图引用导致旧实例泄漏。1. 确保在Activity.onDestroy()中调用dismissPresentation()。2. 在Activity中重写onConfigurationChanged并手动处理Presentation的重建逻辑或在AndroidManifest.xml中为Activity配置configChangesorientation副屏触摸事件无响应1.Presentation的窗口未获得焦点或触摸事件被拦截。2. 布局中的视图设置了clickablefalse或enabledfalse。3. 输入通道可能被其他窗口独占。1. 检查Presentation的窗口是否设置了FLAG_NOT_FOCUSABLE或FLAG_NOT_TOUCHABLE。2. 确保按钮等可交互视图的clickable属性为true。3. 在Presentation的根视图上设置setOnTouchListener打印日志确认是否收到事件。内存泄漏LeakCanary报警1.Presentation内部类如匿名OnClickListener隐式持有外部Activity引用。2. 静态变量或单例持有了Presentation或Activity的引用。3.Handler或Timer任务未及时取消。1. 使用Application上下文创建Presentation内部视图。2. 将内部类改为静态内部类并使用弱引用与Activity通信。3. 在Presentation.dismiss()或onStop()中取消所有异步任务和监听器注册。4. 使用LeakCanary等工具进行精准定位。在特定设备如某些电视、车载系统上不工作1. 设备制造商定制了显示栈管理对Presentation支持不完整。2. 设备需要特定的显示模式或认证。3. 权限问题如SYSTEM_ALERT_WINDOW。1. 查阅设备制造商的开发者文档。2. 尝试使用MediaRouterAPI用于投屏作为备选方案。3. 检查是否需要在清单中声明特殊权限并动态请求。4. 联系设备厂商获取技术支持。5. 高级技巧与性能考量当基础功能稳定后我们可以关注一些提升体验和性能的方面。5.1 适配不同副屏的尺寸与密度外接显示器的尺寸、分辨率和密度可能千差万别。Presentation的上下文会使用其关联Display的指标但这可能和主屏不同。override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) val metrics DisplayMetrics() display.getMetrics(metrics) Log.d(Presentation, 副屏密度: ${metrics.densityDpi}, 分辨率: ${metrics.widthPixels}x${metrics.heightPixels}) // 根据密度加载不同的资源 val resources context.resources val configuration Configuration(resources.configuration) configuration.densityDpi metrics.densityDpi val contextForResources context.createConfigurationContext(configuration) val localInflater LayoutInflater.from(contextForResources) val rootView localInflater.inflate(R.layout.presentation_adaptive_layout, null) setContentView(rootView) }对于布局应尽量使用ConstraintLayout等弹性布局或为不同屏幕尺寸提供不同的布局文件使用swNdp等限定符但注意资源上下文。5.2 使用Presentation实现低延迟渲染对于游戏、视频播放等需要高性能、低延迟渲染到副屏的场景Presentation的默认SurfaceView可能不够。你可以考虑GLSurfaceView in Presentation在Presentation中使用GLSurfaceView进行OpenGL ES渲染可以获得直接控制Surface的能力延迟较低。TextureView如果需要在副屏上显示来自MediaPlayer或Camera的视频流TextureView是更好的选择因为它可以将纹理内容合成到视图层级中。SurfaceControl (API 29)对于需要极致控制的应用如录屏、合成Android 9引入了SurfaceControl和SurfaceView.setChildSurfaceControl允许更精细的Surface层次管理但这属于更底层的API。5.3 电源与性能优化长时间在副屏显示内容会增加功耗。动态刷新率如果副屏支持且你的内容是静态或低帧率的可以尝试通过Window.setFrameRate()API 30来降低刷新率以省电。及时休眠当副屏内容不再需要时例如用户最小化应用应立即dismiss()掉Presentation。监听Activity的onUserLeaveHint()或onTrimMemory()回调在这些时机释放副屏资源。后台限制注意Android对后台应用的限制。如果你的应用退到后台副屏的Presentation可能会被系统强制关闭。确保你的业务逻辑能处理这种中断。6. 测试策略与真机调试双屏开发的测试环境搭建是关键一步。模拟器测试Android Studio模拟器支持创建多显示设备。在AVD Manager中编辑设备添加“Secondary Display”。这是最方便的初步测试方法。开发者选项-模拟辅助显示在部分真机的开发者选项中有“模拟辅助显示”或“Simulate secondary displays”功能可以虚拟出一个副屏非常有用。真机HDMI/Wi-Fi连接通过Type-C转HDMI线缆连接显示器或电视。对于无线显示可以使用Chromecast、Miracast兼容设备或智能电视的投屏功能。注意无线显示的延迟和稳定性可能与有线连接有显著差异必须进行真机测试。ADB调试当应用运行在副屏时adb logcat仍然可以捕获日志。你可以通过adb shell dumpsys window displays和adb shell dumpsys SurfaceFlinger命令来详细查看所有显示设备和Surface的状态这对于诊断黑屏、图层顺序问题至关重要。自动化测试UI自动化测试框架如Espresso、UI Automator可以操作多屏吗目前支持有限。你可能需要编写基于坐标的脚本或者为副屏内容设计独立的可测试组件。我个人在实际开发中会先在模拟器上完成基本逻辑和UI适配然后立刻用一台旧手机连接电视进行真机测试。真机测试阶段最容易暴露Display生命周期管理的问题比如快速插拔HDMI线模拟不稳定的连接环境。同时要准备不同分辨率、比例的显示器进行兼容性测试特别是带鱼屏或超高清屏你的布局是否能正确缩放和显示。最后别忘了在低端设备上测试性能双屏渲染对GPU和内存的压力是单屏的两倍以上需要关注是否有掉帧或内存激增的情况。
)
