在 Android 开发中，我们经常需要控制 Activity 的屏幕方向，例如视频播放、游戏、VR/AR 应用等场景通常希望默认横屏显示。本文将讲解如何通过 Manifest 配置 和 Java/Kotlin 代码 设置横屏显示，并分析常见设置无效的原因与解决方法。

---

一、通过 Manifest 设置横屏

在 AndroidManifest.xml 中的 <activity> 标签中添加如下属性：

<activityandroid:name=".MyActivity"android:screenOrientation="landscape" />

各种取值说明：

属性值	说明
landscape	强制横屏（默认方向）
portrait	强制竖屏
sensorLandscape	根据传感器横屏（不自动竖屏）
reverseLandscape	反向横屏（180°）
userLandscape	用户偏好的横屏方向

---

二、通过代码动态设置横屏

在 Activity 的 onCreate() 方法中调用：

setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE);

⚠️ 建议在 setContentView() 之前 调用，防止部分设备不生效或出现 UI 闪烁。

Kotlin 示例：

override fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)requestedOrientation = ActivityInfo.SCREEN_ORIENTATION_LANDSCAPEsetContentView(R.layout.activity_main)
}

---

三、Manifest 设置无效的常见原因及解决方案

有时即使你设置了 android:screenOrientation="landscape"，Activity 仍然是竖屏。以下是常见原因和解决方法：

1. 使用了“透明”或“Dialog”主题

这些主题会导致方向设置失效。

✅ 解决：

使用标准全屏主题，如：

android:theme="@style/Theme.AppCompat.Light.NoActionBar"

---

2. launchMode 设置为 singleTask / singleInstance

某些 launchMode 会干扰屏幕方向设置。

✅ 解决：

使用默认的 standard 或 singleTop。

---

3. 代码中设置方向冲突

如果你在代码中设置了 setRequestedOrientation(SCREEN_ORIENTATION_PORTRAIT)，会覆盖 Manifest 中的横屏配置。

---

4. 多窗口模式（Multi-Window）

Android Nougat 以上支持分屏/多窗口模式，该模式下方向可能被限制。

✅ 解决：

禁用多窗口模式：

android:resizeableActivity="false"

---

5. Android 12 及以上未正确配置 android:exported

虽然不直接影响横屏，但错误的导出配置会导致 Activity 无法正常启动，表现为横屏设置不生效。

---

6. 特殊设备限制（如部分 VR 眼镜或手持终端）

某些定制系统会锁定竖屏显示，比如部分国产 UI、TV 系统或 VR 设备。

---

四、调试建议

1. 确保设备处于全屏模式，不是悬浮窗或分屏状态；
2. 重启应用：Manifest 设置修改后必须重新安装或清除缓存才生效；
3. 日志查看：可打印方向信息进行调试：

int orientation = getResources().getConfiguration().orientation;
Log.d("Orientation", "当前方向：" + orientation);

---

五、总结

设置方式	场景	优先级
Manifest 设置	默认方向	中
Java/Kotlin 代码设置	运行时动态切换	高
设备或系统限制	特殊场景（如眼镜）	最高

掌握正确的设置方式并排查常见陷阱，能有效避免“明明配置了横屏却不生效”的困扰。建议在横屏依赖较强的业务场景中，采用代码和 Manifest 双重设置保障兼容性。

---

🔚 最后

如果你正在开发视频播放器、VR/AR 应用、或有多端设备适配需求，欢迎留言交流屏幕方向适配经验，也可以关注我获取更多 Android 和 XR 技术分享。

---

新开专栏《VR 360°全景视频开发》，持续更新中，敬请关注！

【专栏预告】《VR 360°全景视频开发：从GoPro到Unity VR眼镜应用实战》

《VR 360°全景视频开发》将带你深入探索从GoPro拍摄到Unity眼镜端应用开发的全流程技术。专栏内容涵盖安卓原生VR播放器开发、Unity VR视频渲染与手势交互、360°全景视频制作与优化，以及高分辨率视频性能优化等实战技巧。

---