备案控制台
文档
产品文档
输入文档关键字查找
首页 音视频终端 SDK 开发参考 单模块集成 播放器SDK Flutter框架 进阶功能

进阶功能

更新时间：
一键部署
产品详情
我的收藏

本文提供Flutter框架播放器SDK进阶功能的使用示例，完整功能说明请参见API说明。

播放

短视频列表播放

  1. 创建列表播放器。

    FlutterAliListPlayer fAliListPlayer = FlutterAliPlayerFactory.createAliListPlayer();

  2. 添加资源、移除资源。

    列表播放器目前只支持两种播放方式：UrlSource播放和VidSts播放。

    //uid是视频的唯一标志。用于区分视频是否一样。如果uid一样，则认为是一样的
fAliListPlayer.addUrlSource(url,uid);
fAliListPlayer.addVidSource(vid,uid);
fAliListPlayer.removeSource(uid);

  3. 设置预加载个数。

    合理设置预加载个数，能够有效的提高起播的速度。示例如下：

    //设置预加载个数。总共加载的个数为： 1 + count*2。
fAliListPlayer.setPreloadCount(count);

  4. 播放视频源。

    //uid为必填项，如果是URL播放方式，只需要uid即可，如果是STS方式，则需要填写STS信息
fAliListPlayer.moveTo();

软硬解切换

Flutter框架播放器SDK提供了H.264、H.265的硬解码能力，同时提供了setEnableHardwareDecoder开关。默认开，并且在硬解初始化失败时，自动切换为软解，保证视频的正常播放。示例如下：

//开启硬解，默认开启
fAliplayer.setEnableHardwareDecoder(enable);

网络自适应切换视频清晰度

Flutter框架播放器SDK支持多码率自适应HLS、DASH视频流。在prepare成功之后，通过getMediaInfo可以获取到各个码流的信息，即TrackInfo。示例如下：

fAliplayer.getMediaInfo().then((value) {
//value为map，value['tracks']可以获取对应的TrackInfos 列表信息，可以参考Demo中AVPMediaInfo info = AVPMediaInfo.fromJson(value); 了解如何解析TrackInfo

});

在播放过程中，可以通过调用播放器的selectTrack方法切换播放的码流，参数为TrackInfo中的trackIndex，切换的结果会在OnTrackChangedListener监听之后会回调。

//多码率切换
fAliplayer.selectTrack(index);
//多码率切换并自适应
fAliplayer.selectTrack(-1);

截图

Flutter框架播放器SDK提供了对当前视频截图的功能，由setOnSnapShot接口实现。

//截图成功监听
fAliplayer.setOnSnapShot((path,playerId) {

});
//截图，path为图片保存路径
fAliplayer.snapshot(path);

试看

Flutter框架播放器SDK通过配合点播服务配置，可以实现试看功能，VidAuth播放（推荐）和VidSts播放方式支持试看功能。如何配置和使用试看功能，请参见点播试看。

配置试看功能之后，通过setVidAuth接口的previewTime方法设置播放器的试看时长。示例如下：

//previewTime为试看时间，单位：秒
//VidAuth播放方式
fAliplayer.setVidAuth(
 vid: "填写资源的vid",
 region: "填写资源的region",
 playAuth: "填写资源的region",
 previewTime: "填写试看时间，单位：秒");

 //VidSts播放方式
 fAliplayer.setVidSts(
 vid: "填写资源的vid",
 region: "填写资源的region",
 accessKeyId: "填写资源的鉴权id",
 accessKeySecret: "填写资源的鉴权密钥",
 securityToken: "填写资源的安全Token",
 previewTime: "填写试看时间，单位：秒");

其他配置

Flutter框架播放器SDK的其他播放配置。需要在prepare()方法之前设置给播放器。

var configMap = {
 'mStartBufferDuration':_mStartBufferDurationController.text,//起播缓冲区时长，单位：毫秒
 'mHighBufferDuration':_mHighBufferDurationController.text,//高缓冲时长，单位：毫秒
 'mMaxBufferDuration':_mMaxBufferDurationController.text,//最大缓冲区时长，单位：毫秒
 'mMaxDelayTime': _mMaxDelayTimeController.text,//直播最大延迟，单位：毫秒。注意：仅直播有效
 'mNetworkTimeout': _mNetworkTimeoutController.text,//网络超时时间，单位：毫秒
 'mNetworkRetryCount':_mNetworkRetryCountController.text,///网络超时重试次数，单位：毫秒
 'mMaxProbeSize': _mMaxProbeSizeController.text,//最大probe大小
 'mReferrer': _mReferrerController.text,//设置referrer
 'mHttpProxy': _mHttpProxyController.text,//http代理
 'mEnableSEI': mEnableSEI,//是否启用SEI
 'mClearFrameWhenStop': !mShowFrameWhenStop,///停止后是否清空画面
 'mDisableVideo': mDisableVideo,//禁用Video
 'mDisableAudio': mDisableAudio,//禁用Audio
 'mUserAgent':mUserAgent,//设置UserAgent
};
//应用配置
fAliplayer.setConfig(configMap);

性能

本地缓存

Flutter框架播放器SDK提供了本地缓存（边播边缓存）的功能，能够让用户重复播放视频时，达到省流量的目的。需要在prepare之前给播放器配置setCacheConfig即可实现此功能。示例如下：

var map = {
 "mMaxSizeMB": _mMaxSizeMBController.text,///缓存目录的最大占用空间
 "mMaxDurationS": _mMaxDurationSController.text,///设置能够缓存的单个文件的最大时长
 "mDir": _mDirController.text,///缓存目录
 "mEnable": mEnableCacheConfig,///是否开启缓存功能
};
fAliplayer.setCacheConfig(map);

视频下载

Flutter框架播放器SDK提供了点播服务视频的下载功能，允许用户通过阿里云播放器将视频缓存至本地观看。同时，提供了普通下载和安全下载两种下载方式。

  • 普通下载

    下载后的视频数据未经过阿里云加密，用户可以用第三方播放器播放。

  • 安全下载

    下载后的视频数据经过阿里云加密。第三方播放器无法播放，仅支持使用阿里云的播放器SDK进行播放。

使用说明

  • 仅VidSts和VidAuth方式支持视频下载功能。

  • 使用播放器的视频下载功能，需要在点播控制台开启并配置下载模式，详细操作请参见下载设置。

  • 视频下载支持断点续传。

操作步骤

  1. 可选：配置安全下载的加密校验文件。仅安全下载需要配置，普通下载无需配置。

    说明

    请确保配置的加密校验文件与App信息一致，否则会导致视频下载失败。

    如果设置为安全下载方式，则需要将在点播控制台生成的密钥文件配置到播放器SDK中，用于视频下载和播放的解密验证，密钥文件的生成请参见安全下载。

    配置一次即可，示例如下：

    FlutterAliPlayerFactory.initService(byteData);

  2. 创建并设置下载器。

    示例如下：

    FlutterAliDownloader downloader = FlutterAliDownloader.init();
///设置保存路径
downloader.setSaveDir(path)

  3. 开始下载。

    调用了开始下载后，会自动设置监听，并将回调信息返回。示例如下：

    ///1.prepare
 ///参数说明：type可选值为FlutterAvpdef.DOWNLOADTYPE_STS / FlutterAvpdef.DOWNLOADTYPE_AUTH 。当type为DOWNLOADTYPE_STS时候，必填参数为：{vid,accessKeyId,accessKeySecret,securityToken}，当 type 为 DOWNLOADTYPE_AUTH 时，必须填参数为 {vid,playAuth}
 downloader.prepare(type, vid).then((value) {
 //value为map，对应Demo中的DownloadModel自定义下载类
 DownloadModel downloadModel = DownloadModel.fromJson(value);
 //2.selectItem，根据不同的trackInfo来确定需要下载哪个清晰度
 List<TrackInfoModel> trackInfos = downloadModel.trackInfos;
 downloader.selectItem(vid,trackInfos[0].index);
 //3.start
 downloader.start(vid, trackInfos[0].index).listen((event) {
 //说明：event可能会有多种信息，可参考FlutterAvpdef.EventChanneldef中的信息，以下为具体说明：
 if (event[EventChanneldef.TYPE_KEY] == EventChanneldef.DOWNLOAD_PROGRESS){
 //下载进度百分比信息，获取下载进度百分比：event[EventChanneldef.DOWNLOAD_PROGRESS]
 }else if(event[EventChanneldef.TYPE_KEY] == EventChanneldef.DOWNLOAD_PROCESS){
 //处理进度百分比信息，获取处理进度百分比：event[EventChanneldef.DOWNLOAD_PROCESS]
 }else if(event[EventChanneldef.TYPE_KEY] == EventChanneldef.DOWNLOAD_COMPLETION){
 //下载完成，可以通过 event['vid']、event['index'] 获取对应的vid和index用于判断是哪个视频下载完成，event['savePath'] 用于获取下载完成视频的本地路径
 }else if(event[EventChanneldef.TYPE_KEY] == EventChanneldef.DOWNLOAD_ERROR){
 //下载失败，可以通过 event['vid']、event['index'] 获取对应的vid和index用于判断是哪个视频下载失败，event['errorCode']、event['errorMsg'] 可以获取对应的错误码，和错误信息
 }
 });
 });

  4. 停止下载。

    示例如下：

    downloader.stop(vid, index)

  5. 删除下载。

    删除下载选项，如果删除成功，则下载的本地文件也会随之删除。示例如下：

    downloader.delete(vid, index)

  6. 释放下载对象。

    当某个下载对象不再使用时，使用release方法将其释放，防止内存泄漏。示例如下：

    downloader.release(vid, index)

视频加密播放

点播视频支持HLS标准加密、阿里云私有加密和DRM加密。加密播放请参见如何播放加密视频。

文档推荐
  • 本页导读 （1）
文档反馈