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-------------
// Tetapkan View 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-----------
// Tetapkan mode alpha
aliPlayer.setAlphaRenderMode(IPlayer.AlphaRenderMode.RENDER_MODE_ALPHA_AT_RIGHT);
// Tetapkan 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: Bersihkan layar jika terjadi masalah koneksi setelah pemutaran instans tunggal selesai.
        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.

Contoh:

1. Buat view untuk menampilkan subtitle.

   Buat tampilan berbeda berdasarkan format subtitle.

   Klik untuk melihat kode

   // Digunakan untuk menampilkan subtitle SRT dan VTT
   SubtitleView subtitleView = new SubtitleView(getContext());
   // Untuk player V7.6.0 ke atas, 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 tampilan subtitle ke tampilan layout
   viewGroup.addView(assSubtitleView);

   Jika Anda menggunakan Player SDK V7.6.0 ke atas dan VttSubtitleView untuk menampilkan subtitle SRT dan VTT, Anda harus menetapkan listener berikut:

   // Diperlukan untuk player V7.6.0 ke atas
   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

   Tetapkan file subtitle di onPrepared.

   mAliPlayer.setOnPreparedListener(new IPlayer.OnPreparedListener() {
       @Override
       public void onPrepared() {
           // Pengaturan subtitle (harus ditetapkan 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 ditetapkan, aliran cadangan tersebut diputar secara otomatis. Jika tidak ada aliran cadangan H.264 yang ditetapkan, pemutar 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, kueri URL cadangan 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);// Tetapkan 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: Efektif untuk streaming langsung. Saat delay besar, SDK pemutar melakukan sinkronisasi frame internal untuk menjaga delay dalam rentang ini.
config.mMaxDelayTime = 5000;
// Durasi buffer maksimum dalam ms. Pemutar 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. Waktu yang lebih singkat berarti startup lebih cepat tetapi dapat menyebabkan cepat masuk ke status loading setelah pemutaran dimulai.
config.mStartBufferDuration = 500;
....// Pengaturan lainnya
// Durasi buffer mundur maksimum dalam ms. Default adalah 0.
config.mMaxBackwardBufferDurationMs = 0;

// Tetapkan konfigurasi untuk pemutar
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 PiP, dapat disesuaikan berdasarkan kebutuhan bisnis Anda
   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 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 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();

Tetapkan listener untuk mendapatkan data aliran audio dan video. Fitur ini tidak mendukung aliran terenkripsi karena 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);
// Tetapkan 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

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

Petunjuk penggunaan

// Parameter adalah data heksadesimal 8 digit. 8 digit 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

/**
 * Menetapkan 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 dekode H.266

H.266 (VVC/Versatile Video Coding) adalah standar encoding video generasi berikutnya yang secara signifikan dapat 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 versi 7.6.0 ke atas.

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

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

Integrasikan plugin

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

// x.x.x harus sesuai 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 refresh 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, memastikan pemutaran video yang berkelanjutan dan lancar.

Prasyarat

1. ApsaraVideo Player SDK atau All-in-One SDK versi 7.9.0 ke atas.

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 pemutar mendeteksi bahwa sumber VidAuth telah kedaluwarsa.
     * Kedaluwarsa sumber VidAuth mencakup kedaluwarsa PlayAuth dan kedaluwarsa alamat pemutaran.
     *
     * Anda dapat merefresh 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 pemutar. Lihat {@link SourceRefreshCallback}.
     */
    void onVidAuthExpired(VidAuth expiredSource, SourceRefreshCallback<VidAuth> callback);
}

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

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

// Tetapkan 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();

        // ------------------- Mulai 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 pemutar 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 pemutar melalui callback SDK
                sourceRefreshCallback.onError(errorMessage);
            }
        });
        // ------------------- Akhir implementasi pengguna -------------------
    }
});

/**
 * Menetapkan listener untuk event kedaluwarsa sumber URL.
 *
 * Fitur ini memungkinkan refresh URL untuk menghindari gangguan pemutaran yang disebabkan oleh
 * kedaluwarsa URL karena autentikasi. Saat listener dipicu,
 * Anda dapat merefresh 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 konfigurasi autentikasi URL, lihat
 * <a href="https://www.alibabacloud.com/help/zh/vod/user-guide/configure-url-signing?spm=a2c4g.11186623.0.0.560c4140fGh8MW">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);
}

// Tetapkan listener kedaluwarsa URL pemutar
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, "Refresh 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, "Refresh berhasil, URL baru: " + newAuthUrl);
            // Seperti yang dipersyaratkan oleh SDK, buat objek UrlSource dan tetapkan URL baru
            UrlSource resultSource = new UrlSource();
            resultSource.setUri(newAuthUrl);
            sourceRefreshCallback.onSuccess(resultSource);
        } else {
            Log.e(TAG, "Refresh 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.

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.

Aktifkan cache lokal

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

/**
 *  Anda juga dapat menggunakan kode di bawah ini untuk menyetel 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: Tidak berlaku lagi di V5.4.7.1 ke atas, tidak lagi berpengaruh.
 *  @param localCacheDir: Harus ditetapkan. Direktori untuk file cache lokal, harus berupa jalur mutlak.
 *  AliPlayerGlobalSettings.enableLocalCache(enable, maxBufferMemoryKB, localCacheDir);
 */

/**
 * Konfigurasi untuk membersihkan file cache lokal.
 * @param expireMin - Tidak berlaku lagi di V5.4.7.1 ke atas, tidak lagi berpengaruh.
 * @param maxCapacityMB - Kapasitas cache maksimum dalam MB. Default adalah 20 GB. Selama pembersihan, jika total ukuran 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)
 */

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

Aktifkan atau nonaktifkan cache lokal untuk URL tunggal

// 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 (ditetapkan ke true), cache lokal untuk URL ini akan berlaku. Jika ditetapkan ke false di sini, cache lokal untuk URL ini dinonaktifkan.
config.mEnableLocalCache = false;
....// Pengaturan lainnya

// Tetapkan konfigurasi untuk pemutar
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("<kredensialPlayAuthAnda>");// Wajib. Kredensial pemutaran, yang perlu dihasilkan dengan memanggil operasi API GetVideoPlayAuth ApsaraVideo VOD.
   vidAuth.setRegion("Wilayah akses");// Untuk SDK pemutar V5.5.5.0 ke atas, parameter ini tidak berlaku lagi. Anda tidak perlu menyetel wilayah, karena pemutar akan mengurai secara otomatis. Untuk versi SDK pemutar sebelum 5.5.5.0, parameter ini wajib. Ini adalah wilayah akses ApsaraVideo VOD, default ke 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("<AccessKeyIdAnda>");// Wajib. ID AccessKey token STS sementara, yang perlu dihasilkan dengan memanggil operasi API AssumeRole STS.  vidSts.setAccessKeySecret("<AccessKeySecretAnda>");// Wajib. Rahasia AccessKey token STS sementara, yang perlu dihasilkan dengan memanggil operasi API AssumeRole STS.  vidSts.setSecurityToken("<tokenKeamananAnda>");// Wajib. Token keamanan STS, yang perlu dihasilkan dengan memanggil operasi API AssumeRole STS.  vidSts.setRegion("Wilayah akses");// Wajib. Wilayah akses ApsaraVideo VOD, default ke 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();
   // Tetapkan bitrate preload untuk aliran multi-bitrate
   preloadConfig.setDefaultBandWidth(400000);
   // Tetapkan resolusi preload untuk aliran multi-bitrate
   preloadConfig.setDefaultResolution(640 * 480);
   // Tetapkan kualitas preload untuk aliran multi-bitrate
   preloadConfig.setDefaultQuality(“FD”);
   // Tetapkan 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 instans MediaLoaderV2
   MediaLoaderV2 mediaLoaderV2 = MediaLoaderV2.getInstance();
   // Tambahkan tugas dan mulai preload
   String taskId = mediaLoaderV2.addTask(mPreloadTask, PreloadListenerImpl)

   VidSts

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

   UrlSource

   // Buat tugas preload
   PreloadTask mPreloadTask = new PreloadTask(urlSource, preloadConfig);
   // Dapatkan instans MediaLoaderV2
   MediaLoaderV2 mediaLoaderV2 = MediaLoaderV2.getInstance();
   // Tambahkan tugas dan mulai preload
   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.
// Tetapkan durasi preload ke 1000 ms.
PreloadConfig config = new PreloadConfig();
config.mPreloadDuration = 1000;
aliListPlayer.updatePreloadConfig(config);

// Konfigurasikan jumlah item untuk preload dua arah.
// Preload 1 item ke depan dan 3 item ke belakang.
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 biaya frame pertama dan kelancaran pemutaran. Bitrate video konsisten sebelum dan sesudah switching (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 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:

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

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 objek VidSts.
     VidSts aliyunVidSts = new VidSts();
     aliyunVidSts.setVid("id_video_anda"); // ID video.
     aliyunVidSts.setAccessKeyId("<AccessKeyIdAnda>"); // ID AccessKey token STS sementara. Untuk mendapatkan token, Anda harus memanggil operasi AssumeRole STS.
     aliyunVidSts.setAccessKeySecret("<AccessKeySecretAnda>"); // Rahasia AccessKey token STS sementara. Untuk mendapatkan token, Anda harus memanggil operasi AssumeRole STS.
     aliyunVidSts.setSecurityToken("<tokenKeamananAnda>"); // Token keamanan. Untuk mendapatkan token, Anda harus memanggil operasi AssumeRole STS.
     aliyunVidSts.setRegion("id_wilayah_anda"); // ID wilayah tempat VOD diaktifkan. Nilai default: cn-shanghai.
      // Jika Anda mengaktifkan enkripsi HLS dengan parameter pass-through di konsol VOD dan nama parameter default adalah MtsHlsUriToken, Anda harus menyetel parameter config dan meneruskannya ke objek VidSts. Untuk informasi selengkapnya, lihat kode berikut.
      // Jika Anda tidak mengaktifkan enkripsi HLS dengan parameter pass-through di konsol VOD, Anda tidak perlu mengintegrasikan kode berikut.
      VidPlayerConfigGen vidConfig = new VidPlayerConfigGen();
      vidConfig.setMtsHlsUriToken("<MtsHlsUriTokenAnda>");
      aliyunVidSts.setPlayerConfig(vidConfig);
             
     
     // Siapkan sumber unduhan.
     mAliDownloader.prepare(aliyunVidSts);

   • VidAuth

     // Buat objek VidAuth.
     VidAuth vidAuth = new VidAuth();
     vidAuth.setVid("ID Video Anda");// ID video (VideoId).
     vidAuth.setPlayAuth("<kredensialPlayAuthAnda>");// Kredensial pemutaran. Anda harus memanggil operasi GetVideoPlayAuth layanan VOD untuk menghasilkan kredensial.
     vidAuth.setRegion("Wilayah");// Untuk SDK pemutar V5.5.5.0 ke atas, parameter ini tidak berlaku lagi. Anda tidak perlu menyetel wilayah karena pemutar secara otomatis mengurai wilayah. Untuk SDK pemutar sebelum V5.5.5.0, parameter ini wajib. Ini menentukan wilayah tempat layanan VOD diaktifkan. Nilai default adalah cn-shanghai.
     // Jika Anda mengaktifkan pass-through parameter enkripsi HLS di konsol VOD dan nama parameter default adalah MtsHlsUriToken, Anda harus menyetel config dan meneruskannya ke objek VidAuth. Untuk informasi selengkapnya, lihat kode berikut.
     VidPlayerConfigGen vidConfig = new VidPlayerConfigGen();
     vidConfig.setMtsHlsUriToken("<MtsHlsUriTokenAnda>");
     vidAuth.setPlayerConfig(vidConfig);
     // 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. 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");// Tetapkan jalur absolut video yang diunduh
           aliPlayer.setDataSource(urlSource);