如何在Jetpack Compose中为部分页面强制设置屏幕方向

完全可以在Composable层级单独配置屏幕方向，无需在Manifest中固定Activity方向，也不会影响其他页面的方向设置，实现方式如下：

核心实现逻辑 #

利用Composable的生命周期绑定动态修改Activity的方向参数，进入目标页面时设置指定方向，退出页面时恢复原有方向配置：

1. 通过LocalContext获取当前承载Composable的Activity实例
2. 用DisposableEffect监听页面的挂载和销毁回调
3. 挂载时修改Activity.requestedOrientation为目标方向，同时保存修改前的原有方向
4. 销毁回调中恢复Activity的原有方向配置

代码示例 #

基础实现（直接在目标页面使用） #

import android.app.Activity
import android.content.pm.ActivityInfo
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.material3.Text
import androidx.compose.runtime.DisposableEffect
import androidx.compose.ui.Modifier
import androidx.compose.ui.platform.LocalContext

@Composable
fun VideoPlayPage() {
    val context = LocalContext.current
    DisposableEffect(Unit) {
        val activity = context as? Activity ?: return@DisposableEffect onDispose { }
        // 保存进入页面前的原始方向配置
        val originalOrientation = activity.requestedOrientation
        // 设置强制横屏，可根据需求替换为其他方向常量
        activity.requestedOrientation = ActivityInfo.SCREEN_ORIENTATION_SENSOR_LANDSCAPE

        onDispose {
            // 页面退出时恢复原始方向
            activity.requestedOrientation = originalOrientation
        }
    }

    // 页面其余布局代码
    Box(modifier = Modifier.fillMaxSize()) {
        Text("视频播放页面（强制横屏）")
    }
}

封装为可复用工具 #

可以把方向锁定逻辑封装为通用Composable函数，所有页面需要时直接调用即可：

import android.app.Activity
import android.content.pm.ActivityInfo
import androidx.compose.runtime.Composable
import androidx.compose.runtime.DisposableEffect
import androidx.compose.ui.platform.LocalContext

@Composable
fun LockScreenOrientation(orientation: Int) {
    val context = LocalContext.current
    DisposableEffect(orientation) {
        val activity = context as? Activity ?: return@DisposableEffect onDispose { }
        val originalOrientation = activity.requestedOrientation
        activity.requestedOrientation = orientation
        onDispose {
            activity.requestedOrientation = originalOrientation
        }
    }
}

使用时只需在目标页面加入一行代码即可：

@Composable
fun VideoPlayPage() {
    // 直接调用工具函数设置横屏
    LockScreenOrientation(ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE)

    // 其余页面布局代码
}

常用方向常量说明 #

• ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE：固定横屏，忽略传感器旋转
• ActivityInfo.SCREEN_ORIENTATION_SENSOR_LANDSCAPE：传感器控制横屏，支持左右两个横屏方向旋转
• ActivityInfo.SCREEN_ORIENTATION_PORTRAIT：固定竖屏
• ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED：恢复系统默认方向，跟随系统全局设置

注意事项 #

• 不要在Manifest中给承载的Activity设置固定的android:screenOrientation属性，否则会覆盖代码中的动态配置
• 适配多窗口、折叠屏、平板设备时，可根据实际窗口大小动态调整方向配置，避免强制方向在小窗模式下出现布局异常
• 该方案和Navigation组件完全兼容，DisposableEffect的生命周期会和Navigation的页面生命周期自动绑定，页面切换时会自动触发配置修改和恢复

内容的提问来源于stack exchange，提问作者rysv