本文詳細說明如何通過Flutter播放器SDK快速實現視頻播放，包括播放器建立、視圖綁定、播放源設定及播放控制等核心步驟。 - ApsaraVideo VOD

本文介紹如何用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();
// 清Null 參考，避免記憶體流失
fAliplayer = null;

ApsaraVideo VOD：快速開始