Android TV应用竖屏模式失效：如何绕过系统横屏锁定？

1. 排查系统全局限制 #

部分新版Android TV系统会默认强制所有应用保持横屏，先检查设备系统设置里的显示方向锁定选项，关闭后重新测试应用。

2. 调整Manifest配置 #

在对应Activity的标签中，除了设置竖屏属性，额外添加resizeableActivity，部分系统需要该属性允许方向切换：

<activity
    android:name=".YourTargetActivity"
    android:screenOrientation="portrait"
    android:resizeableActivity="true">
</activity>

3. 用WindowManager强制修改窗口方向 #

绕过Activity的方向设置，直接通过窗口属性强制旋转：

WindowManager.LayoutParams windowParams = getWindow().getAttributes();
windowParams.screenOrientation = ActivityInfo.SCREEN_ORIENTATION_PORTRAIT;
getWindow().setAttributes(windowParams);

需在onCreate或onResume中调用，同时在Manifest中添加权限：

<uses-permission android:name="android.permission.CHANGE_CONFIGURATION" />

4. Android 12+适配处理 #

Android 12及以上对TV应用的方向限制更严格，添加configChanges避免系统重置方向：

<activity
    android:name=".YourTargetActivity"
    android:screenOrientation="portrait"
    android:configChanges="orientation|screenSize|smallestScreenSize">
</activity>

并在Activity中重写方法手动维持方向：

@Override
public void onConfigurationChanged(Configuration newConfig) {
    super.onConfigurationChanged(newConfig);
    setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT);
}

5. 验证厂商定制限制 #

部分TV厂商会在系统层面做特殊的方向锁定逻辑，可在不同品牌设备上测试。若为特定厂商问题，需联系厂商获取适配方案。

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