Integrasikan Flutter Player SDK untuk Pemutaran Video - ApsaraVideo VOD

Topik ini menjelaskan cara memulai pemutaran video menggunakan kit pengembangan perangkat lunak (SDK) Pemutar Flutter.

Prasyarat

Anda telah mengintegrasikan SDK Pemutar Flutter.

Prosedur

Langkah 1: Buat pemutar

Anda dapat membuat pemutar menggunakan FlutterAliPlayerFactory.

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

Catatan

Fitur-fitur pemutar, seperti pemantauan kualitas pemutaran (yang menyediakan data mengenai kualitas pemutaran secara keseluruhan), pelacakan titik tunggal (yang membantu Anda menentukan lokasi pengguna atau perangkat tertentu, menganalisis perilaku pemutaran mereka, dan mengidentifikasi masalah pemutaran), serta statistik pemutaran video, bergantung pada fitur pelaporan log instrumentasi.

Saat membuat pemutar, fitur yang tersedia bervariasi tergantung pada cara Anda menyetel parameter setTraceID:

Jika Anda tidak meneruskan parameter setTraceID (default): Fitur pelaporan log instrumentasi diaktifkan. Anda dapat menggunakan fitur pemantauan kualitas pemutaran dan statistik pemutaran video, tetapi tidak dapat menggunakan fitur pelacakan titik tunggal.
Jika Anda meneruskan traceid ke parameter setTraceID: Anda harus menentukan nilai traceid tersebut. Nilainya harus berupa pengenal unik untuk pengguna atau perangkatnya, seperti ID pengguna dalam bisnis Anda, Identitas Peralatan Bergerak Internasional (IMEI), atau Pengenal untuk pengiklan (IDFA). Dalam hal ini, fitur pelaporan log instrumentasi diaktifkan, sehingga Anda dapat menggunakan fitur pemantauan kualitas pemutaran, pelacakan titik tunggal, dan statistik pemutaran video.
Jika Anda menyetel parameter setTraceID ke DisableAnalytics: Fitur pelaporan log instrumentasi dinonaktifkan. Akibatnya, Anda tidak dapat menggunakan fitur pemantauan kualitas pemutaran, pelacakan titik tunggal, maupun statistik pemutaran video.

Langkah 2: Tetapkan tampilan layar

Buat tampilan pemutar.

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

Sambungkan pemutar.

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

Langkah 3: Tetapkan sumber pemutaran

Pemutaran VidAuth (Direkomendasikan)

fAliplayer.setVidAuth(
  vid: "Your Vid", // Wajib diisi. ID video (VideoId).
  playAuth: "<yourPlayAuth>",// Wajib diisi. Kredensial pemutaran. Anda harus memanggil operasi GetVideoPlayAuth dari ApsaraVideo VOD untuk menghasilkan kredensial ini.
  region: "Your Region" // Wajib diisi. Wilayah tempat ApsaraVideo VOD diaktifkan. Nilai default: cn-shanghai.
);

Pemutaran VidSts

fAliplayer.setVidSts(
  vid: "Your Vid", // Wajib diisi. ID video (VideoId).
  accessKeyId: "<yourAccessKeyId>", // Wajib diisi. ID AccessKey dari pasangan AccessKey sementara. Anda harus memanggil operasi AssumeRole dari Security Token Service (STS) untuk menghasilkannya.
  accessKeySecret: "<yourAccessKeySecret>", // Wajib diisi. Rahasia AccessKey dari pasangan AccessKey sementara. Anda harus memanggil operasi AssumeRole dari STS untuk menghasilkannya.
  securityToken: "<yourSecurityToken>", // Wajib diisi. Token STS. Anda harus memanggil operasi AssumeRole dari STS untuk menghasilkannya.
  region: "Your Region", // Wajib diisi. Wilayah tempat ApsaraVideo VOD diaktifkan. Nilai default: cn-shanghai.
);

Pemutaran UrlSource

fAliplayer.setUrl("your videoUrl");

Catatan

Untuk informasi selengkapnya tentang cara menetapkan sumber pemutaran, lihat Fitur dasar.

Langkah 4: Mulai pemutaran

// Persiapkan pemutaran
fAliplayer.prepare();
// Mulai pemutaran
fAliplayer.play();

Langkah 5: Akhiri pemutaran

// Hentikan pemutaran
fAliplayer.stop();
// Hancurkan pemutar
fAliplayer.release();
// Kosongkan referensi untuk mencegah kebocoran memori
fAliplayer = null;

Referensi

Untuk informasi selengkapnya tentang fitur dasar pemutar, seperti kontrol pemutaran dan pendengar event, lihat Fitur dasar.