本文详细说明如何通过Flutter播放器SDK快速实现视频播放，包括播放器创建、视图绑定、播放源设置及播放控制等核心步骤。

本文介绍如何用Flutter播放器SDK快速实现视频起播。

前提条件

已完成Flutter播放器的集成SDK。

操作步骤

步骤一：创建播放器

通过FlutterAliPlayerFactory创建播放器。

FlutterAliplayer fAliplayer = FlutterAliPlayerFactory.createAliPlayer();
fAliplayer.setTraceID("traceId");

说明

播放器提供的播放质量监控（可查看播放器整体播放质量相关数据）、单点追查（可定位到具体的用户或设备，分析其播放行为，快速定位播放异常等问题）及视频播放统计功能都依赖埋点日志上报功能而实现。

在创建播放器时，根据setTraceID参数的设置不同，其后续可实现的功能不同，具体如下：

setTraceID参数不传（默认）：埋点日志上报功能开启，后续可以使用播放质量监控和视频播放统计功能，无法使用单点追查功能。
setTraceID参数传入traceid：traceid的值由您自行定义，需为您的用户或用户设备的唯一标识符，例如传入您业务的userid或者IMEI、IDFA等您业务用户的设备ID。传入traceid后，埋点日志上报功能开启，后续可以使用播放质量监控、单点追查和视频播放统计功能。
setTraceID参数设置为DisableAnalytics：关闭埋点日志上报，后续无法使用播放质量监控、单点追查和视频播放统计功能。

步骤二：设置显示视图

创建播放器视图。

AliPlayerView aliPlayerView = AliPlayerView(
  onCreated: onViewPlayerCreated,
  x: 0,
  y: 0,
  width: width,
  height: height,
  aliPlayerViewType: AliPlayerViewTypeForAndroid.surfaceview);

绑定播放器。

void onViewPlayerCreated(viewId) async {
  fAliplayer.setPlayerView(viewId);
}

步骤三：设置播放源

VidAuth播放（推荐）

fAliplayer.setVidAuth(
  vid: "Vid信息", // 必选参数，视频ID（VideoId）。
  playAuth: "<yourPlayAuth>",// 必选参数，播放凭证，需要调用点播服务的GetVideoPlayAuth接口生成。
  region: "接入地域" // 必选参数，点播服务的接入地域，默认为cn-shanghai。
);

VidSts播放

fAliplayer.setVidSts(
  vid: "Vid信息", // 必选参数，视频ID（VideoId）。
  accessKeyId: "<yourAccessKeyId>", //必选参数 STS临时AK对的访问密钥ID，需要调用STS服务的AssumeRole接口生成。
  accessKeySecret: "<yourAccessKeySecret>", // 必选参数，STS临时AK对的访问密钥，需要调用STS服务的AssumeRole接口生成。
  securityToken: "<yourSecurityToken>", // 必选参数，STS安全令牌，需要调用STS服务的AssumeRole接口生成。
  region: "接入地域", // 必选参数，点播服务的接入地域，默认为cn-shanghai。
);

UrlSource播放

fAliplayer.setUrl("your videoUrl");

说明

更多设置播放源方法，请参见基础功能。

步骤四：开始播放

// 准备播放
fAliplayer.prepare();
// 开始播放
fAliplayer.play();

步骤五：结束播放

// 停止播放
fAliplayer.stop();
// 销毁播放器
fAliplayer.release();
// 清空引用，避免内存泄漏
fAliplayer = null;

快速开始