ApsaraVideo VOD:Fitur lanjutan

Pemutaran video dengan transparansi

/**
 * Tetapkan mode render alfa.
 *
 * @param alphaRenderMode Mode render alfa yang ditentukan. Lihat {@link AlphaRenderMode}.
 */
abstract public void setAlphaRenderMode(AlphaRenderMode alphaRenderMode);

//--------------Penggunaan View-------------
// Untuk View, transparansi harus ditetapkan.
//TextureView
TextureView aliplayerView; // View yang digunakan untuk pemutaran.
aliplayerView.setOpaque(false);

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

//-----------Penggunaan AliPlayer-----------
// Tetapkan mode alfa.
aliPlayer.setAlphaRenderMode(IPlayer.AlphaRenderMode.RENDER_MODE_ALPHA_AT_RIGHT);
// Tetapkan aset yang sesuai dengan mode alfa.
UrlSource urlSource = new UrlSource();
urlSource.setUri("https://alivc-player.oss-cn-shanghai.aliyuncs.com/video/%E4%B8%9A%E5%8A%A1%E9%9C%80%E6%B1%82%E6%A0%B7%E6%9C%AC/alpha%E9%80%9A%E9%81%93/alpha_right.mp4");
aliPlayer.setDataSource(urlSource);
aliPlayer.setOnCompletionListener(new IPlayer.OnCompletionListener() {
    @Override
    public void onCompletion() {
        // Opsional: Jika terjadi masalah transisi setelah pemutaran instans tunggal selesai, bersihkan layar.
        aliPlayer.clearScreen();
    }
}
aliPlayer.setAutoPlay(true);
aliPlayer.prepare();

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

1. Buat tampilan untuk menampilkan subtitle.

   Buat tampilan berbeda berdasarkan format subtitle.

   Perluas untuk melihat kode

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

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

   // Diperlukan untuk player 7.6.0 dan 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

   Tetapkan file subtitle dalam callback onPrepared.

   mAliPlayer.setOnPreparedListener(new IPlayer.OnPreparedListener() {
       @Override
       public void onPrepared() {
           // Tetapkan subtitle (harus dilakukan dalam onPrepared).
           mAliPlayer.addExtSubtitle(EXT_SUBTITLE_URL);
       }
   });

3. Tetapkan listener terkait subtitle.

   Perluas untuk melihat kode

   mAliPlayer.setOnSubtitleDisplayListener(new IPlayer.OnSubtitleDisplayListener() {
               @Override
               public void onSubtitleExtAdded(int trackIndex, String url) {
                   // trackIndex: indeks subtitle; true: tampilkan subtitle; false: sembunyikan subtitle.
                   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) {
               }
           }
       );

Subtitle eksternal (rendering kustom berdasarkan komponen rendering)

Dukungan penuh untuk subtitle eksternal WebVTT diimplementasikan menggunakan VttSubtitleView dan WebVttResolver, memungkinkan kustomisasi fleksibel ukuran font, warna, dan font tertentu untuk subtitle.

1. Buat CustomStyleWebVttResolver dan implementasikan WebVttResolver.

   public class CustomStyleWebVttResolver extends WebVttResolver {
   
       // Implementasikan metode pembuatan.
       public CustomStyleWebVttResolver(Context context) {
           super(context);
           // Inisialisasi font dan sumber daya lainnya di sini nanti.
       }
   }

2. Override applyTextSpans untuk menyesuaikan gaya.

   Metode ini dipanggil setelah kelas induk mengurai gaya dasar, memungkinkan pemrosesan sekunder subtitle.

   • Metode 1: Modifikasi VttContentAttribute dan panggil metode kelas induk.

     /**
      * Override logika penerapan gaya teks untuk mengimplementasikan efek gaya kustom.
      * Metode ini dipanggil setelah kelas induk mengurai gaya dasar, memungkinkan pemrosesan sekunder ukuran font, warna, dan atribut lainnya.
      *
      * @param spannableStringBuilder Digunakan untuk membangun teks bergaya.
      * @param vttContentAttribute Objek atribut gaya untuk segmen teks saat ini (termasuk font, warna, ukuran, dll.).
      * @param start Posisi awal untuk penerapan gaya (inklusif).
      * @param end Posisi akhir untuk penerapan gaya (eksklusif).
      */
     @Override
     protected void applyTextSpans(SpannableStringBuilder spannableStringBuilder, VttContentAttribute vttContentAttribute, int start, int end) {
         // Tetapkan.
         // Simpan ukuran font asli (dalam px) untuk penyesuaian nanti.
         // Ukuran font default adalah 0,0533f kali tinggi video.
         double originalFontSizePx = vttContentAttribute.fontSizePx;
     
         // Gandakan ukuran font.
         vttContentAttribute.fontSizePx = originalFontSizePx * 2;
         
         // Ubah warna font menjadi merah.
         vttContentAttribute.mPrimaryColour = Color.argb(255, 255, 0, 0);
     
         // Panggil metode kelas induk untuk menerapkan teks.
         super.applyTextSpans(spannableStringBuilder, vttContentAttribute, start, end);
     }

   • Langsung operasikan SpannableStringBuilder untuk memodifikasi gaya WebVTT secara langsung.

     Penting

     Metode ini dapat menyebabkan hilangnya gaya WebVTT asli.

     /**
      * Override logika penerapan gaya teks untuk mengimplementasikan efek gaya kustom.
      * Metode ini dipanggil setelah kelas induk mengurai gaya dasar, memungkinkan pemrosesan sekunder ukuran font, warna, dan atribut lainnya.
      *
      * @param spannableStringBuilder Digunakan untuk membangun teks bergaya.
      * @param vttContentAttribute Objek atribut gaya untuk segmen teks saat ini (termasuk font, warna, ukuran, dll.).
      * @param start Posisi awal untuk penerapan gaya (inklusif).
      * @param end Posisi akhir untuk penerapan gaya (eksklusif).
      */
     @Override
     protected void applyTextSpans(SpannableStringBuilder spannableStringBuilder, VttContentAttribute vttContentAttribute, int start, int end) {
         // Tetapkan warna font.
         spannableStringBuilder.setSpan(
             new ForegroundColorSpan(Color.RED),
             start, end,
             Spanned.SPAN_EXCLUSIVE_EXCLUSIVE
         );
         
         // Tetapkan ukuran absolut.
         spannableStringBuilder.setSpan(
             new AbsoluteSizeSpan(20), // Satuan: px.
             start, end,
             Spanned.SPAN_EXCLUSIVE_EXCLUSIVE
         );
         
         // Tetapkan ukuran relatif.
         // spannableStringBuilder.setSpan(
         //     new RelativeSizeSpan(2.0f), // Kelipatan ukuran font default TextView.
         //     start, end,
         //     Spanned.SPAN_EXCLUSIVE_EXCLUSIVE
         // );
     }

3. Tetapkan font kustom (Typeface).

   1. Muat font kustom dari direktori asset/fonts/.

      private Typeface mTypeface;
      
      public CustomStyleWebVttResolver(Context context) {
          super(context);
          initializeFonts(context);
      }
      
      private void initializeFonts(Context context) {
          try {
              // Muat font dari assets/fonts/.
              mTypeface = Typeface.createFromAsset(context.getAssets(), "fonts/LongCang.ttf");
          } catch (Exception e) {
              Log.e("Font", "Gagal memuat font", e);
              mTypeface = Typeface.DEFAULT; // Cadangan aman.
          }
      }

   2. Terapkan font kustom ke subtitle.

      @Override
      protected void applyTextSpans(SpannableStringBuilder builder, VttContentAttribute attr, int start, int end) {
          // Terapkan font kustom.
          // Harus ditempatkan setelah super.applyTextSpans() untuk mengganti font yang mungkin ditetapkan oleh kelas induk.
          // Memanggil super.applyTextSpans() bersifat opsional.
          if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
              builder.setSpan(new TypefaceSpan(mTypeface), start, end, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
          } else {
              builder.setSpan(new CustomTypefaceSpan(mTypeface), start, end, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
          }
      }

      Kompatibilitas dengan versi Android lama: Karena TypefaceSpan di Android P (API 28) dan sebelumnya tidak mendukung langsung melewatkan objek Typeface, Anda perlu membuat MetricAffectingSpan kustom.

      /**
        * Kelas Typeface Span kustom.
        * Mewarisi dari MetricAffectingSpan untuk menerapkan Typeface dengan benar selama penggambaran dan pengukuran teks.
        * Menyelesaikan masalah di mana TypefaceSpan standar tidak dapat langsung menggunakan objek Typeface.
      */
      private static class CustomTypefaceSpan extends MetricAffectingSpan {
      
          // Font kustom yang akan diterapkan.
          private final Typeface typeface;
      
          /**
            * Konstruktor.
            *
            * @param typeface Objek Typeface yang akan diterapkan (tidak boleh null).
            */
          public CustomTypefaceSpan(Typeface typeface) {
              this.typeface = typeface;
          }
      
          /**
            * Perbarui status penggambaran teks.
            * Dipanggil selama penggambaran teks aktual untuk menetapkan font cat.
            *
            * @param tp Objek TextPaint yang digunakan untuk menggambar teks.
            */
          @Override
          public void updateDrawState(TextPaint tp) {
              tp.setTypeface(typeface);
          }
      
          /**
            * Perbarui status pengukuran teks.
            * Dipanggil selama perhitungan tata letak teks (misalnya, lebar, jeda baris) untuk memastikan pengukuran sesuai dengan penggambaran aktual.
            *
            * @param p Objek TextPaint yang digunakan untuk mengukur teks.
            */
          @Override
          public void updateMeasureState(TextPaint p) {
              p.setTypeface(typeface);
          }
      }

4. Integrasikan dengan pemutar.

   1. Inisialisasi tampilan subtitle.

      // Inisialisasi subtitleView.
      private void initSubtitleView() {
          // Dapatkan konteks.
          Context context = getContext();
      
          // Buat CustomStyleWebVttResolver.
          CustomStyleWebVttResolver mResolver = new CustomStyleWebVttResolver(context);
      
          // Buat VttSubtitleView dan teruskan CustomStyleWebVttResolver.
          VttSubtitleView mVttSubtitleView = new VttSubtitleView(context, mResolver);
      
          // Tambahkan ke wadah video.
          rootView.addView(mVttSubtitleView);
      }

   2. Ikat callback subtitle eksternal.

      // Tetapkan listener subtitle.
      mAliPlayer.setOnSubtitleDisplayListener(new IPlayer.OnSubtitleDisplayListener() {
          @Override
          public void onSubtitleExtAdded(int trackIndex, String url) {
              mAliPlayer.selectExtSubtitle(trackIndex, true);
          }
      
          @Override
          public void onSubtitleShow(int trackIndex, long id, String data) {
              if (mVttSubtitleView != null) {
                  // Tampilkan subtitle.
                  mVttSubtitleView.show(id, data); 
              }
          }
      
          @Override
          public void onSubtitleHide(int trackIndex, long id) {
              // Sembunyikan subtitle.
              mVttSubtitleView.dismiss(id);
          }
      
          @Override
          public void onSubtitleHeader(int i, String header) {
              if (!TextUtils.isEmpty(header)) {
                  // Terapkan gaya header WebVTT.
                  mVttSubtitleView.setVttHeader(header);
              }
          }
      });

Jika perangkat berada dalam daftar hitam decoding perangkat keras H.265 berbasis cloud atau decoding perangkat keras H.265 gagal, degradasi adaptif dipicu: jika ada aliran cadangan H.264, pemutar menggunakannya; jika tidak, pemutar menurunkan ke decoding perangkat lunak H.265.

// Pertahankan Map di lapisan aplikasi untuk menyimpan pasangan kunci-nilai URL asli dan URL cadangan. Saat beralih, kueri URL cadangan dalam 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 "";
        }
    }
});

Dengan mengonfigurasi ApsaraVideo VOD, Android player SDK dapat mengimplementasikan pemutaran pratinjau, mendukung metode pemutaran VidSts dan VidAuth (VidAuth direkomendasikan untuk VOD). Untuk instruksi konfigurasi dan penggunaan, lihat Pratinjau video.

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

Android player SDK menyediakan antarmuka untuk mengontrol cache dan latensi melalui PlayerConfig. Contoh:

// Dapatkan konfigurasi terlebih dahulu.
PlayerConfig config = aliPlayer.getConfig();
// Latensi maksimum. Catatan: Berlaku untuk streaming langsung. Saat latensi besar, SDK pemutar secara internal menyinkronkan frame untuk menjaga latensi dalam rentang ini.
config.mMaxDelayTime = 5000;
// Durasi buffer maksimum, dalam ms. Pemutar memuat hingga durasi data buffer ini setiap kali.
config.mMaxBufferDuration = 50000;
// Durasi buffer tinggi, dalam ms. Saat kondisi jaringan buruk menyebabkan pemuatan data, pemuatan berhenti saat durasi buffer mencapai nilai ini.
config.mHighBufferDuration = 3000;
// Durasi buffer startup, dalam ms. Durasi lebih pendek berarti startup lebih cepat tetapi dapat menyebabkan masuk cepat ke status pemuatan 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

Prosedur:

1. Dalam file AndroidManifest.xml, deklarasikan izin Gambar-dalam-Gambar.

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

2. Alihkan Activity target ke mode Gambar-dalam-Gambar.

   Rational aspectRatio = new Rational(16, 9); // Rasio aspek untuk Gambar-dalam-Gambar; sesuaikan berdasarkan kebutuhan bisnis Anda.
   PictureInPictureParams.Builder pipBuilder = new PictureInPictureParams.Builder();
   pipBuilder.setAspectRatio(aspectRatio);
   enterPictureInPictureMode(pipBuilder.build());

   Anda dapat memicu mode Gambar-dalam-Gambar dari OnClick (event klik), saat meninggalkan aplikasi, atau saat kembali ke aplikasi. Metode implementasi:

   Pemicu OnClick (event klik)

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

   Pemicu saat meninggalkan aplikasi

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

   Pemicu saat kembali ke aplikasi

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

3. Tangani UI untuk tampilan/penghilangan Gambar-dalam-Gambar.

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

Degradasi RTS langsung

Pemutaran langsung RTS.

Android player SDK menyediakan metode setOutputAudioChannel untuk menetapkan saluran audio output. Jika sumber input adalah stereo, Anda dapat beralih ke saluran kiri atau kanan menggunakan metode ini. Jika sumber input adalah mono, pengaturan tidak berpengaruh.

/*
OutputAudioChannel.OUTPUT_AUDIO_CHANNEL_LEFT beralih ke pemutaran saluran kiri,
OutputAudioChannel.OUTPUT_AUDIO_CHANNEL_RIGHT beralih ke pemutaran saluran kanan,
OutputAudioChannel.OUTPUT_AUDIO_CHANNEL_NONE tidak mengalihkan saluran, mempertahankan saluran sumber input.
*/
aliPlayer.setOutputAudioChannel();

Tetapkan listener untuk memperoleh data aliran audio dan video. Aliran tidak boleh dienkripsi, karena aliran terenkripsi tidak dapat diuraikan.

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

// Konfigurasi opsional 2: Untuk decoding perangkat keras, RenderFrame mengembalikan texture_oes_id; untuk decoding perangkat lunak, RenderFrame mengembalikan data sumber.
aliPlayer.enableHardwareDecoder(true);
// Tetapkan listener untuk memperoleh data audio dan video.
aliPlayer.setOnRenderFrameCallback(frameInfo -> {
    if (frameInfo.frameType == FrameInfo.FrameType_video) {
        // Data video.
    } else {
        // Data audio.
    }
    return false;
});

Android player SDK mendukung penyetelan warna latar belakang untuk rendering pemutar. Antarmuka dan instruksi penggunaan:

Contoh antarmuka

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

Instruksi penggunaan

// Parameter adalah nilai heksadesimal 8 digit. Setiap pasang digit mewakili A (transparansi alfa), R (merah), G (hijau), B (biru) secara berurutan.
// Misalnya, 0x0000ff00 merepresentasikan hijau.
aliPlayer.setVideoBackgroundColor(0x0000ff00);

vidAuthTetapkan domain pemutaran tertentu

Menggunakan vidAuth, Anda dapat menentukan bidang seperti domain untuk vid. Untuk bidang yang didukung, lihat Parameter permintaan GetPlayInfo. Antarmuka dan instruksi penggunaan:

Contoh antarmuka

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

Instruksi penggunaan

Gunakan metode addPlayerConfig dari VidPlayerConfigGen untuk menambahkan bidang playDomain.

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

Plugin dekoding H.266

H.266 (VVC/Versatile Video Coding) adalah standar pengkodean video generasi berikutnya yang secara signifikan mengurangi bitrate pada kualitas setara. Kemampuan decoding H.266 dikemas secara independen sebagai plugin untuk integrasi sesuai permintaan.

Prasyarat

1. Versi Player/integrated SDK V7.6.0 atau lebih baru.

2. Otorisasi lisensi Edisi Profesional telah diselesaikan. Dapatkan lisensi player SDK.

3. ApsaraVideo Player dengan plugin decoding H.266 hanya mendukung video H.266 yang ditranskode oleh transkoding audio dan video ApsaraVideo VOD.

Integrasikan plugin

// x.x.x sesuai dengan nomor versi player SDK.
com.aliyun.sdk.android:AlivcVVCCodec:x.x.x

// x.x.x sesuai dengan nomor versi integrated SDK.
com.aliyun.sdk.android:AlivcVVCCodec:x.x.x-aio

Aktifkan plugin

AliPlayerGlobalSettings.enableCodecPlugin("vvc", true);

Kode kesalahan terkait

Untuk kode kesalahan plugin decoding H.266, lihat Masalah umum untuk pemutar di semua platform.

Pembaruan otomatis sumber pemutaran

Mengaktifkan pembaruan otomatis untuk sumber pemutaran mencegah gangguan pemutaran yang disebabkan oleh kedaluwarsa sumber di bawah mekanisme autentikasi.

Prasyarat

1. Versi Player/integrated SDK V7.9.0 atau lebih baru.

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

/**
 * Tetapkan listener untuk event kedaluwarsa sumber VidAuth.
 *
 * Fitur ini mengaktifkan pembaruan otomatis sumber VidAuth untuk menghindari gangguan pemutaran
 * yang disebabkan oleh kedaluwarsa. Saat listener dipicu, Anda dapat memperbarui 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.
     *
     * Anda dapat memperbarui 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 pembaruan sumber pemutaran.
 *
 * Antarmuka ini berlaku untuk jenis sumber pemutaran yang memerlukan pembaruan dinamis,
 * seperti sumber URL atau sumber VidAuth. Saat pemutar memicu permintaan pembaruan,
 * hasil pembaruan dapat dikembalikan melalui antarmuka ini dengan memanggil metode `onSuccess` atau `onError`.
 */
public interface SourceRefreshCallback<T extends SourceBase> {
    /**
     * Dipanggil oleh pemutar saat operasi pembaruan berhasil.
     *
     * @param newSource Objek sumber pemutaran baru yang berisi informasi yang diperbarui. Lihat {@link SourceBase}.
     *
     * Metode ini menunjukkan bahwa operasi pembaruan berhasil diselesaikan. Developer harus memberikan
     * sumber pemutaran baru dalam metode ini agar pemutar dapat memuat sumber daya terbaru.
     */
    void onSuccess(T newSource);

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

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

        // ------------------- Implementasi pengguna dimulai -------------------
        // Panggil fungsi Anda sendiri untuk mendapatkan PlayAuth baru dari server aplikasi Anda.
        // clinetGetPlayAuthFunction adalah nama fungsi contoh; ganti dengan implementasi Anda sendiri.
        clinetGetPlayAuthFunction(vid, new PlayAuthCallback() {
            
            /**
             * Callback saat kredensial baru berhasil diperoleh.
             * @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. Kembalikan objek yang diperbarui ke pemutar melalui callback SDK.
                sourceRefreshCallback.onSuccess(vidAuth);
            }

            /**
             * Callback saat memperoleh kredensial baru gagal.
             * @param errorMessage Pesan kesalahan terperinci.
             */
            @Override
            public void onAuthError(String errorMessage) {                
                // Kembalikan pesan kesalahan ke pemutar melalui callback SDK.
                sourceRefreshCallback.onError(errorMessage);
            }
        });
        // ------------------- Implementasi pengguna berakhir -------------------
    }
});

/**
 * Tetapkan listener untuk event kedaluwarsa sumber URL.
 *
 * Fitur ini mengaktifkan pembaruan URL untuk menghindari gangguan pemutaran yang disebabkan oleh
 * kedaluwarsa URL karena autentikasi. Saat listener dipicu,
 * Anda dapat memperbarui 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 lebih lanjut tentang mengonfigurasi 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 pembaruan sumber pemutaran.
 *
 * Antarmuka ini berlaku untuk jenis sumber pemutaran yang memerlukan pembaruan dinamis,
 * seperti sumber URL atau sumber VidAuth. Saat pemutar memicu permintaan pembaruan,
 * hasil pembaruan dapat dikembalikan melalui antarmuka ini dengan memanggil metode `onSuccess` atau `onError`.
 */
public interface SourceRefreshCallback<T extends SourceBase> {
    /**
     * Dipanggil oleh pemutar saat operasi pembaruan berhasil.
     *
     * @param newSource Objek sumber pemutaran baru yang berisi informasi yang diperbarui. Lihat {@link SourceBase}.
     *
     * Metode ini menunjukkan bahwa operasi pembaruan berhasil diselesaikan. Developer harus memberikan
     * sumber pemutaran baru dalam metode ini agar pemutar dapat memuat sumber daya terbaru.
     */
    void onSuccess(T newSource);

    /**
     * Dipanggil oleh pemutar saat operasi pembaruan gagal.
     *
     * @param errorMsg String yang menjelaskan alasan kegagalan.
     *
     * Metode ini menunjukkan bahwa operasi pembaruan 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 pemutar mendeteksi bahwa sumber URL (UrlSource) telah kedaluwarsa.
     *
     * Anda dapat memperbarui 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 pembaruan yang digunakan untuk mengembalikan UrlSource yang diperbarui ke pemutar. 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, "Pembaruan gagal: Kunci autentikasi kosong.");
            sourceRefreshCallback.onError("REFRESH_ERROR: Kunci autentikasi tidak ada.");
            return; // Keluar lebih awal jika kunci tidak valid.
        }

        // 2. Hitung durasi validitas (waktu kedaluwarsa) untuk URL 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 autentikasi tipe A sebagai contoh).
        // Kembalikan alamat sumber asli dengan menghapus parameter URL (misalnya, "?auth_key=").
        int authKeyIndex = expiredUrl.indexOf("?auth_key=");
        if (authKeyIndex == -1) {
            authKeyIndex = expiredUrl.indexOf("&auth_key=");
        }
        // Tangani dengan aman kasus di mana auth_key tidak ditemukan.
        String originalUrl = (authKeyIndex != -1) ? expiredUrl.substring(0, authKeyIndex) : expiredUrl;

        // 4. Hasilkan URL terautentikasi baru menggunakan kelas utilitas.
        String newAuthUrl = CdnAuthUtil.aAuth(originalUrl, authenticationKey, newExpireTime);

        // 5. Periksa URL terautentikasi yang dihasilkan dan kembalikan hasil melalui callback.
        if (newAuthUrl != null && !newAuthUrl.isEmpty()) {
            Log.i(TAG, "Pembaruan berhasil, URL baru: " + newAuthUrl);
            // Buat objek UrlSource seperti yang diperlukan oleh SDK dan tetapkan URL baru.
            UrlSource resultSource = new UrlSource();
            resultSource.setUri(newAuthUrl);
            sourceRefreshCallback.onSuccess(resultSource);
        } else {
            Log.e(TAG, "Pembaruan gagal: Gagal menghasilkan URL terotorisasi baru.");
            sourceRefreshCallback.onError("REFRESH_ERROR: Gagal menghasilkan URL baru.");
        }
    }
});

Fungsi utilitas tambahan

Menggunakan autentikasi tipe A sebagai contoh.

// Fungsi pembuatan URL terautentikasi.
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 perhitungan 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);
    }
}

Alihkan NIC terikat

Android player SDK menyediakan metode AliPlayerGlobalSettings.enableSwitchNIC untuk secara otomatis mengalihkan NIC selama anomali jaringan, memastikan pemutaran sumber daya yang stabil. Contoh:

AliPlayerGlobalSettings.enableSwitchNIC(true);

Peningkatan audio

Android player SDK menyediakan plugin peningkatan audio untuk meningkatkan pengalaman pemutaran audio, dengan fitur normalisasi volume, peningkatan suara, dan suara surround.

Pengenalan fitur

• Normalisasi volume: Secara otomatis menyesuaikan semua konten audio ke tingkat volume yang konsisten, secara signifikan meningkatkan pengalaman pemutaran untuk video dengan volume asli terlalu rendah atau terlalu tinggi.

  • Saluran yang didukung: Mono / Stereo / 5.1 / 7.1.

  • Laju sampel yang didukung: 16kHz / 44.1kHz / 48kHz.

• Peningkatan suara: Secara cerdas meningkatkan dialog sambil mempertahankan timbre asli, membuat suara lebih jelas dan cerah dalam adegan bising.

  • Saluran yang didukung: Stereo.

  • Laju sampel yang didukung: 44.1kHz / 48kHz.

• Suara surround: Menerapkan rendering surround virtual ke video multi-saluran dan stereo, memberikan pengalaman imersif pada headphone atau perangkat standar. Termasuk mode 3DSurround (surround stereo) dan MegaBass (bass super).

  • Saluran yang didukung: Mono / Stereo / 5.1 / 7.1.

  • Laju sampel yang didukung: 44.1kHz / 48kHz.

Prasyarat

1. Versi Player/integrated SDK V7.13.0 atau lebih baru.

2. Otorisasi Lisensi Edisi Profesional diperoleh. Dapatkan lisensi player SDK.

Integrasikan plugin

// x.x.x sesuai dengan nomor versi player SDK.
implementation 'com.aliyun.sdk.android:AlivcAudioEnhanceFilter:x.x.x'

Antarmuka fitur

player.setFilterValid("audioEnhance", true);   // Aktifkan.
player.setFilterValid("audioEnhance", false);  // Nonaktifkan.

FilterConfig filterConfig = new FilterConfig();
FilterConfig.Filter filterItem = new FilterConfig.Filter("audioEnhance");
FilterConfig.FilterOptions opts = new FilterConfig.FilterOptions();
// Suara surround.
opts.setOption("enable_surround", true);
opts.setOption("surround_effect_type", "3DSurround"); // Jenis harus ditetapkan bersama dengan enable_surround saat pertama kali digunakan.
// Peningkatan suara.
opts.setOption("enable_dialoguenhance", true);
opts.setOption("dialoguenhance_voice", 1.0f); // 1.0 ~ 10.0. Suara harus ditetapkan bersama dengan enable_dialoguenhance saat pertama kali digunakan.
// Normalisasi volume.
opts.setOption("enable_normalizer", true);

filterItem.setOptions(opts);
filterConfig.addFilter(filterItem);
player.setFilterConfig(filterConfig);

AVPFilterOptions *opts = [[AVPFilterOptions alloc] init];
[opts setOptions:@"enable_surround" value:@YES];
[opts setOptions:@"surround_effect_type" value:@"3DSurround"]; // Jika bukan pertama kali mengaktifkan surround, pengaturan Jenis ini tidak valid karena inisialisasi sudah selesai.
[player updateFilterConfig:@"audioEnhance" options:opts];

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

aliPlayer.setOption(ALLOW_PRE_RENDER, 1);

Cache lokal meningkatkan kecepatan startup, kecepatan pencarian, dan mengurangi tersendat untuk pemutaran berulang sekaligus menghemat bandwidth.

Aktifkan cache lokal

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

/**
 * Anda juga dapat menggunakan kode berikut untuk pengaturan cache.
 * Aktifkan cache lokal. Setelah diaktifkan, konten di-cache ke file lokal.
 * @param enable: Sakelar fitur cache lokal. true: aktifkan, false: nonaktifkan. Dinonaktifkan secara default.
 * @param maxBufferMemoryKB: Ditinggalkan sejak versi 5.4.7.1, saat ini tidak berpengaruh.
 * @param localCacheDir: Harus ditetapkan. Direktori cache lokal sebagai jalur mutlak.
 * AliPlayerGlobalSettings.enableLocalCache(enable, maxBufferMemoryKB, localCacheDir);
 */

/**
 * Konfigurasi pembersihan file cache.
 * @param expireMin - Ditinggalkan sejak versi 5.4.7.1, saat ini tidak berpengaruh.
 * @param maxCapacityMB - Kapasitas cache maksimum dalam MB. Default adalah 20 GB. Selama pembersihan, jika ukuran total cache melebihi nilai ini, item cache dihapus satu per satu dari yang terlama hingga terbaru hingga ukuran ≤ maxCapacityMB.
 * @param freeStorageMB - Ruang disk bebas minimum dalam MB. Default adalah 0. Selama pembersihan, jika ruang disk saat ini kurang dari nilai ini, item cache dihapus satu per satu hingga ruang bebas ≥ nilai ini atau semua cache dihapus.
 * public static void setCacheFileClearConfig(long expireMin,
 *         long maxCapacityMB,
 *         long freeStorageMB)
 */

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

Aktifkan atau nonaktifkan cache lokal untuk URL tunggal

// Dapatkan konfigurasi terlebih dahulu.
PlayerConfig config = aliPlayer.getConfig();
// Apakah akan mengaktifkan cache lokal untuk URL pemutaran. Default adalah true. Saat cache lokal global diaktifkan dan ini ditetapkan ke true, cache lokal berlaku untuk URL ini. Jika ditetapkan ke false, cache lokal dinonaktifkan untuk URL ini.
config.mEnableLocalCache = false;
....// Pengaturan lainnya.

// Tetapkan konfigurasi untuk pemutar.
aliPlayer.setConfig(config);

Pra-pemuatan adalah peningkatan cache lokal yang meningkatkan kecepatan startup video dengan menetapkan penggunaan memori untuk caching video.

AliPlayerGlobalSettings.enableNetworkBalance(false);

1. Aktifkan cache lokal. Untuk langkah terperinci, lihat Cache lokal.

2. Tetapkan sumber data.

   VidAuth (direkomendasikan)

   VidAuth vidAuth = new VidAuth();
   vidAuth.setVid("Info Vid");// Parameter wajib: ID Video.
   vidAuth.setPlayAuth("<kredensialPlayAnda>");// Parameter wajib: Kredensial pemutaran, dihasilkan dengan memanggil API GetVideoPlayAuth VOD.
   vidAuth.setRegion("Wilayah akses");// Untuk versi player SDK 5.5.5.0 dan lebih baru, parameter ini ditinggalkan dan tidak diperlukan; pemutar secara otomatis mengurai wilayahnya. Untuk versi sebelum 5.5.5.0, parameter ini wajib; wilayah akses VOD default adalah cn-shanghai.
   vidAuth.setQuality("Definisi yang dipilih") //"AUTO" merepresentasikan bitrate adaptif.

   VidSts

   VidSts vidSts = new VidSts();
   vidSts.setVid("Info Vid");// Parameter wajib: ID Video. vidSts.setAccessKeyId("<yourAccessKeyId>");// Parameter wajib: ID kunci akses pasangan AK sementara STS, dihasilkan dengan memanggil API AssumeRole STS.  vidSts.setAccessKeySecret("<yourAccessKeySecret>");// Parameter wajib: Rahasia kunci akses pasangan AK sementara STS, dihasilkan dengan memanggil API AssumeRole STS.  vidSts.setSecurityToken("<yourSecurityToken>");// Parameter wajib: Token keamanan STS, dihasilkan dengan memanggil API AssumeRole STS.  vidSts.setRegion("Wilayah akses");// Parameter wajib: Wilayah akses VOD; default adalah cn-shanghai.
   vidSts.setQuality("Definisi yang dipilih") //"AUTO" merepresentasikan bitrate adaptif.

   UrlSource

   UrlSource urlSource = new UrlSource();
   urlSource.setUri("Alamat pemutaran");// Parameter wajib: Alamat pemutaran, yang dapat berupa alamat VOD pihak ketiga atau alamat pemutaran Alibaba Cloud VOD.

3. Tetapkan parameter tugas.

   Catatan

   Hanya berlaku untuk video multi-bitrate. Pilih salah satu dari setDefaultBandWidth, setDefaultResolution, atau setDefaultQuality.

   PreloadConfig preloadConfig = new PreloadConfig();
   // Tetapkan bitrate pra-pemuatan untuk aliran multi-bitrate.
   preloadConfig.setDefaultBandWidth(400000);
   // Tetapkan resolusi pra-pemuatan untuk aliran multi-bitrate.
   preloadConfig.setDefaultResolution(640 * 480);
   // Tetapkan kualitas pra-pemuatan untuk aliran multi-bitrate.
   preloadConfig.setDefaultQuality("FD");
   // Tetapkan durasi pra-pemuatan.
   preloadConfig.setDuration(1000);

4. Tambahkan listener tugas.

   Perluas untuk melihat kode

   /**
    * Implementasi listener pra-pemuatan.
    */
   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 instans MediaLoaderV2 untuk memulai pra-pemuatan.

   VidAuth (direkomendasikan)

   // Bangun pra-pemuatan.
   PreloadTask mPreloadTask = new PreloadTask(vidAuth, preloadConfig);
   // Dapatkan instans MediaLoaderV2.
   MediaLoaderV2 mediaLoaderV2 = MediaLoaderV2.getInstance();
   // Tambahkan tugas dan mulai pra-pemuatan.
   String taskId = mediaLoaderV2.addTask(mPreloadTask, PreloadListenerImpl)

   VidSts

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

   UrlSource

   // Bangun pra-pemuatan.
   PreloadTask mPreloadTask = new PreloadTask(urlSource, preloadConfig);
   // Dapatkan instans MediaLoaderV2.
   MediaLoaderV2 mediaLoaderV2 = MediaLoaderV2.getInstance();
   // Tambahkan tugas dan mulai pra-pemuatan.
   String taskId = mediaLoaderV2.addTask(mPreloadTask, PreloadListenerImpl)

6. Opsi: Kelola tugas.

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

7. Opsi: Hapus file yang dimuat.

   Hapus file yang dimuat sesuai kebutuhan untuk menghemat ruang. Android player SDK tidak menyediakan antarmuka penghapusan; hapus file dari direktori pemuatan di aplikasi Anda.

Strategi pra-pemuatan dinamis memungkinkan integrator mengontrol cache video yang sedang diputar dan jumlah serta cache item yang dipra-muat, menyeimbangkan pengalaman pemutaran dan biaya overhead.

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

// Konfigurasikan durasi pra-pemuatan dasar.
// Tetapkan durasi pra-pemuatan menjadi 1000ms.
PreloadConfig config = new PreloadConfig();
config.mPreloadDuration = 1000;
aliListPlayer.updatePreloadConfig(config);

// Konfigurasikan jumlah pra-pemuatan, mendukung dua arah.
// 1 untuk pra-pemuatan maju, 3 untuk pra-pemuatan mundur.
aliListPlayer.setPreloadCount(1, 3);

// Konfigurasikan offset pengurangan strategi pra-pemuatan dinamis.
aliListPlayer.enablePreloadStrategy(IListPlayer.StrategyType.STRATEGY_DYNAMIC_PRELOAD_DURATION, true);
aliListPlayer.setPreloadStrategy(IListPlayer.StrategyType.STRATEGY_DYNAMIC_PRELOAD_DURATION, "{\"algorithm\": \"sub\",\"offset\": \"200\"}");

Pra-pemuatan video HLS multi-bitrate

Dalam skenario pemutaran video HLS multi-bitrate listPlayer, integrator dapat mempra-muat aliran yang sesuai dengan definisi pemutaran saat ini dan memilih mode pra-pemuatan berdasarkan kebutuhan bisnis.

  /**
   * Konfigurasi default, putar dan pra-muat bitrate default.
   */
  MultiBitratesMode_Default(0),

  /**
   * Konfigurasi prioritas frame pertama, kurangi biaya frame pertama. Hanya putar bitrate aliran HLS yang telah dipra-muat.
   */
  MultiBitratesMode_FCPrio(1),

  /**
   * Seimbangkan frame pertama dan kelancaran pemutaran, putar bitrate yang sama sebelum dan sesudah moveToNext, dan prioritaskan performa frame pertama.
   */
  MultiBitratesMode_FC_AND_SMOOTH(2),

  /**
   * Konfigurasi prioritas kelancaran pemutaran, putar bitrate yang sama sebelum dan sesudah moveToNext.
   */
  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 domain pra-resolusi HTTPDNS.
DomainProcessor.getInstance().addPreResolveDomain("player.***alicdn.com");

HTTP/2

AliPlayerGlobalSettings.setUseHttp2(true);

TCP pra-koneksi HTTP

Untuk permintaan pemutaran video HTTP (non-HTTPS), membangun koneksi TCP terlebih dahulu secara signifikan meningkatkan pengalaman pengguna, mengurangi waktu koneksi jaringan, memastikan pemutaran segera dan berkelanjutan, serta mengoptimalkan penggunaan sumber daya jaringan dan sistem. Penggunaan:

// Format domain adalah host[:port]; port opsional. Pisahkan beberapa domain dengan titik koma (;).
// Pengaturan global.
// Antarmuka lengkap menggunakan string saat ini setiap kali ditetapkan (lebih banyak - tambah, lebih sedikit - hapus). String kosong menghentikan pra-koneksi.
AliPlayerGlobalSettings.setOption(AliPlayerGlobalSettings.SET_PRE_CONNECT_DOMAIN, "domain1;domain2");

Android player SDK menyediakan fitur unduhan video untuk layanan VOD, memungkinkan pengguna menyimpan cache video secara lokal menggunakan ApsaraVideo Player. Fitur ini menawarkan dua metode unduhan: unduhan standar dan unduhan aman.

• Unduhan standar

  Data video yang diunduh tidak dienkripsi oleh Alibaba Cloud dan dapat diputar oleh pemutar pihak ketiga.

• Unduhan aman

  Data video yang diunduh dienkripsi oleh Alibaba Cloud. Pemutar pihak ketiga tidak dapat memutarnya. Hanya ApsaraVideo Player yang dapat memutarnya.

Instruksi penggunaan

• Hanya metode VidSts dan VidAuth yang mendukung unduhan video.

• Untuk menggunakan fitur unduhan video pemutar, aktifkan dan konfigurasikan mode unduhan di konsol VOD. Untuk langkah terperinci, lihat Unduhan offline.

• Unduhan video mendukung unduhan yang dapat dilanjutkan.

Prosedur

1. Opsi: Konfigurasikan file verifikasi enkripsi untuk unduhan aman. Diperlukan hanya untuk unduhan aman; tidak diperlukan untuk unduhan standar.

   Catatan

   Pastikan file verifikasi enkripsi yang dikonfigurasi sesuai dengan informasi aplikasi Anda; jika tidak, unduhan video gagal.

   Untuk unduhan aman, konfigurasikan file kunci yang dihasilkan di konsol VOD di player SDK untuk verifikasi dekripsi selama unduhan dan pemutaran video. Untuk pembuatan file kunci, lihat Aktifkan unduhan aman.

   Kami merekomendasikan mengonfigurasi ini sekali di Application. Contoh:

   PrivateService.initService(getApplicationContext(),  "Jalur ke file encryptedApp.dat"); // Kami merekomendasikan menyimpan file verifikasi encryptedApp.dat di ponsel dan menetapkan jalur file lokalnya di sini.

2. Buat dan tetapkan pengunduh.

   Buat pengunduh menggunakan AliDownloaderFactory. Contoh:

   AliMediaDownloader mAliDownloader = null;
   ......
   // Buat pengunduh.
   mAliDownloader = AliDownloaderFactory.create(getApplicationContext());
   // Konfigurasikan jalur penyimpanan unduhan.
   mAliDownloader.setSaveDir("Jalur folder simpan");

3. Tetapkan listener event.

   Pengunduh menyediakan beberapa listener event. Contoh:

   Perluas untuk melihat kode

   mAliDownloader.setOnPreparedListener(new AliMediaDownloader.OnPreparedListener() {
      @Override
      public void onPrepared(MediaInfo mediaInfo) {
          // Item unduhan berhasil dipersiapkan.
      }
   });
   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. Persiapkan sumber unduhan.

   Persiapkan sumber unduhan menggunakan metode prepare. Sumber unduhan mendukung metode VidSts dan VidAuth. Contoh:

   • VidSts

     // Buat VidSts
     VidSts aliyunVidSts = new VidSts();
     aliyunVidSts.setVid("Informasi Vid"); // ID Video (VideoId).
     aliyunVidSts.setAccessKeyId("<yourAccessKeyId>"); // ID AccessKey pasangan AccessKey STS sementara, dihasilkan dengan memanggil operasi AssumeRole Layanan Token Keamanan (STS).
     aliyunVidSts.setAccessKeySecret("<yourAccessKeySecret>"); // Rahasia AccessKey pasangan AccessKey STS sementara, dihasilkan dengan memanggil operasi AssumeRole Layanan Token Keamanan (STS).
     aliyunVidSts.setSecurityToken("<yourSecurityToken>"); // Token Layanan Keamanan (STS), dihasilkan dengan memanggil operasi AssumeRole Layanan Token Keamanan (STS).
     aliyunVidSts.setRegion("wilayah"); // Wilayah layanan video sesuai permintaan (VOD). Nilai default: cn-shanghai.
     // Jika Anda telah mengaktifkan transmisi langsung parameter enkripsi HLS di konsol VOD dan nama parameter default adalah MtsHlsUriToken,
     // Anda harus menetapkan konfigurasi dan meneruskannya ke vid, seperti yang ditunjukkan di bawah ini.
     // Jika Anda belum mengaktifkan transmisi langsung parameter enkripsi HLS di konsol VOD, lewati kode berikut.
     VidPlayerConfigGen vidConfig = new VidPlayerConfigGen();
     vidConfig.setMtsHlsUriToken("<yourMtsHlsUriToken>");
     aliyunVidSts.setPlayerConfig(vidConfig);
             
     
     // Persiapkan sumber unduhan
     mAliDownloader.prepare(aliyunVidSts)

   • VidAuth

     // Buat VidAuth.
     VidAuth vidAuth = new VidAuth();
     vidAuth.setVid("Info Vid");// ID Video.
     vidAuth.setPlayAuth("<kredensialPlayAnda>");// Kredensial pemutaran, dihasilkan dengan memanggil API GetVideoPlayAuth VOD.
     vidAuth.setRegion("Wilayah akses");// Untuk versi player SDK 5.5.5.0 dan lebih baru, parameter ini ditinggalkan dan tidak diperlukan; pemutar secara otomatis mengurai wilayahnya. Untuk versi sebelum 5.5.5.0, parameter ini wajib; wilayah akses VOD default adalah cn-shanghai.
     // Jika Anda mengaktifkan transmisi langsung parameter enkripsi standar HLS di konsol VOD dengan nama parameter default MtsHlsUriToken, tetapkan konfigurasi dan teruskan ke vid seperti di bawah ini.
     VidPlayerConfigGen vidConfig = new VidPlayerConfigGen();
     vidConfig.setMtsHlsUriToken("<yourMtsHlsUriToken>");
     vidAuth.setPlayerConfig(config);
     // Persiapkan sumber unduhan.
     mAliDownloader.prepare(vidAuth);

   Catatan

   • Format file sumber cocok dengan format file yang diunduh; perubahan tidak didukung.

   • Jika Anda mengaktifkan transmisi langsung parameter enkripsi standar HLS di konsol VOD dengan nama parameter default MtsHlsUriToken, lihat Transmisi langsung parameter enkripsi standar HLS, kemudian tetapkan nilai MtsHlsUriToken dalam sumber VOD seperti yang ditunjukkan di atas.

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

   Setelah persiapan berhasil, metode OnPreparedListener dipanggil. TrackInfo yang dikembalikan berisi informasi seperti definisi aliran video. Pilih satu Track untuk diunduh. Contoh:

   public void onPrepared(MediaInfo mediaInfo) {
       // Item unduhan berhasil dipersiapkan.
       List<TrackInfo> trackInfos = mediaInfo.getTrackInfos();
       // Misalnya: unduh TrackInfo pertama.
       mAliDownloader.selectItem(trackInfos.get(0).getIndex());
       // Mulai unduh.
       mAliDownloader.start();
   }

6. (Opsional) Perbarui sumber unduhan.

   Untuk mencegah kedaluwarsa VidSts dan VidAuth, Anda dapat memperbarui informasi sumber unduhan dan mulai mengunduh. Contoh:

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

7. Setelah keberhasilan atau kegagalan unduhan, lepaskan pengunduh.

   Setelah unduhan berhasil, panggil release dalam callback onCompletion atau onError untuk melepaskan pengunduh. Contoh:

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

8. Opsi: Hapus file yang diunduh.

   Anda dapat menghapus file yang diunduh selama atau setelah unduhan. Contoh:

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

Langkah selanjutnya

Video yang diunduh dapat diputar menggunakan ApsaraVideo Player. Langkah-langkah:

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

   String path = mAliDownloader.getFilePath();

2. Tetapkan jalur mutlak melalui UrlSource VOD untuk pemutaran.

    UrlSource urlSource = new UrlSource();
           urlSource.setUri("Alamat pemutaran");// Tetapkan jalur mutlak video yang diunduh.
           aliPlayer.setDataSource(urlSource);