ApsaraVideo VOD：Fitur lanjutan

Mainkan video dengan transparansi

/**
 * Mengatur mode rendering alpha.
 *
 * @param alphaRenderMode Mode rendering alpha yang ditentukan. Lihat {@link AlphaRenderMode}.
 */
abstract public void setAlphaRenderMode(AlphaRenderMode alphaRenderMode);

//--------------Penggunaan View-------------
// View perlu diatur menjadi transparan.
//TextureView
TextureView aliplayerView; // View untuk pemutaran.
aliplayerView.setOpaque(false);

//SurfaceView
SurfaceView aliplayerView; // View untuk pemutaran.
aliplayerView.getHolder().setFormat(PixelFormat.TRANSLUCENT);
aliplayerView.setZOrderOnTop(true); // Tempatkan SurfaceView di bagian atas jendela tampilan.

//-----------Penggunaan AliPlayer-----------
// Atur mode alpha.
aliPlayer.setAlphaRenderMode(IPlayer.AlphaRenderMode.RENDER_MODE_ALPHA_AT_RIGHT);
// Atur materi yang sesuai dengan mode alpha.
UrlSource urlSource = new UrlSource();
urlSource.setUri("https://alivc-player.oss-cn-shanghai.aliyuncs.com/video/business_requirements_sample/alpha_channel/alpha_right.mp4");
aliPlayer.setDataSource(urlSource);
aliPlayer.setOnCompletionListener(new IPlayer.OnCompletionListener() {
    @Override
    public void onCompletion() {
        // Opsional: Jika ada masalah koneksi setelah pemutaran instans tunggal selesai, Anda dapat membersihkan layar.
        aliPlayer.clearScreen();
    }
}
aliPlayer.setAutoPlay(true);
aliPlayer.prepare();

ApsaraVideo Player SDK untuk Android mendukung penambahan dan pengalihan subtitle eksternal. SDK mendukung format subtitle SRT, SSA, ASS, dan VTT.

Kode berikut merupakan contohnya:

1. Buat view untuk menampilkan subtitle.

   Anda dapat membuat view berbeda untuk format subtitle yang berbeda.

   Klik untuk melihat kode

   // Digunakan untuk menampilkan subtitle SRT dan VTT.
   SubtitleView subtitleView = new SubtitleView(getContext());
   // Untuk player V7.6.0 dan versi lebih baru, kami menyarankan menggunakan VttSubtitleView untuk menampilkan subtitle SRT dan VTT.
   VttSubtitleView vttSubtitleView = new VttSubtitleView(getContext());
   // Digunakan untuk menampilkan subtitle ASS dan SSA.
   AssSubtitleView assSubtitleView = new AssSubtitleView(getContext());
   // Tambahkan view subtitle ke layout view.
   viewGroup.addView(assSubtitleView);

   Saat Anda mengintegrasikan player V7.6.0 atau versi lebih baru dan menggunakan VttSubtitleView untuk menampilkan subtitle SRT dan VTT, Anda harus mengatur listener berikut:

   // Wajib untuk player V7.6.0 dan versi lebih baru.
   mAliPlayer.setOnVideoSizeChangedListener(new IPlayer.OnVideoSizeChangedListener() {
       @Override
       public void onVideoSizeChanged(int width, int height) {
           int viewWidth = getWidth();
           int viewHeight = getHeight();
           IPlayer.ScaleMode mode = mVideoListPlayer.getScaleMode();
           SubTitleBase.VideoDimensions videoDimensions = SubTitleBase.getVideoDimensionsWhenRenderChanged(width, height, viewWidth, viewHeight, mode);
           vttSubtitleView.setVideoRenderSize(videoDimensions.videoDisplayWidth, videoDimensions.videoDisplayHeight);
       }
   });

2. Tambahkan subtitle.

   Penting

   File subtitle harus diatur di onPrepared.

   mAliPlayer.setOnPreparedListener(new IPlayer.OnPreparedListener() {
       @Override
       public void onPrepared() {
           // Atur subtitle (harus diatur di onPrepared).
           mAliPlayer.addExtSubtitle(EXT_SUBTITLE_URL);
       }
   });

3. Atur listener terkait subtitle.

   Klik untuk melihat kode

   mAliPlayer.setOnSubtitleDisplayListener(new IPlayer.OnSubtitleDisplayListener() {
               @Override
               public void onSubtitleExtAdded(int trackIndex, String url) {
                   // trackIndex: Indeks subtitle. true: Tampilkan subtitle yang ditentukan. false: Sembunyikan subtitle yang ditentukan.
                   mAliPlayer.selectExtSubtitle(trackIndex, true);
               }
   
               @Override
               public void onSubtitleShow(int trackIndex, long id, String data) {
                   // Subtitle
                   SubtitleView.Subtitle subtitle = new SubtitleView.Subtitle();
                   subtitle.id = String.valueOf(id);
                   subtitle.content = data;
                   // Tampilkan subtitle.
                   mSubtitleView.show(subtitle);
               }
   
               @Override
               public void onSubtitleHide(int trackIndex, long id) {
                   // Hapus subtitle.
                   mSubtitleView.dismiss(String.valueOf(id));
               }
   
               @Override
               public void onSubtitleHeader(int trackIndex, String header) {
               }
           }
       );

Jika model perangkat saat ini berada dalam blacklist H.265 berbasis cloud atau jika decoding hardware aliran H.265 gagal, fallback adaptif terjadi. Proses fallback adalah sebagai berikut: Jika aliran cadangan H.264 diatur, aliran cadangan tersebut diputar secara otomatis. Jika tidak ada aliran cadangan H.264 yang diatur, player secara otomatis fallback ke decoding software H.265.

Kode berikut menunjukkan cara mengatur aliran cadangan:

// Lapisan aplikasi memelihara Map yang menyimpan semua pasangan kunci-nilai URL asli-URL cadangan. Saat beralih, URL cadangan ditanyakan di Map berdasarkan URL asli.
 AliPlayerGlobalSettings.setAdaptiveDecoderGetBackupURLCallback(new AliPlayerGlobalSettings.OnGetBackupUrlCallback() {
    @Override
    public String getBackupUrlCallback(int oriBizScene, int oriCodecType, String original_url) {
        String kurl = original_url;
        if (!H265toH264Map.get(kurl).isEmpty()) {
            return H265toH264Map.get(kurl);
        } else {
            return "";
        }
    }
});

ApsaraVideo Player SDK untuk Android, bersama dengan konfigurasi ApsaraVideo VOD, mengimplementasikan fitur pratinjau. Fitur ini mendukung metode pemutaran VidSts dan VidAuth (direkomendasikan untuk ApsaraVideo VOD). Untuk informasi selengkapnya tentang cara mengonfigurasi dan menggunakan fitur pratinjau, lihat Pratinjau video.

VidSts vidSts = new VidSts;
....
VidPlayerConfigGen configGen = new VidPlayerConfigGen();
configGen.setPreviewTime(20); // Pratinjau 20 detik
vidSts.setPlayConfig(configGen); // Atur untuk sumber pemutaran
...

ApsaraVideo Player SDK untuk Android menyediakan antarmuka untuk mengatur cache dan kontrol latensi melalui PlayerConfig. Kode berikut merupakan contohnya:

// Pertama, dapatkan konfigurasi.
PlayerConfig config = aliPlayer.getConfig();
// Delay maksimum. Catatan: Ini efektif untuk streaming langsung. Saat delay besar, SDK player akan melakukan sinkronisasi frame untuk memastikan delay player berada dalam rentang ini.
config.mMaxDelayTime = 5000;
// Durasi buffer maksimum dalam ms. Player memuat paling banyak data buffer sebanyak ini setiap kali.
config.mMaxBufferDuration = 50000;
// Durasi buffer tinggi dalam ms. Saat data sedang dimuat karena kondisi jaringan buruk, jika durasi buffer yang dimuat mencapai nilai ini, status loading berakhir.
config.mHighBufferDuration = 3000;
// Durasi buffer awal dalam ms. Semakin pendek waktu ini diatur, semakin cepat pemutaran dimulai. Namun, hal ini juga dapat menyebabkan player memasuki status loading segera setelah pemutaran dimulai.
config.mStartBufferDuration = 500;
....// Pengaturan lainnya
// Durasi buffer mundur maksimum dalam ms. Default adalah 0.
config.mMaxBackwardBufferDurationMs = 0;

// Atur konfigurasi untuk player.
aliPlayer.setConfig(config);

Gambar-dalam-Gambar (PiP)

Prosedurnya adalah sebagai berikut:

1. Dalam file AndroidManifest.xml, deklarasikan izin PiP.

   <activity
     android:name=".PictureInPictureActivity"
     android:exported="true"
     android:supportsPictureInPicture="true"
     android:configChanges="screenSize|smallestScreenSize|screenLayout|orientation" />

2. Alihkan Activity target ke mode PiP.

   Rational aspectRatio = new Rational(16, 9); // Rasio aspek jendela PiP, yang dapat disesuaikan sesuai kebutuhan.
   PictureInPictureParams.Builder pipBuilder = new PictureInPictureParams.Builder();
   pipBuilder.setAspectRatio(aspectRatio);
   enterPictureInPictureMode(pipBuilder.build());

   Anda dapat memilih untuk memicu mode PiP dari event OnClick, saat meninggalkan aplikasi, atau saat kembali ke aplikasi. Metode implementasinya adalah sebagai berikut:

   Dipicu oleh OnClick

   button.setOnClickListener(new View.OnClickListener() {
       @Override
       public void onClick(View v) {
           Rational aspectRatio = new Rational(16, 9); // Rasio aspek jendela PiP.
           PictureInPictureParams.Builder pipBuilder = new PictureInPictureParams.Builder();
           pipBuilder.setAspectRatio(aspectRatio);
           enterPictureInPictureMode(pipBuilder.build());
       }
   });

   Dipicu saat meninggalkan aplikasi

   @Override
   protected void onUserLeaveHint() {
       super.onUserLeaveHint();
       Rational aspectRatio = new Rational(16, 9); // Rasio aspek jendela PiP.
       PictureInPictureParams.Builder pipBuilder = new PictureInPictureParams.Builder();
       pipBuilder.setAspectRatio(aspectRatio);
       enterPictureInPictureMode(pipBuilder.build());
   
       Log.e(TAG, "PiP onUserLeaveHint");
   }

   Dipicu saat kembali ke aplikasi

   @Override
   public void onBackPressed() {
       super.onBackPressed();
       // Dipicu dari tombol kembali.
       enterPictureInPictureMode();
   }

3. Tangani UI untuk menampilkan dan menyembunyikan jendela PiP.

   @Override
   public void onPictureInPictureModeChanged(boolean isInPictureInPictureMode, Configuration newConfig) {
       super.onPictureInPictureModeChanged(isInPictureInPictureMode, newConfig);
       if (isInPictureInPictureMode) {
           // Penanganan saat memasuki mode PiP.
           // sembunyikan UI
           Log.e(TAG, "Memasuki mode PiP");
       } else {
           // Penanganan saat keluar dari mode PiP.
           // tampilkan UI 
           Log.e(TAG, "Keluar dari mode PiP");
       }
   }

Fallback RTS langsung

Untuk informasi selengkapnya, lihat Streaming langsung RTS.

ApsaraVideo Player SDK untuk Android menggunakan metode setOutputAudioChannel untuk mengatur saluran suara output. Jika sumber input adalah dual-channel, Anda dapat menggunakan metode berikut untuk beralih ke saluran kiri atau kanan. Jika sumber input adalah single-channel, pengaturan ini tidak berpengaruh.

/*
OutputAudioChannel.OUTPUT_AUDIO_CHANNEL_LEFT: Beralih ke saluran kiri untuk pemutaran.
OutputAudioChannel.OUTPUT_AUDIO_CHANNEL_RIGHT: Beralih ke saluran kanan untuk pemutaran.
OutputAudioChannel.OUTPUT_AUDIO_CHANNEL_NONE: Jangan beralih saluran, pertahankan saluran sumber input untuk pemutaran.
*/
aliPlayer.setOutputAudioChannel();

Anda dapat mengatur listener untuk mendapatkan data aliran audio dan video. Audio dan video tidak boleh berupa aliran terenkripsi karena aliran terenkripsi tidak dapat diparse.

// Konfigurasi opsional 1: Apakah akan mengembalikan alamat data dasar.
IPlayer.RenderFrameCallbackConfig config = new IPlayer.RenderFrameCallbackConfig();
config.mVideoDataAddr = true; // Apakah hanya mengembalikan alamat data video dasar.
config.mAudioDataAddr = true; // Apakah hanya mengembalikan alamat data audio dasar.
aliPlayer.setRenderFrameCallbackConfig(config);

// Konfigurasi opsional 2: Saat decoding hardware diaktifkan, RenderFrame mengembalikan texture_oes_id. Saat decoding software diaktifkan, RenderFrame mengembalikan data sumber.
aliPlayer.enableHardwareDecoder(true);
// Atur listener untuk mendapatkan data audio dan video.
aliPlayer.setOnRenderFrameCallback(frameInfo -> {
    if (frameInfo.frameType == FrameInfo.FrameType_video) {
        // Data video
    } else {
        // Data audio
    }
    return false;
});

ApsaraVideo Player SDK untuk Android mendukung pengaturan warna latar belakang untuk rendering player. Operasi API dan petunjuk penggunaannya adalah sebagai berikut:

Contoh operasi API

/**
 * Mengatur warna latar belakang video.
 * @param color  ARGB
 */
abstract public void setVideoBackgroundColor(int color);

Petunjuk penggunaan

// Parameter adalah data heksadesimal 8-bit. 8 bit dikelompokkan berpasangan, mewakili A (transparansi alpha), R (merah), G (hijau), dan B (biru) secara berurutan.
// Misalnya, 0x0000ff00 merepresentasikan hijau.
aliPlayer.setVideoBackgroundColor(0x0000ff00);

Tentukan nama domain pemutaran untuk VidAuth

Anda dapat menggunakan metode VidAuth untuk menentukan bidang seperti nama domain yang sesuai dengan VID. Untuk informasi selengkapnya tentang bidang yang didukung, lihat Parameter permintaan GetPlayInfo. Operasi API dan petunjuk penggunaannya adalah sebagai berikut:

Contoh operasi API

/**
 * Mengatur parameter pemutaran.
 *
 * @param playConfig Parameter pemutaran.
 */
public void setPlayConfig(VidPlayerConfigGen playConfig);

Petunjuk penggunaan

Anda dapat menggunakan metode addPlayerConfig antarmuka VidPlayerConfigGen untuk menambahkan bidang playDomain.

vidAuth = new VidAuth();
VidPlayerConfigGen configGen = new VidPlayerConfigGen();
// Tambahkan bidang playDomain. Untuk informasi selengkapnya tentang bidang yang dapat ditambahkan, lihat
// https://www.alibabacloud.com/help/en/vod/developer-reference/api-vod-2017-03-21-getplayinfo
configGen.addPlayerConfig("playDomain", "com.xxx.xxx");
vidAuth.setPlayConfig(configGen);

Plugin decoding H.266

H.266 (VVC/Versatile Video Coding) adalah standar encoding video generasi berikutnya yang secara signifikan menghemat bitrate sambil mempertahankan kualitas gambar yang sama. Untuk mengoptimalkan performa dan mengontrol ukuran SDK utama, kemampuan decoding bernilai tambah H.266 dikemas secara independen sebagai plugin, yang mendukung integrasi sesuai permintaan.

Prasyarat

1. ApsaraVideo Player SDK atau All-in-One SDK adalah V7.6.0 atau versi lebih baru.

2. Lisensi Edisi Profesional telah diperoleh. Untuk informasi selengkapnya, lihat Dapatkan lisensi untuk ApsaraVideo Player SDK.

3. ApsaraVideo Player dengan plugin decoding H.266 hanya mendukung pemutaran video H.266 yang ditranskode oleh Transcoding Alibaba Cloud.

Integrasikan plugin

// x.x.x harus konsisten dengan nomor versi ApsaraVideo Player SDK.
com.aliyun.sdk.android:AlivcVVCCodec:x.x.x

// x.x.x harus konsisten dengan nomor versi All-in-One SDK yang Anda gunakan.
com.aliyun.sdk.android:AlivcVVCCodec:x.x.x-aio

Aktifkan plugin

AliPlayerGlobalSettings.enableCodecPlugin("vvc", true);

Kode kesalahan terkait

Untuk kode kesalahan terkait plugin decoding H.266, lihat FAQ umum untuk player di berbagai klien.

Segarkan otomatis sumber pemutaran

Mengaktifkan fitur penyegaran otomatis sumber pemutaran mencegah gangguan pemutaran yang disebabkan oleh kedaluwarsa autentikasi. Fitur ini memicu listener saat sumber menjadi tidak valid dan mendapatkan alamat pemutaran baru, yang memastikan pemutaran video berkelanjutan dan lancar.

Prasyarat

1. ApsaraVideo Player SDK atau All-in-One SDK adalah V7.9.0 atau versi lebih baru.

2. Anda menggunakan sumber VidAuth untuk pemutaran atau bisnis Anda telah mengonfigurasi penandatanganan URL.

/**
 * Mengatur listener untuk event kedaluwarsa sumber VidAuth.
 *
 * Fitur ini memungkinkan penyegaran otomatis sumber VidAuth untuk menghindari gangguan pemutaran
 * yang disebabkan oleh kedaluwarsa. Saat listener dipicu, Anda dapat menyegarkan sumber VidAuth
 * dan mengembalikan VidAuth yang diperbarui menggunakan {@link SourceRefreshCallback#onSuccess}.
 *
 * @param listener Antarmuka untuk mendengarkan event kedaluwarsa sumber VidAuth. Lihat {@link OnVidAuthExpiredListener}.
 *
 */
abstract public void setOnVidAuthExpiredListener(OnVidAuthExpiredListener listener);

/**
 * Listener untuk notifikasi kedaluwarsa sumber VidAuth.
 * Menangani event saat sumber VidAuth kedaluwarsa.
 */
public interface OnVidAuthExpiredListener {

    /**
     * Dipanggil saat player mendeteksi bahwa sumber VidAuth telah kedaluwarsa. Kedaluwarsa sumber VidAuth mencakup kedaluwarsa PlayAuth dan alamat pemutaran.
     *
     * Anda dapat menyegarkan sumber VidAuth dalam callback ini dan mengembalikan VidAuth baru
     * menggunakan {@link SourceRefreshCallback#onSuccess}.
     *
     * @param expiredSource Objek sumber VidAuth yang kedaluwarsa. Lihat {@link VidAuth}.
     * @param callback Callback yang digunakan untuk memberikan sumber VidAuth yang diperbarui ke player. Lihat {@link SourceRefreshCallback}.
     */
    void onVidAuthExpired(VidAuth expiredSource, SourceRefreshCallback<VidAuth> callback);
}

/**
 * Antarmuka callback untuk menangani hasil penyegaran sumber pemutaran.
 *
 * Antarmuka ini berlaku untuk jenis sumber pemutaran yang memerlukan pembaruan dinamis,
 * seperti sumber URL atau sumber VidAuth. Saat player memicu permintaan penyegaran,
 * hasil penyegaran dapat dikembalikan melalui antarmuka ini dengan memanggil metode `onSuccess` atau `onError`.
 */
public interface SourceRefreshCallback<T extends SourceBase> {
    /**
     * Dipanggil oleh player saat operasi penyegaran berhasil.
     *
     * @param newSource Objek sumber pemutaran baru yang berisi informasi yang diperbarui. Lihat {@link SourceBase}.
     *
     * Metode ini menunjukkan bahwa operasi penyegaran berhasil diselesaikan. Developer harus menyediakan
     * sumber pemutaran baru dalam metode ini agar player dapat memuat resource terbaru.
     */
    void onSuccess(T newSource);

    /**
     * Dipanggil oleh player saat operasi penyegaran gagal.
     *
     * @param errorMsg String yang menjelaskan alasan kegagalan.
     *
     * Metode ini menunjukkan bahwa operasi penyegaran gagal. Developer dapat menggunakan `errorMsg`
     * untuk menangkap detail kegagalan dan melanjutkan penanganan berikutnya.
     */
    void onError(String errorMsg);
}

// Atur listener untuk kedaluwarsa kredensial pemutaran VID.
aliPlayer.setOnVidAuthExpiredListener(new AliPlayer.OnVidAuthExpiredListener() {
    @Override
    public void onVidAuthExpired(VidAuth vidAuth, UrlPlayer.SourceRefreshCallback<VidAuth> sourceRefreshCallback) {
        
        String vid = vidAuth.getVid();

        // ------------------- Awal implementasi pengguna -------------------
        // Panggil fungsi yang Anda implementasikan sendiri untuk mendapatkan PlayAuth baru dari server aplikasi.
        // clinetGetPlayAuthFunction adalah contoh nama fungsi. Ganti dengan implementasi Anda sendiri.
        clinetGetPlayAuthFunction(vid, new PlayAuthCallback() {
            
            /**
             * Callback untuk berhasil mendapatkan kredensial baru.
             * @param newPlayAuth String kredensial pemutaran baru yang diperoleh dari server Anda.
             */
            @Override
            public void onAuthSuccess(String newPlayAuth) {                
                // 1. Perbarui objek vidAuth lama dengan PlayAuth baru.
                vidAuth.setPlayAuth(newPlayAuth);
                
                // 2. Berikan kembali objek yang diperbarui ke player melalui callback SDK.
                sourceRefreshCallback.onSuccess(vidAuth);
            }

            /**
             * Callback untuk gagal mendapatkan kredensial baru.
             * @param errorMessage Pesan kesalahan detail.
             */
            @Override
            public void onAuthError(String errorMessage) {                
                // Berikan pesan kesalahan kembali ke player melalui callback SDK.
                sourceRefreshCallback.onError(errorMessage);
            }
        });
        // ------------------- Akhir implementasi pengguna -------------------
    }
});

/**
 * Mengatur listener untuk event kedaluwarsa sumber URL.
 *
 * Fitur ini memungkinkan penyegaran URL untuk menghindari gangguan pemutaran yang disebabkan oleh
 * kedaluwarsa URL karena autentikasi. Saat listener dipicu,
 * Anda dapat menyegarkan sumber URL dan mengembalikan sumber URL yang diperbarui menggunakan {@link SourceRefreshCallback#onSuccess}.
 *
 * @param listener Listener untuk menangani event kedaluwarsa sumber URL. Lihat {@link OnURLSourceExpiredListener}.
 *
 * <p>Untuk informasi selengkapnya tentang mengonfigurasi autentikasi URL, lihat
 * <a href="https://www.alibabacloud.com/help/id/vod/user-guide/configure-url-signing">dokumentasi autentikasi URL</a>.</p>
 */
abstract public void setOnURLSourceExpiredListener(OnURLSourceExpiredListener listener);

/**
 * Antarmuka callback untuk menangani hasil penyegaran sumber pemutaran.
 *
 * Antarmuka ini berlaku untuk jenis sumber pemutaran yang memerlukan pembaruan dinamis,
 * seperti sumber URL atau sumber VidAuth. Saat player memicu permintaan penyegaran,
 * hasil penyegaran dapat dikembalikan melalui antarmuka ini dengan memanggil metode `onSuccess` atau `onError`.
 */
public interface SourceRefreshCallback<T extends SourceBase> {
    /**
     * Dipanggil oleh player saat operasi penyegaran berhasil.
     *
     * @param newSource Objek sumber pemutaran baru yang berisi informasi yang diperbarui. Lihat {@link SourceBase}.
     *
     * Metode ini menunjukkan bahwa operasi penyegaran berhasil diselesaikan. Developer harus menyediakan
     * sumber pemutaran baru dalam metode ini agar player dapat memuat resource terbaru.
     */
    void onSuccess(T newSource);

    /**
     * Dipanggil oleh player saat operasi penyegaran gagal.
     *
     * @param errorMsg String yang menjelaskan alasan kegagalan.
     *
     * Metode ini menunjukkan bahwa operasi penyegaran gagal. Developer dapat menggunakan `errorMsg`
     * untuk menangkap detail kegagalan dan melanjutkan penanganan berikutnya.
     */
    void onError(String errorMsg);
}

/**
 * Listener untuk notifikasi kedaluwarsa sumber URL.
 * Ini membantu memproses sumber yang kedaluwarsa dan mencegah gangguan pemutaran.
 */
public interface OnURLSourceExpiredListener {

    /**
     * Dipanggil saat player mendeteksi bahwa sumber URL (UrlSource) telah kedaluwarsa.
     *
     * Anda dapat menyegarkan sumber URL dalam callback ini dan mengembalikan UrlSource baru
     * menggunakan {@link SourceRefreshCallback#onSuccess}.
     *
     * @param expiredSource Objek UrlSource yang kedaluwarsa. Lihat {@link UrlSource}.
     * @param callback Callback penyegaran yang digunakan untuk mengembalikan UrlSource yang diperbarui ke player. Lihat {@link SourceRefreshCallback}.
     */
    void onUrlSourceExpired(UrlSource expiredSource, SourceRefreshCallback<UrlSource> callback);
}

// Atur listener kedaluwarsa URL player.
mAliyunVodPlayer.setOnURLSourceExpiredListener(new UrlPlayer.OnURLSourceExpiredListener() {
    @Override
    public void onUrlSourceExpired(UrlSource urlSource, UrlPlayer.SourceRefreshCallback<UrlSource> sourceRefreshCallback) {
        String expiredUrl = urlSource.getUri();
        Log.d(TAG, "[onUrlSourceExpired] Menerima URL yang kedaluwarsa: " + expiredUrl);

        // 1. Periksa apakah kunci autentikasi valid (dengan asumsi authenticationKey adalah variabel anggota kelas).
        if (authenticationKey == null || authenticationKey.trim().isEmpty()) {
            Log.e(TAG, "Penyegaran gagal: Kunci autentikasi kosong.");
            sourceRefreshCallback.onError("REFRESH_ERROR: Kunci autentikasi tidak ada.");
            return; // Kunci tidak valid, keluar lebih awal.
        }

        // 2. Hitung periode timeout (validitas) untuk alamat pemutaran.
        // Jika variabel anggota validTime valid, gunakan; jika tidak, default ke 3600 detik (1 jam).
        long validityDuration = (AliyunVodPlayerView.this.validTime > 0) ? validTime : 3600;
        long newExpireTime = (System.currentTimeMillis() / 1000) + validityDuration;

        // 3. Ekstrak URL asli dari URL yang kedaluwarsa (menggunakan penandatanganan Jenis A sebagai contoh).
        // Pulihkan alamat resource asli dengan menghapus bagian parameter URL (seperti "?auth_key=").
        int authKeyIndex = expiredUrl.indexOf("?auth_key=");
        if (authKeyIndex == -1) {
            authKeyIndex = expiredUrl.indexOf("&auth_key=");
        }
        // Pastikan penanganan aman bahkan jika auth_key tidak ditemukan.
        String originalUrl = (authKeyIndex != -1) ? expiredUrl.substring(0, authKeyIndex) : expiredUrl;

        // 4. Gunakan kelas utilitas untuk menghasilkan URL bertanda tangan baru.
        String newAuthUrl = CdnAuthUtil.aAuth(originalUrl, authenticationKey, newExpireTime);

        // 5. Periksa URL bertanda tangan yang dihasilkan dan kembalikan hasil melalui callback.
        if (newAuthUrl != null && !newAuthUrl.isEmpty()) {
            Log.i(TAG, "Penyegaran berhasil, URL baru: " + newAuthUrl);
            // Seperti yang dipersyaratkan oleh SDK, buat objek UrlSource dan atur URL baru.
            UrlSource resultSource = new UrlSource();
            resultSource.setUri(newAuthUrl);
            sourceRefreshCallback.onSuccess(resultSource);
        } else {
            Log.e(TAG, "Penyegaran gagal: Gagal menghasilkan URL berotorisasi baru.");
            sourceRefreshCallback.onError("REFRESH_ERROR: Gagal menghasilkan URL baru.");
        }
    }
});

Fungsi utilitas tambahan

Contoh berikut menggunakan penandatanganan Jenis A.

// Fungsi untuk menghasilkan URL bertanda tangan.
private String generateAuthUrl(String uri, String key, long exp) {
    Pattern uriPattern = Pattern.compile("^(https?://)?([^/?]+)(/[^?]*)?(\\?.*)?$");
    Matcher m = uriPattern.matcher(uri);

    if (!m.matches()) {
        return null;
    }

    String scheme = (m.group(1) != null) ? m.group(1) : "http://";
    String host = m.group(2);
    String path = (m.group(3) != null) ? m.group(3) : "/";
    String args = (m.group(4) != null) ? m.group(4) : "";

    String rand = "0";
    String uid = "0";

    String sstring = String.format("%s-%d-%s-%s-%s", path, exp, rand, uid, key);
    String hashvalue = md5sum(sstring);
    String authKey = String.format("%d-%s-%s-%s", exp, rand, uid, hashvalue);

    if (!args.isEmpty()) {
        return String.format("%s%s%s%s&auth_key=%s", scheme, host, path, args, authKey);
    } else {
        return String.format("%s%s%s%s?auth_key=%s", scheme, host, path, args, authKey);
    }
}

// Fungsi utilitas untuk menghitung MD5.
private String md5sum(String src) {
    try {
        MessageDigest md = MessageDigest.getInstance("MD5");
        md.update(src.getBytes(StandardCharsets.UTF_8));
        byte[] digest = md.digest();

        StringBuilder hexString = new StringBuilder();
        for (byte b : digest) {
            hexString.append(String.format("%02x", b));
        }
        return hexString.toString();
    } catch (NoSuchAlgorithmException e) {
        throw new RuntimeException("Algoritma MD5 tidak ditemukan", e);
    }
}

ApsaraVideo Player SDK untuk Android mendukung rendering frame pertama dengan cepat sebelum pemutaran dimulai, yang dapat meningkatkan kecepatan startup.

Kode berikut merupakan contohnya:

aliPlayer.setOption(ALLOW_PRE_RENDER, 1);

ApsaraVideo Player SDK untuk Android menyediakan fitur cache lokal. Fitur ini meningkatkan kecepatan startup, kecepatan pencarian, dan mengurangi tersendat saat pengguna memutar ulang video, sekaligus menghemat trafik.

Enable local cache

// Aktifkan cache lokal (jalur default).
AliPlayerGlobalSettings.enableLocalCache(true, this);

/**
 *  Anda juga dapat menggunakan kode di bawah ini untuk mengatur cache.
 *  Aktifkan cache lokal. Setelah diaktifkan, akan di-cache ke file lokal.
 *  @param enable: Sakelar fitur cache lokal. true: aktifkan, false: nonaktifkan. Default adalah nonaktifkan.
 *  @param maxBufferMemoryKB: Ditinggalkan di V5.4.7.1 dan versi lebih baru, tidak lagi berpengaruh.
 *  @param localCacheDir: Harus diatur. Direktori untuk file cache lokal, harus berupa jalur mutlak.
 *  AliPlayerGlobalSettings.enableLocalCache(enable, maxBufferMemoryKB, localCacheDir);
 */

/**
 * Konfigurasi untuk membersihkan file cache lokal.
 * @param expireMin - Ditinggalkan di V5.4.7.1 dan versi lebih baru, tidak lagi berpengaruh.
 * @param maxCapacityMB - Kapasitas cache maksimum dalam MB. Default adalah 20 GB. Selama pembersihan, jika ukuran total cache melebihi batas ini, file cache tertua akan dihapus satu per satu, diurutkan berdasarkan waktu akses terakhir, hingga ukuran total kurang dari atau sama dengan kapasitas maksimum.
 * @param freeStorageMB - Ruang disk bebas minimum dalam MB. Default adalah 0. Selama pembersihan, mirip dengan maxCapacityMB, jika ruang disk saat ini kurang dari nilai ini, file cache akan dihapus satu per satu sesuai aturan hingga ruang bebas lebih besar dari atau sama dengan nilai ini atau semua cache dihapus.
 * public static void setCacheFileClearConfig(long expireMin,
 *         long maxCapacityMB,
 *         long freeStorageMB)
 */

 /**
  * Atur callback untuk nilai hash URL yang dimuat. Jika tidak diatur, SDK menggunakan algoritma MD5.
  * public static void setCacheUrlHashCallback(AliPlayerGlobalSettings.OnGetUrlHashCallback cb)
  */

Enable or disable local cache for a single URL

// Pertama, dapatkan konfigurasi.
PlayerConfig config = aliPlayer.getConfig();
// Apakah akan mengaktifkan cache lokal untuk URL pemutaran. Nilai default adalah true. Saat cache lokal di AliPlayerGlobalSettings diaktifkan, dan cache lokal di sini juga diaktifkan (diatur ke true), cache lokal untuk URL ini akan berlaku. Jika diatur ke false di sini, cache lokal untuk URL ini dinonaktifkan.
config.mEnableLocalCache = false;
....// Pengaturan lainnya

// Atur konfigurasi untuk player.
aliPlayer.setConfig(config);

ApsaraVideo Player SDK untuk Android menyediakan fitur preload, yang merupakan peningkatan dari fitur cache lokal. Dengan mengatur ukuran memori untuk caching video, Anda dapat lebih lanjut meningkatkan kecepatan startup video.

AliPlayerGlobalSettings.enableNetworkBalance(false);

1. Aktifkan fitur cache lokal. Untuk informasi selengkapnya, lihat Cache lokal.

2. Atur sumber data.

   VidAuth (disarankan)

   VidAuth vidAuth = new VidAuth();
   vidAuth.setVid("Informasi Vid"); // Wajib. ID video (VideoId).
   vidAuth.setPlayAuth("<yourPlayAuth>"); // Wajib. Kredensial pemutaran, yang perlu dihasilkan dengan memanggil operasi API GetVideoPlayAuth ApsaraVideo VOD.
   vidAuth.setRegion("Wilayah akses"); // Untuk SDK player V5.5.5.0 dan versi lebih baru, parameter ini ditinggalkan. Anda tidak perlu mengatur wilayah, karena player akan menguraikannya secara otomatis. Untuk versi SDK player sebelum 5.5.5.0, parameter ini wajib. Ini adalah wilayah akses ApsaraVideo VOD, yang default-nya cn-shanghai.
   vidAuth.setQuality("Definisi yang dipilih") // "AUTO" merepresentasikan bitrate adaptif.

   VidSts

   VidSts vidSts = new VidSts();
   vidSts.setVid("Informasi Vid"); // Wajib. ID video (VideoId).
   vidSts.setAccessKeyId("<yourAccessKeyId>"); // Wajib. ID AccessKey token STS sementara, yang perlu dihasilkan dengan memanggil operasi API AssumeRole STS.
   vidSts.setAccessKeySecret("<yourAccessKeySecret>"); // Wajib. Rahasia AccessKey token STS sementara, yang perlu dihasilkan dengan memanggil operasi API AssumeRole STS.
   vidSts.setSecurityToken("<yourSecurityToken>"); // Wajib. Token keamanan STS, yang perlu dihasilkan dengan memanggil operasi API AssumeRole STS.
   vidSts.setRegion("Wilayah akses"); // Wajib. Wilayah akses ApsaraVideo VOD, yang default-nya cn-shanghai.
   vidSts.setQuality("Definisi yang dipilih") // "AUTO" merepresentasikan bitrate adaptif.

   UrlSource

   UrlSource urlSource = new UrlSource();
   urlSource.setUri("URL Pemutaran"); // Wajib. URL pemutaran, yang dapat berupa URL VOD pihak ketiga atau URL pemutaran di ApsaraVideo VOD.

3. Atur parameter tugas.

   Catatan

   Ini hanya berlaku untuk video multi-bitrate. Anda dapat memilih salah satu dari setDefaultBandWidth, setDefaultResolution, atau setDefaultQuality.

   PreloadConfig preloadConfig = new PreloadConfig();
   // Atur bitrate preload untuk aliran multi-bitrate.
   preloadConfig.setDefaultBandWidth(400000);
   // Atur resolusi preload untuk aliran multi-bitrate.
   preloadConfig.setDefaultResolution(640 * 480);
   // Atur kualitas preload untuk aliran multi-bitrate.
   preloadConfig.setDefaultQuality(“FD”);
   // Atur durasi preload.
   preloadConfig.setDuration(1000);

4. Tambahkan listener tugas.

   Klik untuk melihat kode

   /**
    * Implementasi listener preload
    */
   private static class PreloadListenerImpl extends OnPreloadListener {
   
       @Override
       public void onError(@NonNull String taskId, @NonNull String urlOrVid, @NonNull ErrorInfo errorInfo) {
           // Kesalahan pemuatan.
       }
   
       @Override
       public void onCompleted(@NonNull String taskId, @NonNull String urlOrVid) {
           // Pemuatan selesai.
       }
   
       @Override
       public void onCanceled(@NonNull String taskId, @NonNull String urlOrVid) {
          // Pemuatan dibatalkan.
       }
   }

5. Buat tugas dan tambahkan ke instance MediaLoaderV2 untuk memulai preloading.

   VidAuth (disarankan)

   // Buat tugas preload.
   PreloadTask mPreloadTask = new PreloadTask(vidAuth, preloadConfig);
   // Dapatkan instance MediaLoaderV2.
   MediaLoaderV2 mediaLoaderV2 = MediaLoaderV2.getInstance();
   // Tambahkan tugas dan mulai preloading.
   String taskId = mediaLoaderV2.addTask(mPreloadTask, PreloadListenerImpl)

   VidSts

   // Buat tugas preload.
   PreloadTask mPreloadTask = new PreloadTask(vidSts, preloadConfig);
   // Dapatkan instance MediaLoaderV2.
   MediaLoaderV2 mediaLoaderV2 = MediaLoaderV2.getInstance();
   // Tambahkan tugas dan mulai preloading.
   String taskId = mediaLoaderV2.addTask(mPreloadTask, PreloadListenerImpl);

   UrlSource

   // Buat tugas preload.
   PreloadTask mPreloadTask = new PreloadTask(urlSource, preloadConfig);
   // Dapatkan instance MediaLoaderV2.
   MediaLoaderV2 mediaLoaderV2 = MediaLoaderV2.getInstance();
   // Tambahkan tugas dan mulai preloading.
   String taskId = mediaLoaderV2.addTask(mPreloadTask, PreloadListenerImpl)

6. Opsional: Kelola tugas.

   mediaLoaderV2.cancelTask(taskId); // Batalkan tugas preload dengan ID tugas tertentu.
   mediaLoaderV2.pauseTask(taskId); // Jeda tugas preload dengan ID tugas tertentu.
   mediaLoaderV2.resumeTask(taskId); // Lanjutkan tugas preload dengan ID tugas tertentu.

7. Opsional: Hapus file yang dimuat.

   Anda dapat menghapus file yang dimuat sesuai kebutuhan untuk menghemat ruang. ApsaraVideo Player SDK untuk Android tidak menyediakan antarmuka penghapusan. Anda perlu menghapus file di direktori pemuatan aplikasi.

Strategi preload dinamis memungkinkan integrator mengontrol cache video yang sedang diputar dan jumlah serta cache item yang dipre-load. Hal ini membantu bisnis menyeimbangkan pengalaman pemutaran dengan biaya.

// Aktifkan konfigurasi yang direkomendasikan dan preload dinamis.
aliListPlayer.setPreloadScene(IListPlayer.SceneType.SCENE_SHORT);

// Konfigurasikan durasi preload dasar.
// Atur durasi preload menjadi 1000ms.
PreloadConfig config = new PreloadConfig();
config.mPreloadDuration = 1000;
aliListPlayer.updatePreloadConfig(config);

// Konfigurasikan jumlah item yang akan dipre-load, mendukung kedua arah.
// 1 adalah jumlah item yang akan dipre-load mundur, 3 adalah jumlah yang akan dipre-load maju.
aliListPlayer.setPreloadCount(1, 3);

// Konfigurasikan offset penurunan untuk preload dinamis.
aliListPlayer.enablePreloadStrategy(IListPlayer.StrategyType.STRATEGY_DYNAMIC_PRELOAD_DURATION, true);
aliListPlayer.setPreloadStrategy(IListPlayer.StrategyType.STRATEGY_DYNAMIC_PRELOAD_DURATION, "{\"algorithm\": \"sub\",\"offset\": \"200\"}");

Preload video HLS multi-bitrate

Dalam skenario pemutaran video HLS multi-bitrate listPlayer, integrator dapat mempre-load aliran dengan definisi yang sama dengan video yang sedang diputar. Mereka juga dapat memilih mode preload berdasarkan kebutuhan bisnis mereka.

  /**
   * Mode default, memutar dan mempre-load bitrate default aliran.
   */
  MultiBitratesMode_Default(0),

  /**
   * Prioritas biaya frame pertama (FC), mengurangi biaya frame pertama. Hanya memutar bitrate aliran HLS yang telah dipre-load.
   */
  MultiBitratesMode_FCPrio(1),

  /**
   * Menyeimbangkan frame pertama dan kelancaran pemutaran. Bitrate video konsisten sebelum dan sesudah beralih (moveToNext), dan performa frame pertama juga dipertimbangkan.
   */
  MultiBitratesMode_FC_AND_SMOOTH(2),

  /**
   * Prioritas kelancaran pemutaran. Video mulai diputar pada bitrate video sebelumnya secara default.
   */
  MultiBitratesMode_SmoothPrio(3);

// Pilih mode pemuatan multi-bitrate.
aliListPlayer.SetMultiBitratesMode(preLoadMode);


// (Opsional) Pilih bitrate startup.
aliListPlayer.setDefaultBandWidth(defaultBandWidth)


// (Opsional) Dalam callback onPrepared, pilih mode ABR.
aliListPlayer.setOnPreparedListener(new IPlayer.OnPreparedListener() {
    @Override
    public void onPrepared() {
        // ABR hanya memengaruhi m3u8 multi-bitrate.
        aliListPlayer.selectTrack(-1);
    }
});

HTTPDNS

// Aktifkan HTTPDNS yang ditingkatkan.
AliPlayerGlobalSettings.enableEnhancedHttpDns(true);
// Opsional: Tambahkan nama domain untuk pra-resolusi HTTPDNS.
DomainProcessor.getInstance().addPreResolveDomain("player.***alicdn.com");

HTTP/2

AliPlayerGlobalSettings.setUseHttp2(true);

Pra-buat koneksi TCP untuk HTTP

Untuk permintaan pemutaran video HTTP (bukan HTTPS), pra-membuat koneksi TCP secara signifikan dapat meningkatkan pengalaman pengguna, mengurangi waktu koneksi jaringan, memastikan pemutaran segera dan berkelanjutan, serta mengoptimalkan penggunaan sumber daya jaringan dan sistem. Penggunaannya adalah sebagai berikut:

// Format domain adalah host[:port], di mana port bersifat opsional. Gunakan titik koma (;) untuk memisahkan beberapa nama domain.
// Pengaturan global
// Antarmuka lengkap menggunakan string saat ini sebagai standar untuk setiap pengaturan (lebih - tambah, kurang - hapus). String kosong menghentikan pra-koneksi.
AliPlayerGlobalSettings.setOption(AliPlayerGlobalSettings.SET_PRE_CONNECT_DOMAIN, "domain1;domain2");

ApsaraVideo Player SDK untuk Android menyediakan fitur unduhan video untuk ApsaraVideo VOD. Fitur ini memungkinkan pengguna menyimpan video secara lokal untuk ditonton offline menggunakan ApsaraVideo Player. Fitur ini juga menawarkan dua metode unduhan: unduhan normal dan unduhan aman.

• Unduhan normal

  Data video yang diunduh tidak dienkripsi oleh Alibaba Cloud. Pengguna dapat memutarnya dengan player pihak ketiga.

• Unduhan aman

  Data video yang diunduh dienkripsi oleh Alibaba Cloud. Player pihak ketiga tidak dapat memutarnya. Video hanya dapat diputar menggunakan ApsaraVideo Player.

Petunjuk

• Fitur unduhan video hanya didukung untuk metode VidSts dan VidAuth.

• Untuk menggunakan fitur unduhan video player, Anda perlu mengaktifkan dan mengonfigurasi mode unduhan di konsol ApsaraVideo VOD. Untuk informasi selengkapnya, lihat Unduhan offline.

• Unduhan video mendukung unduhan yang dapat dilanjutkan.

Prosedur

1. Opsional: Konfigurasikan file enkripsi untuk unduhan aman. Ini hanya diperlukan untuk unduhan aman, bukan untuk unduhan normal.

   Catatan

   Pastikan file enkripsi yang dikonfigurasi konsisten dengan informasi aplikasi. Jika tidak, unduhan video gagal.

   Jika Anda mengatur metode unduhan ke unduhan aman, Anda perlu mengonfigurasi SDK player dengan file kunci yang dihasilkan di konsol ApsaraVideo VOD. File ini digunakan untuk dekripsi dan verifikasi selama unduhan dan pemutaran video. Untuk informasi selengkapnya tentang cara menghasilkan file kunci, lihat Aktifkan unduhan aman.

   Kami menyarankan Anda mengonfigurasi ini sekali di kelas Application. Kode berikut merupakan contohnya:

   // Kami menyarankan menyimpan file encryptedApp.dat di ponsel dan kemudian mengatur jalur file lokal file enkripsi di sini.
   PrivateService.initService(getApplicationContext(),  "Jalur file tempat encryptedApp.dat berada");

2. Buat dan siapkan downloader.

   Anda dapat membuat downloader menggunakan AliDownloaderFactory. Kode berikut merupakan contohnya:

   AliMediaDownloader mAliDownloader = null;
   ......
   // Buat downloader.
   mAliDownloader = AliDownloaderFactory.create(getApplicationContext());
   // Konfigurasikan jalur penyimpanan untuk unduhan.
   mAliDownloader.setSaveDir("Alamat folder penyimpanan");

3. Atur listener.

   Downloader menyediakan beberapa listener event. Kode berikut merupakan contohnya:

   Klik untuk melihat kode

   mAliDownloader.setOnPreparedListener(new AliMediaDownloader.OnPreparedListener() {
      @Override
      public void onPrepared(MediaInfo mediaInfo) {
          // Berhasil menyiapkan item unduhan.
      }
   });
   mAliDownloader.setOnProgressListener(new AliMediaDownloader.OnProgressListener() {
      @Override
      public void onDownloadingProgress(int percent) {
          // Persentase progres unduhan.
      }
      @Override
      public void onProcessingProgress(int percent) {
          // Persentase progres pemrosesan.
      }
   });
   mAliDownloader.setOnErrorListener(new AliMediaDownloader.OnErrorListener() {
      @Override
      public void onError(ErrorInfo errorInfo) {
          // Kesalahan unduhan.
      }
   });
   mAliDownloader.setOnCompletionListener(new AliMediaDownloader.OnCompletionListener() {
      @Override
      public void onCompletion() {
          // Unduhan berhasil.
      }
   });

4. Siapkan sumber unduhan.

   Anda dapat menggunakan metode prepare untuk menyiapkan sumber unduhan. Sumber unduhan mendukung metode VidSts dan VidAuth. Kode berikut merupakan contohnya:

   • VidSts

     // Buat VidSts.
     VidSts aliyunVidSts = new VidSts();
     aliyunVidSts.setVid("Informasi Vid"); // ID video (VideoId).
     aliyunVidSts.setAccessKeyId("<yourAccessKeyId>"); // ID AccessKey token STS sementara, yang perlu dihasilkan dengan memanggil operasi API AssumeRole STS.
     aliyunVidSts.setAccessKeySecret("<yourAccessKeySecret>"); // Rahasia AccessKey token STS sementara, yang perlu dihasilkan dengan memanggil operasi API AssumeRole STS.
     aliyunVidSts.setSecurityToken("<yourSecurityToken>"); // Token keamanan STS, yang perlu dihasilkan dengan memanggil operasi API AssumeRole STS.
     aliyunVidSts.setRegion("Wilayah akses"); // Wilayah akses ApsaraVideo VOD, yang default-nya cn-shanghai.
      // Jika Anda telah mengaktifkan pass-through parameter enkripsi standar HLS di konsol VOD, dan nama parameter default adalah MtsHlsUriToken, Anda perlu mengatur config dan meneruskannya ke vid, seperti yang ditunjukkan di bawah.
      // Jika Anda belum mengaktifkan pass-through parameter enkripsi standar HLS di konsol VOD, Anda tidak perlu mengintegrasikan kode berikut.
      VidPlayerConfigGen vidConfig = new VidPlayerConfigGen();
      vidConfig.setMtsHlsUriToken("<yourMtsHlsUriToken>");
      aliyunVidSts.setPlayerConfig(config);
             
     
     // Siapkan sumber unduhan.
     mAliDownloader.prepare(aliyunVidSts)

   • VidAuth

     // Buat VidAuth.
     VidAuth vidAuth = new VidAuth();
     vidAuth.setVid("Informasi Vid"); // ID video (VideoId).
     vidAuth.setPlayAuth("<yourPlayAuth>"); // Kredensial pemutaran, yang perlu dihasilkan dengan memanggil operasi API GetVideoPlayAuth ApsaraVideo VOD.
     vidAuth.setRegion("Wilayah akses"); // Untuk SDK player V5.5.5.0 dan versi lebih baru, parameter ini ditinggalkan. Anda tidak perlu mengatur wilayah, karena player akan menguraikannya secara otomatis. Untuk versi SDK player sebelum 5.5.5.0, parameter ini wajib. Ini adalah wilayah akses ApsaraVideo VOD, yang default-nya cn-shanghai.
     // Jika Anda telah mengaktifkan pass-through parameter enkripsi standar HLS di konsol VOD, dan nama parameter default adalah MtsHlsUriToken, Anda perlu mengatur config dan meneruskannya ke vid, seperti yang ditunjukkan di bawah.
     VidPlayerConfigGen vidConfig = new VidPlayerConfigGen();
     vidConfig.setMtsHlsUriToken("<yourMtsHlsUriToken>");
     vidAuth.setPlayerConfig(config);
     // Siapkan sumber unduhan.
     mAliDownloader.prepare(vidAuth);

   Catatan

   • Format file sumber dan format file unduhan output sama dan tidak dapat diubah.

   • Jika Anda mengaktifkan pass-through parameter enkripsi standar HLS di konsol VOD, nama parameter default adalah MtsHIsUriToken. Untuk informasi selengkapnya, lihat Pass-through parameter enkripsi standar HLS. Dalam kasus ini, Anda harus mengatur nilai MtsHIsUriToken dalam sumber VOD seperti yang ditunjukkan dalam kode di atas.

5. Setelah persiapan berhasil, pilih item unduhan dan mulai unduhan.

   Setelah persiapan berhasil, metode OnPreparedListener dipanggil kembali. Objek TrackInfo yang dikembalikan berisi informasi seperti definisi setiap aliran video. Anda dapat memilih Track untuk diunduh. Kode berikut merupakan contohnya:

   public void onPrepared(MediaInfo mediaInfo) {
       // Berhasil menyiapkan item unduhan.
       List<TrackInfo> trackInfos = mediaInfo.getTrackInfos();
       // Misalnya, unduh TrackInfo pertama.
       mAliDownloader.selectItem(trackInfos.get(0).getIndex());
       // Mulai unduhan.
       mAliDownloader.start();
   }

6. (Opsional) Perbarui sumber unduhan.

   Untuk mencegah VidSts dan VidAuth kedaluwarsa, Anda juga dapat memperbarui informasi sumber unduhan sebelum memulai unduhan. Kode berikut merupakan contohnya:

   // Perbarui sumber unduhan.
   mAliDownloader.updateSource(VidSts);
   // Mulai unduhan.
   mAliDownloader.start();

7. Setelah unduhan berhasil atau gagal, lepaskan downloader.

   Setelah unduhan selesai, Anda dapat memanggil release dalam callback onCompletion atau onError untuk melepaskan downloader. Kode berikut merupakan contohnya:

   mAliDownloader.stop();
   mAliDownloader.release();

8. Opsional: Hapus file yang diunduh.

   Selama atau setelah unduhan, Anda dapat menghapus file yang diunduh. Kode berikut merupakan contohnya:

   // Hapus file melalui objek.
   mAliDownloader.deleteFile();
   // Hapus melalui metode statis. Jika berhasil, mengembalikan 0.
   AliDownloaderFactory.deleteFile("Jalur folder unduhan yang akan dihapus", "ID Video", "Format Video", "Indeks video yang diunduh");

Langkah selanjutnya

Video yang diunduh dapat diputar menggunakan ApsaraVideo Player. Metodenya adalah sebagai berikut:

1. Setelah unduhan selesai, dapatkan jalur mutlak file video.

   String path = mAliDownloader.getFilePath();

2. Atur jalur absolut untuk pemutaran menggunakan metode UrlSource.

    UrlSource urlSource = new UrlSource();
           urlSource.setUri("URL Pemutaran"); // Atur jalur absolut video yang diunduh.
           aliPlayer.setDataSource(urlSource);