ApsaraVideo VOD：Fitur lanjutan

Pemutaran

Putar daftar video pendek

1. Buat pemain daftar.

   FlutterAliListPlayer fAliListPlayer = FlutterAliPlayerFactory.createAliListPlayer();

2. Tambah dan hapus sumber daya.

   Pemutar daftar hanya mendukung playback dari UrlSource dan VidSts.

   // Parameter uid menentukan ID unik sebuah video. Gunakan UID untuk mengidentifikasi video. Video yang memiliki UID yang sama dianggap identik.
   fAliListPlayer.addUrlSource(url,uid);
   fAliListPlayer.addVidSource(vid,uid);
   fAliListPlayer.removeSource(uid);

3. Atur jumlah video yang akan dipreloading.

   Mengatur jumlah video yang dipreloading secara wajar dapat mengurangi waktu startup secara efektif. Kode berikut memberikan contohnya:

   // Atur jumlah video yang dipreloading. Total jumlah video yang dimuat dihitung menggunakan rumus berikut: 1 + count × 2.
   fAliListPlayer.setPreloadCount(count);

4. Putar sumber video.

   // Parameter uid wajib diisi. Untuk playback berbasis URL, cukup tentukan UID-nya saja. Untuk playback berbasis STS, tentukan informasi STS-nya.
   fAliListPlayer.moveTo();

Beralih antara decoding perangkat lunak dan perangkat keras

// Aktifkan decoding perangkat keras. Fitur ini diaktifkan secara default.
fAliplayer.setEnableHardwareDecoder(enable);

fAliplayer.getMediaInfo().then((value) {
// Nilai 'value' adalah map. Anda dapat menggunakan value['tracks'] untuk mendapatkan daftar TrackInfos. Untuk memahami cara mengurai TrackInfo, lihat AVPMediaInfo info = AVPMediaInfo.fromJson(value); dalam demo.

});

// Beralih bitrate.
fAliplayer.selectTrack(index);
// Beralih bitrate dan aktifkan streaming adaptif.
fAliplayer.selectTrack(-1);

Ambil snapshot

// Listener untuk snapshot yang berhasil.
fAliplayer.setOnSnapShot((path,playerId) {

});
// Ambil snapshot. 'path' adalah jalur tempat citra disimpan.
fAliplayer.snapshot(path);

Pratinjau video

SDK ApsaraVideo Player untuk Flutter dapat dikonfigurasi dengan ApsaraVideo VOD untuk mengaktifkan fitur pratinjau video. Fitur pratinjau didukung untuk playback berbasis VidAuth (disarankan) dan playback berbasis VidSts. Untuk informasi selengkapnya tentang cara mengonfigurasi dan menggunakan fitur pratinjau, lihat Pratinjau video.

// previewTime adalah durasi pratinjau dalam detik.
// Playback berbasis VidAuth
fAliplayer.setVidAuth(
 vid: "Masukkan VID resource",
 region: "Masukkan wilayah resource",
 playAuth: "Masukkan PlayAuth resource",
 previewTime: "Masukkan durasi pratinjau dalam detik");

 // Playback berbasis VidSts
 fAliplayer.setVidSts(
 vid: "Masukkan VID resource",
 region: "Masukkan wilayah resource",
 accessKeyId: "Masukkan ID AccessKey resource",
 accessKeySecret: "Masukkan Rahasia AccessKey resource",
 securityToken: "Masukkan token keamanan resource",
 previewTime: "Masukkan durasi pratinjau dalam detik");

Konfigurasi lainnya

var configMap = {
 'mStartBufferDuration':_mStartBufferDurationController.text,// Durasi buffer sebelum playback dimulai, dalam milidetik.
 'mHighBufferDuration':_mHighBufferDurationController.text,// Batas atas buffer, dalam milidetik.
 'mMaxBufferDuration':_mMaxBufferDurationController.text,// Durasi buffer maksimum, dalam milidetik.
 'mMaxDelayTime': _mMaxDelayTimeController.text,// Latensi maksimum untuk streaming langsung, dalam milidetik. Catatan: Parameter ini hanya berlaku untuk streaming langsung.
 'mNetworkTimeout': _mNetworkTimeoutController.text,// Periode timeout jaringan, dalam milidetik.
 'mNetworkRetryCount':_mNetworkRetryCountController.text,/// Jumlah percobaan ulang setelah timeout jaringan.
 'mMaxProbeSize': _mMaxProbeSizeController.text,// Ukuran probe maksimum.
 'mReferrer': _mReferrerController.text,// Referrer.
 'mHttpProxy': _mHttpProxyController.text,// Proxy HTTP.
 'mEnableSEI': mEnableSEI,// Menentukan apakah SEI diaktifkan.
 'mClearFrameWhenStop': !mShowFrameWhenStop,/// Menentukan apakah frame terakhir dihapus saat playback berhenti.
 'mDisableVideo': mDisableVideo,// Menentukan apakah video dinonaktifkan.
 'mDisableAudio': mDisableAudio,// Menentukan apakah audio dinonaktifkan.
 'mUserAgent':mUserAgent,// User agent.
};
// Terapkan konfigurasi.
fAliplayer.setConfig(configMap);

Kinerja

Pre-rendering

fAliplayer.setOption(FlutterAvpdef.ALLOW_PRE_RENDER, 1);

Cache lokal

/**
 *  Aktifkan cache lokal. Jika fitur ini diaktifkan, video akan di-cache ke file lokal.
 *
 *  @param enable - Saklar untuk fitur cache lokal. true: aktifkan cache lokal. false: nonaktifkan cache lokal. Nilai default: false.
 *  @param maxBufferMemoryKB - Parameter ini sudah usang dan tidak berpengaruh pada v5.4.7.1 dan versi selanjutnya.
 *  @param localCacheDir - Direktori file cache. Harus berupa jalur mutlak.
 *  @param mDocTypeForIOS - Jenis direktori sandbox untuk iOS.
 */
FlutterAliplayer.enableLocalCache(bool enable,String maxBufferMemoryKB,String localCacheDir,DocTypeForIOS mDocTypeForIOS);

/**
  * Konfigurasi untuk membersihkan file cache.
  *
  * @param expireMin - Parameter ini sudah usang dan tidak berpengaruh pada v5.4.7.1 dan versi selanjutnya.
  * @param maxCapacityMB - Ukuran cache maksimum dalam MB. Nilai default: 20 GB. Saat sistem membersihkan cache, jika total ukuran file cache melebihi batas ini, sistem akan mengurutkan item cache berdasarkan waktu akses terakhir dan menghapus file tertua satu per satu hingga total ukuran kurang dari atau sama dengan batas tersebut.
  * @param freeStorageMB - Ruang disk kosong minimum dalam MB. Nilai default: 0. Saat sistem membersihkan cache, jika ruang disk kosong saat ini kurang dari nilai ini, sistem juga akan menghapus file cache tertua satu per satu hingga ruang disk kosong lebih besar dari atau sama dengan nilai ini atau hingga semua file cache dihapus.
  */
FlutterAliplayer.setCacheFileClearConfig(String expireMin,String maxCapacityMB,String freeStorageMB);

Aktifkan atau nonaktifkan caching lokal untuk URL tunggal

// Dapatkan konfigurasi.
fAliplayer.getPlayConfig().then((config){
  // Nonaktifkan atau aktifkan cache lokal.
  config.enableLocalCache = false;
  // Terapkan pengaturan.
  fAliplayer.setPlayConfig(config);
});

Preloading

Unduh video

Catatan penggunaan

• Anda hanya dapat mengunduh video yang diputar menggunakan VidSts atau VidAuth.

• Untuk menggunakan fitur unduh video, Anda harus mengaktifkan fitur tersebut dan mengonfigurasi mode unduh di Konsol ApsaraVideo VOD. Untuk informasi selengkapnya, lihat Unduh offline.

• Unduhan berkelanjutan didukung.

Prosedur

1. Opsi: Konfigurasikan file enkripsi dan verifikasi untuk unduhan aman. Langkah ini hanya diperlukan untuk unduhan aman dan dapat dilewati untuk unduhan normal.

   Catatan

   Pastikan file enkripsi dan verifikasi yang dikonfigurasi sesuai dengan informasi aplikasi. Jika tidak, unduhan video akan gagal.

   Jika Anda menggunakan mode unduh aman, Anda harus mengonfigurasi file kunci yang dihasilkan di Konsol ApsaraVideo VOD untuk SDK ApsaraVideo Player. File kunci ini digunakan untuk mendekripsi dan memverifikasi video selama unduhan dan playback. Untuk informasi selengkapnya tentang cara menghasilkan file kunci, lihat Unduh aman.

   Anda hanya perlu mengonfigurasi file kunci sekali. Kode berikut memberikan contohnya:

   FlutterAliPlayerFactory.initService(byteData);

2. Buat dan konfigurasikan downloader.

   Kode berikut memberikan contohnya:

   FlutterAliDownloader downloader = FlutterAliDownloader.init();
   /// Atur jalur penyimpanan.
   downloader.setSaveDir(path)

3. Mulai unduhan.

   Setelah Anda memulai unduhan, listener akan diatur secara otomatis untuk mengembalikan informasi callback. Kode berikut memberikan contohnya:

   /// 1. prepare
    /// Deskripsi parameter: Parameter type dapat diatur ke FlutterAvpdef.DOWNLOADTYPE_STS atau FlutterAvpdef.DOWNLOADTYPE_AUTH. Jika Anda mengatur type ke DOWNLOADTYPE_STS, parameter vid, accessKeyId, accessKeySecret, dan securityToken wajib diisi. Jika Anda mengatur type ke DOWNLOADTYPE_AUTH, parameter vid dan playAuth wajib diisi.
    downloader.prepare(type, vid).then((value) {
    // Nilai 'value' adalah map yang sesuai dengan kelas unduh kustom DownloadModel dalam demo.
    DownloadModel downloadModel = DownloadModel.fromJson(value);
    // 2. selectItem. Pilih definisi video yang akan diunduh berdasarkan trackInfo.
    List<TrackInfoModel> trackInfos = downloadModel.trackInfos;
    downloader.selectItem(vid,trackInfos[0].index);
    // 3. start
    downloader.start(vid, trackInfos[0].index).listen((event) {
    // Catatan: Event dapat berisi berbagai jenis informasi. Untuk informasi selengkapnya, lihat FlutterAvpdef.EventChanneldef. Kode berikut memberikan rinciannya:
    if (event[EventChanneldef.TYPE_KEY] == EventChanneldef.DOWNLOAD_PROGRESS){
    // Progres unduhan dalam persentase. Dapatkan progres unduhan: event[EventChanneldef.DOWNLOAD_PROGRESS].
    }else if(event[EventChanneldef.TYPE_KEY] == EventChanneldef.DOWNLOAD_PROCESS){
    // Progres pemrosesan dalam persentase. Dapatkan progres pemrosesan: event[EventChanneldef.DOWNLOAD_PROCESS].
    }else if(event[EventChanneldef.TYPE_KEY] == EventChanneldef.DOWNLOAD_COMPLETION){
    // Unduhan selesai. Anda dapat menggunakan event['vid'] dan event['index'] untuk mendapatkan vid dan indeks yang sesuai guna mengidentifikasi video yang telah diunduh. Gunakan event['savePath'] untuk mendapatkan jalur lokal video yang diunduh.
    }else if(event[EventChanneldef.TYPE_KEY] == EventChanneldef.DOWNLOAD_ERROR){
    // Unduhan gagal. Anda dapat menggunakan event['vid'] dan event['index'] untuk mendapatkan vid dan indeks yang sesuai guna mengidentifikasi video yang gagal diunduh. Anda dapat menggunakan event['errorCode'] dan event['errorMsg'] untuk mendapatkan kode kesalahan dan pesan kesalahan.
    }
    });
    });

4. Hentikan unduhan.

   Kode berikut memberikan contohnya:

   downloader.stop(vid, index)

5. Hapus unduhan.

   Ini akan menghapus tugas unduhan. Jika tugas berhasil dihapus, file lokal yang sesuai juga akan dihapus. Kode berikut memberikan contohnya:

   downloader.delete(vid, index)

6. Lepaskan objek unduhan.

   Saat Anda tidak lagi memerlukan objek unduhan, panggil metode release untuk melepaskannya dan mencegah kebocoran memori. Kode berikut memberikan contohnya:

   downloader.release(vid, index)

Playback video terenkripsi

ApsaraVideo VOD mendukung Enkripsi HLS, Enkripsi privat Alibaba Cloud, dan Enkripsi DRM. Untuk informasi selengkapnya tentang memutar video terenkripsi, lihat Putar video terenkripsi.