Flutter方向限制插件limiting_direction_csx的使用

iOS项目横屏使用配置

一. 调整主项目的info.plist文件添加

<key>UIRequiresFullScreen</key>
<true/>

(即Xcode打开iOS项目，勾选中Targets->General->Deployment Info->Requires full screen(前面选中打勾☑️)) (这个配置主要针对pad的适配，需要添加，单纯的手机应用开发，这个配置可以不用勾选就可以实现其效果)

二 两种方式使用方式不一样，请对号入座！

1. 纯flutter项目： 主项目的Main.storyboard的控制器类型class从FlutterViewController调整为MainViewController

2. module形式接入主项目: 原生在跳转flutter页面的地方将承载flutter的FlutterViewController替换成MainViewController,并注册当前flutter的桥接到原生项目中

详细介绍module的使用为什么这样，看一查看我的博客：原生混合开发flutter Unhandled Exception…

使用代码介绍

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  if (Platform.isIOS) {
    // 设置启动即强制横屏
    await LimitingDirectionCsx.setScreenDirection(DeviceDirectionMask.Landscape);
  } else {
    await SystemChrome.setPreferredOrientations(
      [DeviceOrientation.landscapeLeft, DeviceOrientation.landscapeRight]);
  }
  runApp(MyApp());
}

// 或者在需要的地方调用
if (Platform.isIOS) {
  await LimitingDirectionCsx.setScreenDirection(DeviceDirectionMask.Landscape);
}
// 来设置枚举类型，选择自己想要的可支持方位

设备陀螺仪读取（这个无需配置）

// 直接读取当前陀螺仪方位（直接读取不建议使用在项目刚启动的地方）：
LimitingDirectionCsx().currentDeviceOrientation

// 流的方式监听陀螺仪：LimitingDirectionCsx().getDeviceDirectionStream()
StreamBuilder<UIDeviceOrientation>(
  stream: LimitingDirectionCsx().getDeviceDirectionStream(),
  builder: (context, AsyncSnapshot snapshot) {
    return Text('结果：${snapshot.data}');
  },
)

// future的方式主动一次性获取陀螺仪转向
LimitingDirectionCsx().getNowDeviceDirection();

完整示例Demo

以下是完整的示例代码：

/*
 * [@Author](/user/Author): Cao Shixin
 * [@Date](/user/Date): 2020-12-28 15:12:15
 * [@LastEditors](/user/LastEditors): Cao Shixin
 * [@LastEditTime](/user/LastEditTime): 2021-01-14 13:44:10
 * [@Description](/user/Description): 
 */
import 'dart:io';

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:limiting_direction_csx/limiting_direction_csx.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  if (Platform.isIOS) {
    await LimitingDirectionCsx.setScreenDirection(DeviceDirectionMask.Landscape);
  } else {
    await SystemChrome.setPreferredOrientations(
        [DeviceOrientation.landscapeLeft, DeviceOrientation.landscapeRight]);
  }
  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    print('>>${LimitingDirectionCsx().currentDeviceOrientation}');
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Plugin example app'),
        ),
        body: StreamBuilder<UIDeviceOrientation>(
          stream: LimitingDirectionCsx().getDeviceDirectionStream(),
          builder: (context, AsyncSnapshot snapshot) {
            return Text('结果：${snapshot.data}');
          },
        ),
      ),
    );
  }
}