Flutter Player SDK の統合によるビデオ再生 - VOD

このトピックでは、Flutter プレーヤーソフトウェア開発キット (SDK) を使用したビデオ再生の開始方法について説明します。

前提条件

Flutter プレーヤー SDK を統合済みであること。

手順

ステップ 1: プレーヤーの作成

FlutterAliPlayerFactory を使用してプレーヤーを作成できます。

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

説明

再生品質モニタリング (全体的な再生品質に関するデータを提供)、シングルポイントトラッキング (特定のユーザーやデバイスを特定し、その再生動作を分析し、再生の問題を特定するのに役立ちます)、ビデオ再生統計などのプレーヤー機能は、イベントトラッキングログレポート機能に依存します。

プレーヤーを作成する際、利用可能な機能は setTraceID パラメーターの設定方法によって異なります。

setTraceID パラメーターを渡さない場合 (デフォルト): イベントトラッキングログレポート機能が有効になります。再生品質モニタリング機能とビデオ再生統計機能を使用できます。シングルポイントトラッキング機能は使用できません。
traceid を setTraceID パラメーターに渡す場合: traceid の値を定義する必要があります。この値は、ビジネスのユーザー ID、国際移動体装置識別番号 (IMEI)、広告主識別子 (IDFA) など、ユーザーまたはそのデバイスの一意の識別子である必要があります。 traceid を渡すと、イベントトラッキングログレポート機能が有効になります。再生品質モニタリング、シングルポイントトラッキング、およびビデオ再生統計機能を使用できます。
setTraceID パラメーターを DisableAnalytics に設定した場合: イベントトラッキングログレポート機能が無効になります。再生品質モニタリング、シングルポイントトラッキング、またはビデオ再生統計機能は使用できません。

ステップ 2: 表示ビューの設定

プレーヤービューを作成できます。

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

プレーヤーをアタッチできます。

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

ステップ 3: 再生ソースの設定

VidAuth 再生 (推奨)

fAliplayer.setVidAuth(
  vid: "Your Vid", // 必須。 ビデオ ID (VideoId)。
  playAuth: "<yourPlayAuth>",// 必須。 再生認証情報。 ApsaraVideo VOD の GetVideoPlayAuth 操作を呼び出して、認証情報を生成する必要があります。
  region: "Your Region" // 必須。 ApsaraVideo VOD が有効化されているリージョン。 デフォルト値: cn-shanghai。
);

VidSts 再生

fAliplayer.setVidSts(
  vid: "Your Vid", // 必須。 ビデオ ID (VideoId)。
  accessKeyId: "<yourAccessKeyId>", // 必須。 一時的な AccessKey ペアの AccessKey ID。 セキュリティトークンサービス (STS) の AssumeRole 操作を呼び出して生成する必要があります。
  accessKeySecret: "<yourAccessKeySecret>", // 必須。 一時的な AccessKey ペアの AccessKey Secret。 STS の AssumeRole 操作を呼び出して生成する必要があります。
  securityToken: "<yourSecurityToken>", // 必須。 STS トークン。 STS の AssumeRole 操作を呼び出して生成する必要があります。
  region: "Your Region", // 必須。 ApsaraVideo VOD が有効化されているリージョン。 デフォルト値: cn-shanghai。
);

UrlSource 再生

fAliplayer.setUrl("your videoUrl");

説明

再生ソースの設定方法の詳細については、「基本機能」をご参照ください。

ステップ 4: 再生の開始

// 再生準備
fAliplayer.prepare();
// 再生開始
fAliplayer.play();

ステップ 5: 再生の終了

// 再生停止
fAliplayer.stop();
// プレーヤーの破棄
fAliplayer.release();
// メモリリークを防ぐためにリファレンスをクリア
fAliplayer = null;

リファレンス

再生コントロールやイベントリスナーなどのプレーヤーの基本機能の詳細については、「基本機能」をご参照ください。