flutter_video 0.1.14

  • Readme
  • Changelog
  • Example
  • Installing
  • 79

ijkplayer #

pub package

ijkplayer,通过纹理的方式接入 bilibili/ijkplayer

使用前请完整阅读本 README 并参阅 example/lib/main.dart

有关 android 可能跑不起来的问题会详细解释

iOS 模拟器不显示图像,所以调试请使用真机(iOS10 iOS 12.1.4 亲测可用,其他版本有问题可反馈) android 模拟器 mac android sdk 自带的 emulator(API28 android9)可用,其他类型的没有亲测不保证

  • android: 我这里 sdk 自带的模拟器可用(音视频均正常)
  • iOS: 库中包含了真机和模拟器的库文件,但是模拟器有声音,无图像

在正式使用前,可以先 star 一下仓库, download 代码跑一下 example 尝试 (clone 也可以)

English Readme #

https://github.com/CaiJingLong/flutter_ijkplayer/blob/master/README-EN.md

安装 #

pub package

最新版本请查看 pub

pubspec.yaml

dependencies:
  flutter_video: ${lastes_version}

入门示例 #

import 'package:flutter_ijkplayer/flutter_ijkplayer.dart';


class HomePageState extends State<HomePage> {
  IjkMediaController controller = IjkMediaController();

  @override
  void initState() {
    super.initState();
  }

  @override
  void dispose() {
    controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Plugin example app'),
        actions: <Widget>[
          IconButton(
            icon: Icon(Icons.videocam),
            onPressed: _pickVideo,
          ),
        ],
      ),
      body: Container(
        // width: MediaQuery.of(context).size.width,
        // height: 400,
        child: ListView(
          children: <Widget>[
            buildIjkPlayer(),
          ]
        ),
      ),
      floatingActionButton: FloatingActionButton(
        child: Icon(Icons.play_arrow),
        onPressed: () async {
          await controller.setNetworkDataSource(
              'https://www.sample-videos.com/video123/mp4/720/big_buck_bunny_720p_20mb.mp4',
              // 'rtmp://172.16.100.245/live1',
              // 'https://www.sample-videos.com/video123/flv/720/big_buck_bunny_720p_10mb.flv',
//              "https://www.sample-videos.com/video123/mp4/720/big_buck_bunny_720p_1mb.mp4",
              // 'http://184.72.239.149/vod/smil:BigBuckBunny.smil/playlist.m3u8',
              // "file:///sdcard/Download/Sample1.mp4",
              autoPlay: true);
          print("set data source success");
          // controller.playOrPause();
        },
      ),
    );
  }

  Widget buildIjkPlayer() {
    return Container(
      // height: 400, // 这里随意
      child: IjkPlayer(
        mediaController: controller,
      ),
    );
  }
}

使用 #

设置 #


关于销毁 #

用户在确定不再使用 controller 时,必须自己调用 dispose 方法以释放资源,如果不调用,则会造成资源无法释放(后台有音乐等情况),一般情况下,在 ijkplayer 所属的页面销毁时同步销毁

因为一个controller可能被多个IjkPlayer附着, 导致一个controller同时控制多个IjkPlayer,所以原则上不能与IjkPlayerdispose达成一致,所以这里需要调用者自行 dispose,

controller.dispose();

控制器的使用 #

设置资源 #

// 根据你的资源类型设置,设置资源本身是耗时操作,建议await

// 网络
await controller.setNetworkDataSource("https://www.sample-videos.com/video123/mp4/720/big_buck_bunny_720p_20mb.mp4");

// 设置请求头, 使用headers参数
await controller.setNetworkDataSource(url, headers: <String,String>{});

// 应用内资源
await controller.setAssetDataSource("assets/test.mp4");

// 文件
await controller.setFileDataSource(File("/sdcard/1.mp4"));

// 通过数据源的方式
var dataSource = DataSource.file(File("/sdcard/1.mp4"));
var dataSource = DataSource.network("https://www.sample-videos.com/video123/mp4/720/big_buck_bunny_720p_20mb.mp4", headers:<String,String>{});
var dataSource = DataSource.asset("assets/test.mp4");
await controller.setDataSource(dataSource);

// 还可以添加autoplay参数,这样会在资源准备完成后自动播放
await controller.setNetworkDataSource("https://www.sample-videos.com/video123/mp4/720/big_buck_bunny_720p_20mb.mp4",autoPlay : true);

//或者也可以在设置资源完毕后自己调用play
await controller.setNetworkDataSource("https://www.sample-videos.com/video123/mp4/720/big_buck_bunny_720p_20mb.mp4");
await controller.play();

播放器的控制 #

// 播放或暂停
await controller.playOrPause();

// 不管当前状态,直接play
await controller.play();

// 不管当前状态,直接pause
await controller.pause();

// 停止
// 这里要说明,ijkplayer的stop会释放资源,导致play不能使用,需要重新准备资源,所以这里其实采用的是回到进度条开始,并暂停
await controller.stop();

// 进度跳转
await controller.seekTo(0.0); //这里是一个double值, 单位是秒, 如1秒100毫秒=1.1s 1分钟10秒=70.0

// 进度跳转百分比
await controller.seekToProgress(0.0); //0.0~1.0

// 暂停其他所有的播放器(适用于ListView滚出屏幕或界面上有多个播放器的情况)
await controller.pauseOtherController();

// 设置媒体音量,这个可以用于做视频静音而不影响系统音量
controller.volume = 100; //范围0~100

// 设置系统音量
await controller.setSystemVolume(100); // 范围0~100

获取播放信息 #

  // 包含了一些信息,是否在播放,视频宽,高,视频角度,当前播放进度,总长度等信息
  VideoInfo info = await controller.getVideoInfo();

截取视频帧 #

视频帧的截图

Uint8List的格式导出,可以使用Image控件查看

var uint8List = await controller.screenShot();
var provider = MemoryImage(uint8List);
Widget image = Image(image:provider);

但是有 2 个问题:

  1. 这个和显示中的视频不总完全一样, 这个是因为截取的是解码后的完整视频帧, 可能比当前播放的略快 1~2 帧. 如果你不能接受这种不同步,请不要使用这个功能,或提交可行的 PR
  2. 硬解的情况下不支持截图, 因为只有软解码才有视频帧(这个问题我会在后面尝试解决, 但不保证实现时间)

在设置播放资源前设置软解码

资源监听 #

使用 stream 的形式向外广播一些信息的变化,原则上以 stream 结尾的属性都是可监听的

// 当纹理id发生变化时的回调,这个对于用户不敏感
Stream<int> textureIdStream = controller.textureIdStream;

// 播放状态的监听,true为正在播放,false为暂停
Stream<bool> playingStream = controller.playingStream;

// 当有调用controller.refreshVideoInfo()时,这个方法会回调,一般用于controllerUI的自定义,以便于监听当前信息(播放进度,播放状态,宽,高,方向变化等)
Stream<VideoInfo> videoInfoStream = controller.videoInfoStream;

// 音量的变化,这里需要注意,这个变化指的是当前媒体的音量变化,而不是系统的音量变化
Stream<bool> volumeStream = controller.playingStream;

// 当前Controller状态的监听,取值范围可以查看
Stream<IjkStatus> ijkStatusStream = controller.ijkStatusStream;

倍速播放 #

调用代码:

controller.setSpeed(2.0);

支持的倍率默认为 1.0, 上限不明,下限请不要小于等于 0,否则可能会 crash

变调的问题: 由于变速变调的问题, 如果需要不变调, 需要一个 option 的支持, 这个 option 默认开启, 如果要关闭这个, 可以使用如下代码

IjkMediaController(needChangeSpeed: false); // 这个设置为false后, 则变速时会声音会变调的情况发生

IjkStatus 说明 #

名称说明
noDatasource初始状态/调用reset()
preparing设置资源中
setDatasourceFail设置资源失败
prepared准备好播放
pause暂停
error发生错误
playing播放中
complete播放完毕后
disposed调用 dispose 后的状态

自定义 Option #

**本功能可能会出问题,导致不能播放等等情况,**如果发现设置选项后不能使用或出现异常,请停止使用此功能

支持自定义 IJKPlayer 的 option,这个 option 会直接传输至 android/iOS 原生,具体的数值和含义你需要查看bilibili/ijkplayer的设置选项

但这个设置后的选项不是即时生效的 只有在你重新 setDataSource 以后才会生效

设置方法setIjkPlayerOptions

void initIjkController() async {
  var option1 = IjkOption(IjkOptionCategory.format, "fflags", "fastseek");// category, key ,value

  controller.setIjkPlayerOptions(
    [TargetPlatform.iOS, TargetPlatform.android],
    [option1].toSet(),
  );

  await controller.setDataSource(
    DataSource.network(
        "http://img.ksbbs.com/asset/Mon_1703/05cacb4e02f9d9e.mp4"),
    autoPlay: true,
  );
}

第一个参数是一个数组,代表了你 option 目标设备的类型(android/iOS)

第二个参数是一个Set<IjkOption>,代表了 Option 的集合,因为 category 和 key 均相同的情况下会覆盖,所以这里使用了 set

setIjkPlayerOptions对应的,还有一个addIjkPlayerOptions方法,区别在于 set 是会清空以前所有的配置选项, add 是添加, 只覆盖 category 和 key 均相同的配置选项

IjkOptionCategory #

含义请查看 bilibili/ijkplayer 的说明或自行搜索

name
format
codec
sws
player
设置软解码 #

android 软解码的开启方式: 通过设置分类为 player, key 为 mediacodec, 值为 0

mediaController.setIjkPlayerOptions(
  [
    TargetPlatform.android,
  ],
  [
    IjkOption(IjkOptionCategory.player, "mediacodec", 0),
  ],
);

ios 对应的 key 则是 videotoolbox

mediaController.setIjkPlayerOptions(
  [
    TargetPlatform.ios,
  ],
  [
    IjkOption(IjkOptionCategory.player, "videotoolbox", 0),
  ],
);

释放资源 #

await controller.reset(); // 这个方法调用后,会释放所有原生资源,但重新设置dataSource依然可用

await controller.dispose(); //这个方法调用后,当前控制器理论上不再可用,重新设置dataSource无效,且可能会抛出异常,确定销毁这个controller时再调用

自定义控制器 UI #

使用IJKPlayercontrollerWidgetBuilder属性可以自定义控制器的 UI,默认使用defaultBuildIjkControllerWidget方法构建

签名如下: typedef Widget IJKControllerWidgetBuilder(IjkMediaController controller);

返回的 Widget 会被覆盖在 Texture 上

IJKPlayer(
  mediaController: IjkMediaController(),
  controllerWidgetBuilder: (mediaController){
    return Container(); // 自定义
  },
);

内置的播放器 UI 使用的类为: DefaultIJKControllerWidget

这个类提供了一些属性进行自定义, 除controller外所有属性均为可选:

nametypedefaultdesc
doubleTapPlayboolfalse双击播放暂停
verticalGesturebooltrue纵向手势
horizontalGesturebooltrue横向手势
volumeTypeVolumeTypeVolumeType.system纵向手势改变的声音类型(系统,媒体)
playWillPauseOtherbooltrue播放当前是否暂停其他媒体
currentFullScreenStateboolfalse如果你是自定义全屏界面, 这个必须设置为 true
showFullScreenButtonbooltrue是否显示全屏按钮
fullscreenControllerWidgetBuilderIJKControllerWidgetBuilder可以自定义全屏的界面
fullScreenTypeFullScreenType全屏的类型(旋转屏幕,或是使用 RotateBox)

自定义纹理界面 #

使用textureBuilder属性自定义纹理界面,在 0.1.8 和之前的版本该属性名是playerBuilder

默认的方法buildDefaultIjkPlayer接受 context,controller,videoInfo 参数返回 Widget

IJKPlayer(
  mediaController: IjkMediaController(),
  textureBuilder: (context,mediaController,videoInfo){
    return Texture(); // 自定义纹理界面
  },
);

进度 #

IjkMediaController 添加新属性 isNomal //是否是单个视频(用于区分视频与列表默认是true) 主要解决在视频列表中要禁止上下手势滑动 在example的自定义布局中添加新属性:

DefaultIJKControllerWidget //新添加控制器属性 广告用 final String adimageUrl; //广告图片 final String adTitle; //广告标题 final double adrevealTime; //显示时间 final double addisappearTime; //消失时间 final bool isShowAD; //是否显示广告 true //显示 false 隐藏 final bool isShowRatio; //是否显示分辨率的选项 true //显示 false 隐藏 final String videoTitleTxT; //视频标题

0.1.5 新增播放状态loading下面的 播放速度显示 0.1.6 调整视频信息未加载完成的时候 不显示视频的加载速度 以及loading 0.1.7 1.修改控制器UI的样式大小 2.修改滑动事件时候显示的提示框(原在屏幕中间显示,现在显示在视频播放器中间) 3.修改加载卡顿加载时候的loading样式

0.1.9 修改视频加载loading得角度 改成圆角 0.1.10 修复视频暂停状态异常 0.1.11 修复视频初始化加载时候会出现两种加载状态的异常 0.1.14 修改在播放视频过程中,视频停止播放以及视频加载loading异常

LICENSE #

MIT

0.1.14 #

修改在播放视频过程中,视频停止播放以及视频加载loading异常

0.1.13 #

修改播放器控制层与状态层的位置

0.1.12 #

修改播放器控制层与状态层的位置

0.1.11 #

修复视频初始化加载时候会出现两种加载状态的异常

0.1.10 #

修复视频暂停状态异常

0.1.9 #

修改视频加载loading得角度 改成圆角

0.1.7 #

1.修改控制器UI的样式大小 2.修改滑动事件时候显示的提示框(原在屏幕中间显示,现在显示在视频播放器中间) 3.修改加载卡顿加载时候的loading样式

0.1.6 #

调整视频信息未加载完成的时候 不显示视频的加载速度 以及loading

0.1.5 #

新增播放状态loading下面的 播放速度显示

0.1.4 #

IjkMediaController 添加新属性 isNomal //是否是单个视频(用于区分视频与列表默认是true) 主要解决在视频列表中要禁止上下手势滑动 在example的自定义布局中添加新属性:

DefaultIJKControllerWidget //新添加控制器属性 广告用 final String adimageUrl; //广告图片 final String adTitle; //广告标题 final double adrevealTime; //显示时间 final double addisappearTime; //消失时间 final bool isShowAD; //是否显示广告 true //显示 false 隐藏 final bool isShowRatio; //是否显示分辨率的选项 true //显示 false 隐藏 final String videoTitleTxT; //视频标题

0.1.3 #

fix some bug

0.1.2 #

fix some bug

0.0.8 #

fix some bug

0.0.7 #

fix some bug

0.0.6 #

fix some bug

0.0.5 #

fix some bug

0.0.4 #

fix ios fps problem.

0.0.3 #

fix some bug

0.0.2 #

first version

0.0.1 #

Use GSYVideoPlayer android ex so

example/README.md

ijkplayer_example #

Demonstrates how to use the ijkplayer plugin.

Getting Started #

This project is a starting point for a Flutter application.

A few resources to get you started if this is your first Flutter project:

For help getting started with Flutter, view our online documentation, which offers tutorials, samples, guidance on mobile development, and a full API reference.

Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:


dependencies:
  flutter_video: ^0.1.14

2. Install it

You can install packages from the command line:

with Flutter:


$ flutter pub get

Alternatively, your editor might support flutter pub get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:


import 'package:flutter_video/flutter_video.dart';
  
Popularity:
Describes how popular the package is relative to other packages. [more]
59
Health:
Code health derived from static analysis. [more]
100
Maintenance:
Reflects how tidy and up-to-date the package is. [more]
100
Overall:
Weighted score of the above. [more]
79
Learn more about scoring.

We analyzed this package on Nov 20, 2019, and provided a score, details, and suggestions below. Analysis was completed with status completed using:

  • Dart: 2.6.1
  • pana: 0.12.21
  • Flutter: 1.9.1+hotfix.6

Platforms

Detected platforms: Flutter

References Flutter, and has no conflicting libraries.

Health suggestions

Fix lib/src/ijkplayer.dart. (-0.50 points)

Analysis of lib/src/ijkplayer.dart reported 1 hint:

line 11 col 8: Unused import: 'error.dart'.

Format lib/src/controller/plugin.dart.

Run flutter format to format lib/src/controller/plugin.dart.

Format lib/src/entity/video_info.dart.

Run flutter format to format lib/src/entity/video_info.dart.

Fix additional 3 files with analysis or formatting issues.

Additional issues in the following files:

  • lib/src/helper/ui_helper.dart (Run flutter format to format lib/src/helper/ui_helper.dart.)
  • lib/src/widget/controller_widget_builder.dart (Run flutter format to format lib/src/widget/controller_widget_builder.dart.)
  • lib/src/widget/full_screen.part.dart (Run flutter format to format lib/src/widget/full_screen.part.dart.)

Dependencies

Package Constraint Resolved Available
Direct dependencies
Dart SDK >=2.1.0 <3.0.0
flutter 0.0.0
flutter_spinkit ^4.0.0 4.0.0
orientation ^1.1.0 1.1.0
screen ^0.0.5 0.0.5
Transitive dependencies
collection 1.14.11 1.14.12
meta 1.1.7 1.1.8
sky_engine 0.0.99
typed_data 1.1.6
vector_math 2.0.8
Dev dependencies
flutter_test