Flutter 强制横屏

在 Flutter 中，可以通过设置 SystemChrome 来强制应用横屏显示。以下是实现这一功能的详细步骤和代码示例：

---

步骤 1：导入必要的包

确保在文件顶部导入了 services.dart 包，因为 SystemChrome 类位于该包中。

import 'package:flutter/services.dart';

---

步骤 2：设置屏幕方向

使用 SystemChrome.setPreferredOrientations 方法来指定设备的方向。例如，强制横屏可以设置为以下两种模式之一：

• DeviceOrientation.landscapeLeft（主横屏方向）
• DeviceOrientation.landscapeRight（副横屏方向）

如果你想同时支持这两种横屏方向，可以将它们都加入到列表中。

---

步骤 3：在 Widget 生命周期中设置方向

通常会在 initState 方法中设置屏幕方向，以确保在页面加载时立即生效。如果你希望在页面销毁时恢复默认方向，可以在 dispose 方法中重置方向。

---

完整代码示例

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';void main() {runApp(const MyApp());
}class MyApp extends StatelessWidget {const MyApp({Key? key}) : super(key: key);@overrideWidget build(BuildContext context) {return MaterialApp(home: const HomeScreen(),debugShowCheckedModeBanner: false,);}
}class HomeScreen extends StatefulWidget {const HomeScreen({Key? key}) : super(key: key);@override_HomeScreenState createState() => _HomeScreenState();
}class _HomeScreenState extends State<HomeScreen> {@overridevoid initState() {super.initState();// 强制横屏SystemChrome.setPreferredOrientations([DeviceOrientation.landscapeLeft, // 主横屏DeviceOrientation.landscapeRight, // 副横屏]);}@overridevoid dispose() {// 恢复默认方向（可选）SystemChrome.setPreferredOrientations([DeviceOrientation.portraitUp,DeviceOrientation.portraitDown,DeviceOrientation.landscapeLeft,DeviceOrientation.landscapeRight,]);super.dispose();}@overrideWidget build(BuildContext context) {return Scaffold(appBar: AppBar(title: const Text("强制横屏示例"),),body: Center(child: Column(mainAxisAlignment: MainAxisAlignment.center,children: const [Text("当前页面已强制横屏显示",style: TextStyle(fontSize: 24),),],),),);}
}

---

关键点解析

1. SystemChrome.setPreferredOrientations 的作用
   这个方法用于限制应用支持的屏幕方向。传入一个 List<DeviceOrientation>，指定允许的方向。如果只传入横屏方向，则应用会强制横屏。

2. 何时调用

   • 在 initState 中调用可以确保页面加载时立即生效。
   • 如果需要在页面关闭时恢复默认方向，可以在 dispose 中重置。

3. 注意事项

   • 如果你的应用有多个页面，并且每个页面的方向需求不同，建议在每个页面的 initState 和 dispose 中单独管理方向。
   • 某些设备可能对屏幕方向切换有限制，测试时请确保在真实设备上验证。

---

扩展：全局设置横屏

如果你希望整个应用都强制横屏，可以直接在 main 函数中设置方向，而不需要在每个页面中重复配置。

void main() {// 全局设置横屏WidgetsFlutterBinding.ensureInitialized();SystemChrome.setPreferredOrientations([DeviceOrientation.landscapeLeft,DeviceOrientation.landscapeRight,]).then((_) {runApp(const MyApp());});
}

这种方式适用于整个应用都需要横屏的场景。

---

通过以上方法，你可以轻松地在 Flutter 应用中实现强制横屏的功能。