Android横竖屏布局切换：特定ViewHolder时允许横屏的实现方案咨询

我经常遇到类似的需求，这种场景下用两套独立布局绝对是最优解——既让横竖屏UI逻辑完全解耦，又能大幅降低维护成本。下面一步步拆解实现思路：

一、布局文件的基础配置 #

• 竖屏布局：放在res/layout/目录下，命名比如fragment_content.xml，里面包含你的RecyclerView及所有竖屏需要的元素。
• 横屏布局：放在res/layout-land/目录下，用同一个文件名fragment_content.xml，里面只放SimpleExoPlayer的视图（比如com.google.android.exoplayer2.ui.StyledPlayerView）。

系统默认会根据屏幕方向自动加载对应布局，但我们要通过逻辑控制方向切换的权限，所以后续要接管方向锁定逻辑。

二、屏幕方向的动态控制逻辑 #

1. 默认锁定竖屏 #

在Fragment的onViewCreated方法里，一开始就锁定竖屏，确保用户打开页面时默认是竖屏状态：

@Override
public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
    super.onViewCreated(view, savedInstanceState);
    // 默认锁定竖屏
    requireActivity().setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT);
    // 初始化RecyclerView、适配器等逻辑...
}

2. 监听RecyclerView的可见ViewHolder #

你需要监听RecyclerView的滚动事件，判断当前屏幕上是否显示了目标类型的ViewHolder（比如视频类的VideoViewHolder）：

recyclerView.addOnScrollListener(new RecyclerView.OnScrollListener() {
    @Override
    public void onScrolled(@NonNull RecyclerView recyclerView, int dx, int dy) {
        super.onScrolled(recyclerView, dx, dy);
        LinearLayoutManager layoutManager = (LinearLayoutManager) recyclerView.getLayoutManager();
        if (layoutManager == null) return;

        // 获取可见区域的首尾item位置
        int firstVisiblePos = layoutManager.findFirstVisibleItemPosition();
        int lastVisiblePos = layoutManager.findLastVisibleItemPosition();

        boolean hasTargetViewHolder = false;
        // 遍历可见区域的ViewHolder，判断是否存在目标类型
        for (int i = firstVisiblePos; i <= lastVisiblePos; i++) {
            RecyclerView.ViewHolder holder = recyclerView.findViewHolderForAdapterPosition(i);
            if (holder instanceof VideoViewHolder) { // 替换成你的目标ViewHolder类型
                hasTargetViewHolder = true;
                break;
            }
        }

        // 根据检测结果动态切换方向权限
        if (hasTargetViewHolder) {
            // 允许横竖屏自动切换（传感器检测方向）
            requireActivity().setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_SENSOR);
        } else {
            // 重新锁定竖屏
            requireActivity().setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT);
        }
    }
});

如果你用的是GridLayoutManager，只需要调整获取可见item的逻辑，核心是遍历当前可见的ViewHolder判断类型。

3. 页面销毁时还原方向设置 #

在Fragment的onDestroyView里，记得把屏幕方向权限还原为系统默认，避免影响其他页面：

@Override
public void onDestroyView() {
    super.onDestroyView();
    // 还原为系统默认的方向设置（自动检测方向）
    requireActivity().setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED);
}

三、布局切换时的状态保存与恢复 #

横竖屏切换会触发Fragment的重建（除非你给Activity添加特殊配置），所以要处理关键状态的保存：

方案1：用ViewModel保存跨配置状态（推荐） #

用ViewModel持有不受配置变化影响的状态，比如：

• RecyclerView的滚动位置
• ExoPlayer的播放进度、播放状态
• 当前是否显示目标ViewHolder的标记

示例：

public class ContentViewModel extends ViewModel {
    private final MutableLiveData<Integer> recyclerScrollPos = new MutableLiveData<>(0);
    private final MutableLiveData<Long> playerPosition = new MutableLiveData<>(0L);
    // 其他需要保存的状态...

    // 提供getter和setter方法
    public MutableLiveData<Integer> getRecyclerScrollPos() {
        return recyclerScrollPos;
    }
}

在Fragment里获取ViewModel，在滚动或播放状态变化时更新数据，Fragment重建时直接读取恢复状态。

方案2：添加configChanges跳过重建 #

如果不想处理Fragment重建，可以在AndroidManifest.xml的对应Activity里添加：

<activity
    android:name=".YourActivity"
    android:configChanges="orientation|screenSize">
</activity>

然后在Activity的onConfigurationChanged方法里通知Fragment更新布局逻辑：

@Override
public void onConfigurationChanged(@NonNull Configuration newConfig) {
    super.onConfigurationChanged(newConfig);
    ContentFragment fragment = (ContentFragment) getSupportFragmentManager().findFragmentById(R.id.fragment_container);
    if (fragment != null) {
        fragment.onConfigurationChanged(newConfig);
    }
}

注意：这种方式需要自己处理所有配置变化的适配（比如字体、资源加载等），适合布局逻辑简单的场景。

四、细节优化 #

• 避免频繁切换方向：给滚动监听加个延迟判断，比如用Handler.postDelayed，确保目标ViewHolder可见超过300-500ms再解锁方向，防止快速滚动时频繁触发。
• 横屏自动切回逻辑：如果用户在横屏时滚动离开目标ViewHolder，可以强制切回竖屏，或者保留横屏让用户手动切换，根据产品需求决定。
• ExoPlayer生命周期管理：横屏时创建的Player要在转竖屏时释放，竖屏转横屏时重新初始化，或者用ViewModel持有Player实例，避免重复创建和资源浪费。

内容的提问来源于stack exchange，提问作者Joel Robinson-Johnson