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);

  @override
  Widget 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> {
  @override
  void initState() {
    super.initState();
    // 强制横屏
    SystemChrome.setPreferredOrientations([
      DeviceOrientation.landscapeLeft, // 主横屏
      DeviceOrientation.landscapeRight, // 副横屏
    ]);
  }

  @override
  void dispose() {
    // 恢复默认方向（可选）
    SystemChrome.setPreferredOrientations([
      DeviceOrientation.portraitUp,
      DeviceOrientation.portraitDown,
      DeviceOrientation.landscapeLeft,
      DeviceOrientation.landscapeRight,
    ]);
    super.dispose();
  }

  @override
  Widget 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 应用中实现强制横屏的功能。