AndroidX Media3 屏幕常亮功能实现指南

在视频播放类应用开发中，保持屏幕常亮是一个基础但关键的需求。本文将以AndroidX Media3库为例，详细介绍在View和Compose两种UI模式下实现屏幕常亮的解决方案。

视图(View)模式实现方案

对于传统View体系，开发者可以通过两种方式实现屏幕常亮：

1. XML布局属性
   在播放器容器布局中直接添加android:keepScreenOn属性：

   <FrameLayout
       android:id="@+id/player_container"
       android:layout_width="match_parent"
       android:layout_height="match_parent"
       android:keepScreenOn="true">
   

2. 代码动态设置
   通过WindowManager标志位动态控制：

   window.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)
   // 取消设置
   window.clearFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)
   

Compose模式实现方案

在Jetpack Compose中，可以使用DisposableEffect结合系统服务实现：

@Composable
fun KeepScreenOn() {
    val context = LocalContext.current
    DisposableEffect(Unit) {
        val window = (context as Activity).window
        window.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)
        
        onDispose {
            window.clearFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)
        }
    }
}

最佳实践建议

1. 生命周期管理
   建议在播放开始/暂停时动态控制标志位，避免不必要的电量消耗。

2. 多场景适配
   全屏播放时建议使用Window标志位，小窗播放时建议使用View属性。

3. Compose优化
   可以将屏幕常亮逻辑封装为可重用的Modifier：

   fun Modifier.keepScreenOn(active: Boolean): Modifier = composed {
       // 实现代码
   }
   

注意事项

1. 避免同时使用多种常亮方案，可能引发预期外的行为
2. 后台播放时应及时释放屏幕常亮标志
3. 测试时需验证锁屏超时设置是否受影响

通过合理运用这些技术方案，开发者可以确保视频播放过程中屏幕保持唤醒状态，同时兼顾设备的电量优化。