flutter 视频浏览器手势动作，亮度，音量，快进，后退

参考

简介
最近公司需要开发视频播放的功能，官方提供的video_player除了视频播放功能就没有提供其他的控制功能，包括最基本的全屏播放功能。同时也比较了一下第三方组件也不是很能满足需求。那我们就只好自己动手在video_player基础上进行改造。由于使用的纯flutter进行开发android、ios上界面一致。废话不多说直接上图：

1. 主要功能

轻触屏幕弹出控制按钮（进度条、全屏播放按钮、暂停播放按钮、标题）
右侧滑动控制音量
左侧滑动控制亮度
水平滑动快进快退
双击暂停播放
播放时屏幕常亮

2. 安装组件
video_player: ^0.10.5    
auto_orientation: ^1.0.5   //控制横竖屏控件
screen: ^0.0.5             //控制屏幕亮度以及屏幕常亮组件
common_utils: ^1.1.3       //格式化时间日期组件
复制代码3. 组件结构
为了代码可读性，我将该组件拆分成了3个控件，分别为 控制按钮控件、手势滑动控件、视频播放播放控件。这三个控件依次嵌套默认填充满父控件。由于嵌套层数比较多，层层传递属性有点麻烦，因此我们这里使用一个InheritedWidget共享数据：
import 'package:flutter/material.dart';
import 'package:video_player/video_player.dart';
import 'video_player_control.dart';

class ControllerWidget extends InheritedWidget {
  ControllerWidget({
      this.controlKey,
      this.child,
      this.controller,
      this.videoInit,
      this.title
    });

    final String title;
    final GlobalKey<VideoPlayerControlState> controlKey;
    final Widget child;
    final VideoPlayerController controller;
    final bool videoInit;

  //定义一个便捷方法，方便子树中的widget获取共享数据
  static ControllerWidget of(BuildContext context) {
    return context.dependOnInheritedWidgetOfExactType<ControllerWidget>();
  }

  @override
  bool updateShouldNotify(InheritedWidget oldWidget) {
    // TODO: implement updateShouldNotify
    return false;
  }

}
复制代码这里面VideoPlayerController这个controller我们后面会经常使用，用于调用操作视频相关api。
4. 入口控件VideoPlayerUI
4.1. 定义属性
这里定义了三种读取视频的方式network、asset、file，分别对应网络视频、工程视频、本地视频文件：
class VideoPlayerUI extends StatefulWidget {
  VideoPlayerUI.network({
    Key key,
    @required String url, // 当前需要播放的地址
    this.width: double.infinity, // 播放器尺寸（大于等于视频播放区域）
    this.height: double.infinity,
    this.title = '', // 视频需要显示的标题
  })  : type = VideoPlayerType.network,
        url = url,
        super(key: key);

  VideoPlayerUI.asset({
    Key key,
    @required String dataSource, // 当前需要播放的地址
    this.width: double.infinity, // 播放器尺寸（大于等于视频播放区域）
    this.height: double.infinity,
    this.title = '', // 视频需要显示的标题
  })  : type = VideoPlayerType.asset,
        url = dataSource,
        super(key: key);

  VideoPlayerUI.file({
    Key key,
    @required File file, // 当前需要播放的地址
    this.width: double.infinity, // 播放器尺寸（大于等于视频播放区域）
    this.height: double.infinity,
    this.title = '', // 视频需要显示的标题
  })  : type = VideoPlayerType.file,
        url = file,
        super(key: key);

  final url;
  final VideoPlayerType type;
  final double width;
  final double height;
  final String title;

  @override
  _VideoPlayerUIState createState() => _VideoPlayerUIState();
}
复制代码4.2. 初始化视频
4.2.1. 初始化
首先我们需要在initState生命周期中对视频进行初始化，对视频是否加载成功显示不同的UI界面：加载中、加载成功、加载失败。
  void _urlChange() async {
    if (widget.url == null || widget.url == '') return;
    if (_controller != null) {
      /// 如果控制器存在，清理掉重新创建
      _controller.removeListener(_videoListener);
      _controller.dispose();
    }
    setState(() {
      /// 重置组件参数
      _videoInit = false;
      _videoError = false;
    });
    if (widget.type == VideoPlayerType.file) {
      _controller = VideoPlayerController.file(widget.url);
    } else if (widget.type == VideoPlayerType.asset) {
      _controller = VideoPlayerController.asset(widget.url);
    } else {
      _controller = VideoPlayerController.network(widget.url);
    }

    /// 加载资源完成时，监听播放进度，并且标记_videoInit=true加载完成
    _controller.addListener(_videoListener);
    await _controller.initialize();
    setState(() {
      _videoInit = true;
      _videoError = false;
      _controller.play();
    });
  }
复制代码这里有一个需要注意的点：_controller.addListener(_videoListener);我们添加监听一定要在初始化之前添加，不然后续的加载状态无法响应。在监听函数中我们这里使用了GlobalKey去调用组件方法，刷新子组件时间显示的页面显示
  void _videoListener() async {
    if (_controller.value.hasError) {
      setState(() {
        _videoError = true;
      });
    } else {
      Duration res = await _controller.position;
      if (res >= _controller.value.duration) {
        await _controller.seekTo(Duration(seconds: 0));
        await _controller.pause();
      }
      if (_controller.value.isPlaying && _key.currentState != null) {
        /// 减少build次数
        _key.currentState.setPosition(
          position: res,
          totalDuration: _controller.value.duration,
        );
      }
    }
  }
复制代码4.2.2. 改变视频源
在传入的url发生改变的时候，重新初始化视频，这里我们就需要用到didUpdateWidget这个生命周期：
  @override
  void didUpdateWidget(VideoPlayerUI oldWidget) {
    if (oldWidget.url != widget.url) {
      _urlChange(); // url变化时重新执行一次url加载
    }
    super.didUpdateWidget(oldWidget);
  }
复制代码4.3. 完整代码
VideoPlayerUI完整代码
5. 视频控制按键VideoPlayerControl
5.1 轻触显示界面
该组件主要的功能就是，轻触屏幕会弹出操作按钮，过两秒后按钮会消失，这里我们就需要一个Timer定时器，每次点击屏幕就会取消之前的操作，重新开始计时：
  void _togglePlayControl() {
    setState(() {
      if (_hidePlayControl) {
        /// 如果隐藏则显示
        _hidePlayControl = false;
        _playControlOpacity = 1;
        _startPlayControlTimer(); // 开始计时器，计时后隐藏
      } else {
        /// 如果显示就隐藏
        if (_timer != null) _timer.cancel(); // 有计时器先移除计时器
        _playControlOpacity = 0;
        Future.delayed(Duration(milliseconds: 500)).whenComplete(() {
          _hidePlayControl = true; // 延迟500ms(透明度动画结束)后，隐藏
        });
      }
    });
  }
  
  void _startPlayControlTimer() {
    /// 计时器，用法和前端js的大同小异
    if (_timer != null) _timer.cancel();
    _timer = Timer(Duration(seconds: 3), () {
      /// 延迟3s后隐藏
      setState(() {
        _playControlOpacity = 0;
        Future.delayed(Duration(milliseconds: 500)).whenComplete(() {
          _hidePlayControl = true;
        });
      });
    });
  }
复制代码5.2 全屏播放
当我们点击全屏操作只需要将屏幕强制切换为横屏，同时将系统设置为全屏模式
  void _toggleFullScreen() {
    setState(() {
      if (_isFullScreen) {
        /// 如果是全屏就切换竖屏
        AutoOrientation.portraitAutoMode();

        ///显示状态栏，与底部虚拟操作按钮
        SystemChrome.setEnabledSystemUIOverlays(
            [SystemUiOverlay.top, SystemUiOverlay.bottom]);
      } else {
        AutoOrientation.landscapeAutoMode();

        ///关闭状态栏，与底部虚拟操作按钮
        SystemChrome.setEnabledSystemUIOverlays([]);
      }
      _startPlayControlTimer(); // 操作完控件开始计时隐藏
    });
  }
复制代码5.3 刷新进度条
该方法供视频的监听函数里面进行调用，以让进度条实时更新
  // 供父组件调用刷新页面，减少父组件的build
  void setPosition({position, totalDuration}) {
    setState(() {
      _position = position;
      _totalDuration = totalDuration;
    });
  }
复制代码5.4 完整代码
VideoPlayerControl完整代码
VideoPlayerSlider进度条完整代码
6. 手势控制控件VideoPlayerPan
6.1 手势控制方法
对于手势控制这里其实没什么难度，无非就是通过滑动距离/屏幕宽（高）获取百分比加上当前的值，然后在设置亮度、音量、进度。这里我需要注意一定要给VideoPlayerControl的container设置一个背景透明色，不然该控件无法响应手势（感觉这里写的不够优雅，有什么好的解决办法评论告诉我）：
  @override
  Widget build(BuildContext context) {
    return GestureDetector(
      onDoubleTap: _playOrPause,
      onTap: _togglePlayControl,
      child: Container(
        width: double.infinity,
        height: double.infinity,
        // 这里需要价格透明色，不然无法响应手势，有没有大佬知道更加优雅点的方式
        color: Colors.transparent,
        child: WillPopScope(
          child: Offstage(
            offstage: _hidePlayControl,
            child: AnimatedOpacity(
              // 加入透明度动画
              opacity: _playControlOpacity,
              duration: Duration(milliseconds: 300),
              child: Column(
                children: <Widget>[_top(), _middle(), _bottom(context)],
              ),
            ),
          ),
          onWillPop: _onWillPop,
        ),
      ),
    );
  }
复制代码6.2 完整代码
这个控件就不多讲了，直接上完整代码
完整代码VideoPlayerPan
7. 使用方式
import 'package:flutter/material.dart';
import 'package:richway_flutter_cli/common/video/video_player_UI.dart';

class VideoPage extends StatelessWidget {
  static final String routerName = '/VideoPage';

//  Size get _window => MediaQueryData.fromWindow(window).size;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      backgroundColor: Colors.black,
      body: Center(
        // 该组件宽高默认填充父控件，你也可以自己设置宽高
        child: VideoPlayerUI.network(
          url:
          'https://gss3.baidu.com/6LZ0ej3k1Qd3ote6lo7D0j9wehsv/tieba-smallvideo-transcode-crf/60609889_0b5d29ee8e09fad4cc4f40f314d737ca_0.mp4',
          title: '示例视频',
        ),
      ),
    );
  }
}

作者：一位头发茂盛的程序猿
链接：https://juejin.cn/post/6844904039612678158
来源：稀土掘金
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

我自己的

import 'dart:async';
import 'dart:io';
import 'package:flutter/material.dart';
import 'package:flutter_easyloading/flutter_easyloading.dart';
import 'package:social_im/pages/group/MovieLandScapeLeft.dart';
import 'package:video_player/video_player.dart';
import '../../common/Global.dart';
import '../../router.dart';
import '../../utils/date_util.dart';

class MovieRoom extends StatefulWidget {
  String fileUrl = '';

  MovieRoom(this.fileUrl) {}

  @override
  State<StatefulWidget> createState() => MovieRoomState();
}

class MovieRoomState extends State<MovieRoom> {
  VideoPlayerController? _controller;

  //获取当前视频播放的信息
  late VideoPlayerValue videoPlayerValue;

  //当前播放视频的总时长
  late Duration totalDuration;

  //当前播放视频的位置
  late Duration currentDuration;

  //当前视频是否缓存
  bool isBuffer = false;

  bool isPlay = false;

  bool isPress = false;

  late Timer? isPressTimer;

  String tDuration = "0:00:00";
  String cDuration = "0:00:00";

  late Offset startPosition; // 起始位置
  late double movePan; // 偏移量累计总和
  late double layoutWidth; // 组件宽度
  late double layoutHeight; // 组件高度
  String volumePercentage = ''; // 组件位移描述
  double playDialogOpacity = 0.0;
  bool allowHorizontal = false; // 是否允许快进
  Duration position = Duration(seconds: 0); // 当前时间
  double brightness = 0.0; //亮度
  bool brightnessOk = false; // 是否允许调节亮度

  @override
  void initState() {
    isPressTimer = Timer(const Duration(), () {});
    if (widget.fileUrl.startsWith("http://") ||
        widget.fileUrl.startsWith("https://")) {
      _controller = VideoPlayerController.network(widget.fileUrl)
        ..initialize().then((_) {
          EasyLoading.dismiss();
          _controller!.play();
          mySetState(() {});
        });
    } else if (widget.fileUrl.startsWith('assets/')) {
      _controller = VideoPlayerController.asset(widget.fileUrl)
        ..initialize().then((_) {
          EasyLoading.dismiss();
          _controller!.play();
          mySetState(() {});
        });
    } else {
      _controller = VideoPlayerController.file(File(widget.fileUrl))
        ..initialize().then((_) {
          EasyLoading.dismiss();
          _controller!.play();
          mySetState(() {});
        });
    }
    if (_controller != null) {
      _controller!.removeListener(() {});
      _controller!.addListener(() {
        mySetState(() {
          isPlay = _controller!.value.isPlaying;
          videoPlayerValue = _controller!.value;
          totalDuration = videoPlayerValue.duration;
          currentDuration = videoPlayerValue.position;
          tDuration = totalDuration.toString().substring(0, 7);
          cDuration = currentDuration.toString().substring(0, 7);
          isBuffer = videoPlayerValue.isBuffering;
        });
      });
    }
    super.initState();
  }

  mySetState(callBack) {
    if (mounted) {
      setState(() {
        callBack();
      });
    }
  }

  @override
  void dispose() {
    _controller?.removeListener(() {});
    _controller?.dispose();
    if (isPressTimer != null) {
      isPressTimer?.cancel();
      isPressTimer = null;
    }

    if (EasyLoading.isShow) {
      EasyLoading.dismiss();
    }
    super.dispose();
  }

  void _onVerticalDragStart(details) async {
    _reset(context);
    startPosition = details.globalPosition;
    if (startPosition.dx < (layoutWidth / 2)) {
      /// 左边触摸
      // brightness = await Screen.brightness;
      brightnessOk = true;
    }
  }

  void _onVerticalDragUpdate(details) {
    if (!_controller!.value.isInitialized) {
      return;
    }

    /// 累计计算偏移量(下滑减少百分比，上滑增加百分比)
    movePan += (-details.delta.dy);
    if (startPosition.dx < (layoutWidth / 2)) {
      /// 左边触摸
      if (brightnessOk = true) {
        setState(() {
          volumePercentage = '亮度：${(_setBrightnessValue() * 100).toInt()}%';
          playDialogOpacity = 1.0;
        });
      }
    } else {
      /// 右边触摸
      setState(() {
        volumePercentage = '音量：${(_setVerticalValue(num: 2) * 100).toInt()}%';
        playDialogOpacity = 1.0;
      });
    }
  }

  void _onVerticalDragEnd(_) async {
    if (!_controller!.value.isInitialized) {
      return;
    }
    if (startPosition.dx < (layoutWidth / 2)) {
      if (brightnessOk) {
        print("亮度${_setBrightnessValue()}");
        // await Screen.setBrightness(_setBrightnessValue());
        brightnessOk = false;
        // 左边触摸
        setState(() {
          playDialogOpacity = 0.0;
        });
      }
    } else {
      // 右边触摸
      await _controller!.setVolume(_setVerticalValue());
      setState(() {
        playDialogOpacity = 0.0;
      });
    }
  }

  double _setBrightnessValue() {
    // 亮度百分控制
    double value =
    //toStringAsFixed保留两位小数点
    double.parse((movePan / layoutHeight + brightness).toStringAsFixed(2));
    if (value >= 1.00) {
      value = 1.00;
    } else if (value <= 0.00) {
      value = 0.00;
    }
    return value;
  }

  double _setVerticalValue({int num = 1}) {
    // 声音亮度百分控制
    double value = double.parse(
        (movePan / layoutHeight + _controller!.value.volume)
            .toStringAsFixed(num));
    if (value >= 1.0) {
      value = 1.0;
    } else if (value <= 0.0) {
      value = 0.0;
    }
    print("音量大小${value}");
    return value;
  }

  void _reset(BuildContext context) {
    startPosition = Offset(0, 0);
    movePan = 0;
    layoutHeight = context.size!.height;
    layoutWidth = context.size!.width;
    volumePercentage = '';
  }

  void _onHorizontalDragStart(DragStartDetails details) async {
    _reset(context);
    if (!_controller!.value.isInitialized) {
      return;
    }
    // 获取当前时间
    position = _controller!.value.position;
    // 暂停成功后才允许快进手势
    allowHorizontal = true;
  }

  void _onHorizontalDragUpdate(DragUpdateDetails details) {
    if (!_controller!.value.isInitialized && !allowHorizontal) {
      return;
    }
    // 累计计算偏移量
    movePan += details.delta.dx;
    double value = _setHorizontalValue();
    // 用百分比计算出当前的秒数
    String currentSecond = DateUtil.formatDateMs(
      (value * _controller!.value.duration.inMilliseconds).toInt(),
      format: 'mm:ss',
    );
    if (value >= 0) {
      setState(() {
        volumePercentage = '快进至：$currentSecond';
        playDialogOpacity = 1.0;
      });
    } else {
      setState(() {
        volumePercentage = '快退至：${(value * 100).toInt()}%';
        playDialogOpacity = 1.0;
      });
    }
  }

  void _onHorizontalDragEnd(DragEndDetails details) async {
    if (!_controller!.value.isInitialized && !allowHorizontal) {
      return;
    }
    double value = _setHorizontalValue();
    int current =
    (value * _controller!.value.duration.inMilliseconds).toInt();
    await _controller!.seekTo(Duration(milliseconds: current));
    allowHorizontal = false;
    setState(() {
      playDialogOpacity = 0.0;
    });
  }

  double _setHorizontalValue() {
    // 进度条百分控制
    double valueHorizontal =
    double.parse((movePan / layoutWidth).toStringAsFixed(2));
    // 当前进度条百分比
    double currentValue = position.inMilliseconds /
        _controller!.value.duration.inMilliseconds;
    double value =
    double.parse((currentValue + valueHorizontal).toStringAsFixed(2));
    if (value >= 1.00) {
      value = 1.00;
    } else if (value <= 0.00) {
      value = 0.00;
    }
    return value;
  }

  @override
  Widget build(BuildContext context) {
    return Material(
      child: _controller != null
          ? Container(
              margin: EdgeInsets.only(top: Global.topHeight + 10),
              color: Colors.grey,
              child:
                  Column(mainAxisAlignment: MainAxisAlignment.start, children: [
                if (!_controller!.value.isInitialized)
                  Stack(
                    alignment: Alignment.center,
                    children: [
                      Container(
                        height: 221,
                        width: Global.screenWidth,
                        color: Colors.black,
                      ),
                      const SizedBox(
                        height: 30,
                        width: 30,
                        child: CircularProgressIndicator(
                          backgroundColor: Colors.white,
                        ),
                      ),
                    ],
                  ),
                if (_controller!.value.isInitialized)
                  Stack(
                    alignment: Alignment.center,
                    children: [
                      Stack(
                        alignment: Alignment.bottomCenter,
                        children: [
                          Stack(
                            alignment: Alignment.bottomCenter,
                            children: [
                              GestureDetector(
                                onVerticalDragStart: _onVerticalDragStart,
                                onVerticalDragUpdate: _onVerticalDragUpdate,
                                onVerticalDragEnd: _onVerticalDragEnd,
                                onHorizontalDragStart: _onHorizontalDragStart,
                                onHorizontalDragUpdate: _onHorizontalDragUpdate,
                                onHorizontalDragEnd: _onHorizontalDragEnd,
                                onLongPress: () {
                                  _controller!.setPlaybackSpeed(2);
                                },
                                onLongPressUp: () {
                                  _controller!.setPlaybackSpeed(1);
                                },
                                onDoubleTap: () {
                                  _controller!.value.isPlaying
                                      ? _controller!.pause()
                                      : _controller!.play();
                                },
                                onTap: () {
                                  setState(() {
                                    isPress = !isPress;
                                  });
                                  if (isPressTimer != null) {
                                    isPressTimer?.cancel();
                                    isPressTimer = null;
                                  }
                                  isPressTimer = Timer(
                                      const Duration(milliseconds: 5000), () {
                                    setState(() {
                                      isPress = false;
                                    });
                                  });
                                },
                                child: Container(
                                    color: Colors.black,
                                    alignment: Alignment.topCenter,
                                    child: AspectRatio(
                                        aspectRatio:
                                            _controller!.value.aspectRatio,
                                        child: VideoPlayer(_controller!))),
                              ),
                              if (_controller!.value.isInitialized && isPress)
                                Row(
                                  children: [
                                    GestureDetector(
                                      onTap: () {
                                        _controller!.value.isPlaying
                                            ? _controller!.pause()
                                            : _controller!.play();
                                      },
                                      child: Container(
                                        padding:
                                            const EdgeInsets.only(bottom: 5),
                                        child: Icon(
                                          _controller!.value.isPlaying
                                              ? Icons.pause
                                              : Icons.play_arrow,
                                          color: Colors.white,
                                          size: 30,
                                        ),
                                      ),
                                    ),
                                    Expanded(
                                        child: Container(
                                      padding: const EdgeInsets.only(bottom: 5),
                                      child: VideoProgressIndicator(
                                        _controller!,
                                        allowScrubbing: true,
                                        colors: const VideoProgressColors(
                                            backgroundColor: Colors.white24,
                                            bufferedColor: Colors.white,
                                            playedColor: Colors.pinkAccent),
                                      ),
                                    )),
                                    Container(
                                      margin: const EdgeInsets.only(left: 5),
                                      child: Text(
                                        "$cDuration/$tDuration",
                                        style: const TextStyle(
                                            color: Colors.white, fontSize: 9),
                                      ),
                                    ),
                                    GestureDetector(
                                      onTap: () {
                                        MyRouter.pushMy(
                                            context,
                                            MovieBigLandScape(
                                                videoController: _controller!));
                                      },
                                      child: Container(
                                        padding:
                                            const EdgeInsets.only(bottom: 5),
                                        child: const Icon(
                                          Icons.play_arrow,
                                          color: Colors.white,
                                          size: 30,
                                        ),
                                      ),
                                    ),
                                  ],
                                ),
                            ],
                          ),
                          if (!isPress)
                            VideoProgressIndicator(
                              _controller!,
                              allowScrubbing: true,
                              colors: const VideoProgressColors(
                                  backgroundColor: Colors.white24,
                                  bufferedColor: Colors.white,
                                  playedColor: Colors.pinkAccent),
                            )
                        ],
                      ),
                      if (isBuffer)
                        const SizedBox(
                          height: 30,
                          width: 30,
                          child: CircularProgressIndicator(
                            backgroundColor: Colors.white,
                          ),
                        )
                    ],
                  ),
              ]),
            )
          : Container(),
    );
  }
}