ApsaraVideo VOD:FAQ pemutar Android

SDK pemutar melaporkan progres pemutaran setiap 500 ms secara default. Sesuaikan interval callback sesuai kebutuhan:

// Ubah interval callback.
PlayerConfig config = mAliyunLivePlayer.getConfig();
config.mPositionTimerIntervalMs = 100;// Interval callback dalam milidetik.
mAliyunLivePlayer.setConfig(config);

mAliPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
        @Override
        public void onInfo(InfoBean infoBean) {
        if(infoBean.getCode() == InfoCode.CurrentPosition){
            // Progres pemutaran saat ini.
            long currentPosition = infoBean.getExtraValue();
        }
    }
});

Untuk mengambil data audio dan video mentah, alihkan ke decoding software dan putar video yang tidak terenkripsi:

// Alihkan ke decoding software.
mAliPlayer.enableHardwareDecoder(false);
IPlayer.RenderFrameCallbackConfig renderFrameCallbackConfig = new IPlayer.RenderFrameCallbackConfig();
// Menentukan apakah hanya mengembalikan alamat data video dasar. Nilai default: true.
renderFrameCallbackConfig.mVideoDataAddr = false;
// Menentukan apakah hanya mengembalikan alamat data audio dasar. Nilai default: false.
renderFrameCallbackConfig.mAudioDataAddr = false;
mAliPlayer.setRenderFrameCallbackConfig(renderFrameCallbackConfig);

mAliPlayer.setOnRenderFrameCallback(new IPlayer.OnRenderFrameCallback() {
    @Override
    public boolean onRenderFrame(FrameInfo frameInfo) {
        return false;
    }
});

Ambil lebar dan tinggi video menggunakan salah satu metode berikut:

• Setelah instans AliPlayer memasuki status `prepared`:

  mAliyunPlayer.setOnPreparedListener(new IPlayer.OnPreparedListener() {
      @Override
      public void onPrepared() {
            mAliyunPlayer.getVideoWidth();
                mAliyunPlayer.getVideoHeight();
      }
  });

• Dengarkan callback perubahan ukuran video:

  mAliyunPlayer.setOnVideoSizeChangedListener(new IPlayer.OnVideoSizeChangedListener() {
      @Override
      public void onVideoSizeChanged(int width, int height) {
  
      }
  });

• Gunakan informasi track:

  mAliyunPlayer.setOnTrackReadyListener(new IPlayer.OnTrackReadyListener() {
      @Override
      public void onTrackReady(MediaInfo mediaInfo) {
      List<TrackInfo> trackInfos = mediaInfo.getTrackInfos();
          for (TrackInfo trackInfo : trackInfos) {
          if(trackInfo.getType() == TrackInfo.Type.TYPE_VIDEO){
          trackInfo.getVideoWidth();
          trackInfo.getVideoHeight();
          }
      }
      }
  });

Saat Anda memanggil mAliPlayer.selectTrack(TrackInfo.AUTO_SELECT_INDEX) untuk mengaktifkan pengalihan bitrate otomatis, SDK pemutar menghitung kecepatan jaringan. Jika kecepatan tersebut mampu mendukung level bitrate berikutnya selama 10 detik, pemutar akan beralih. Jika tidak, pemutar tetap pada bitrate saat ini.

• Dari tinggi ke rendah: jika kecepatan jaringan mencapai level bitrate berikutnya dalam waktu 10 detik, pemutar menyelesaikan konten bitrate tinggi yang telah di-cache sebelum beralih.

• Dari rendah ke tinggi: pemutar langsung beralih begitu kecepatan jaringan mampu mendukung bitrate yang lebih tinggi selama 10 detik.

Untuk menggunakan pengalihan bitrate otomatis, transkode video menjadi aliran bitrate adaptif di Konsol, lalu konfigurasi pemutar untuk mengambilnya. Contoh dengan VidAuth:

VidAuth vidAuth = new VidAuth();
List<Definition> list = new ArrayList<>();
list.add(Definition.DEFINITION_AUTO);
vidAuth.setDefinition(list);

Untuk menyesuaikan logika retry, atur jumlah retry menjadi 0 dan tangani event retry secara eksternal:

PlayerConfig config = mAliPlayer.getConfig();
// 1. Atur jumlah retry. Pada contoh ini, diatur menjadi 0.
config.mNetworkRetryCount = 0;
mAliPlayer.setConfig(config);

mAliPlayer.setOnInfoListener(new IPlayer.OnInfoListener() {
    @Override
    public void onInfo(InfoBean infoBean) {
        // 2. Dengarkan event retry.
       if(infoBean.getCode() == InfoCode.NetworkRetry){
            // TODO: Proses logika sesuai kebutuhan.
        }
    }
});

Beralih antara mode seek:

// Seek tidak akurat.
mAliPlayer.seekTo(1000);
mAliPlayer.seekTo(1000, IPlayer.SeekMode.Inaccurate);
// Seek akurat.
mAliPlayer.seekTo(1000,IPlayer.SeekMode.Accurate);

Solusi: Tingkatkan interval maksimum seek akurat untuk mengurangi fallback ke seek tidak akurat. Interval yang lebih panjang meningkatkan akurasi tetapi mungkin memperpanjang waktu seek:

// Satuan: ms.
mAliPlayer.setMaxAccurateSeekDelta(10000);

Pecahkan masalah sebagai berikut:

1. Periksa apakah arsitektur CPU adalah x86.

   SDK pemutar hanya mendukung arsitektur arm64-v8a dan armeabi-v7a. SDK tidak mendukung arsitektur x86.

2. Periksa apakah file .so dan dependensi Maven untuk SDK pemutar telah diintegrasikan dalam proyek.

   Sebagai contoh, Anda mungkin telah mengintegrasikan SDK pemutar menggunakan dependensi Maven di `build.gradle` dan juga mengintegrasikan library dinamis terkait pemutar di direktori `libs` modul proyek.

   Disarankan: Hapus library dinamis dan gunakan hanya dependensi Maven. Jika Anda harus menggunakan library dinamis, pastikan semua file .so berasal dari versi yang sama. Integrasikan SDK. File library dinamis berikut terkait dengan pemutar: libalivcffmpeg.so, libsaasCorePlayer.so, dan libsaasDownloader.so.

3. Jika Anda mengintegrasikan paket parsial, pastikan dependensi versi AlivcFFmpeg sudah benar.

   Untuk informasi tentang dependensi versi AlivcFFmpeg, lihat Dependensi versi AlivcFFmpeg.

Pecahkan masalah sebagai berikut:

1. Konfirmasi apakah crash terjadi di SDK pemutar.

   Periksa adanya stack crash dengan awalan AliyunPlayer. Jika ada stack dengan awalan tersebut, masalah berada di SDK pemutar.

2. Upgrade ke versi terbaru SDK pemutar dan verifikasi apakah masalah telah teratasi.

3. Jika masalah tetap ada, kumpulkan file crash (termasuk semua thread), log crash, dan detail skenario. Cara mengambil log masalah.

Pecahkan masalah sebagai berikut:

1. Periksa apakah video sumber itu sendiri memiliki bar hitam.

2. Anda dapat menyesuaikan mode penskalaan pemutar menggunakan antarmuka berikut.

   /*
   SCALE_ASPECT_FILL: Mengisi layar secara proporsional. Video dipotong.
   SCALE_ASPECT_FIT: Menskalakan video secara proporsional. Bar hitam mungkin muncul.
   SCALE_TO_FILL: Mengisi layar tanpa mempertahankan proporsi. Video terdistorsi.
   */
   mAliPlayer.setScaleMode();

3. Jika mode penskalaan tidak memenuhi kebutuhan Anda, Anda dapat menyesuaikan ukuran SurfaceView atau TextureView di lapisan aplikasi.

Pecahkan masalah sebagai berikut:

1. Mainkan video dengan pemutar lain untuk memeriksa apakah file tersebut hanya berisi audio.

2. Verifikasi bahwa tampilan display dikonfigurasi dengan benar dan tidak dihapus dari antarmuka pemutaran. Atur tampilan display seperti yang dijelaskan dalam Langkah 4 di Fitur dasar.

Pecahkan masalah sebagai berikut:

1. Periksa apakah arsitektur CPU memenuhi persyaratan.

   SDK pemutar hanya mendukung library dinamis untuk arsitektur arm64-v8a dan armeabi-v7a.

2. Periksa apakah versi SDK pemutar terlalu lama.

   Jika Anda menggunakan SDK pemutar V5.4.6.0-full atau lebih lama, upgrade ke V5.4.6.0-full-15467853 atau versi lebih baru. Catatan rilis SDK Android.

Pemutar daftar AliListPlayer mendukung video HLS (m3u8) mulai dari V5.4.5.0, tetapi caching lokal harus diaktifkan. Cache lokal.

Contoh:

// Metode pemutaran VidSts digunakan sebagai contoh.
VidSts vidSts = new VidSts();
// Kode untuk mengatur parameter seperti vid, AccessKeyId, AccessKeySecret, dan token dihilangkan. Untuk informasi lebih lanjut, lihat pengaturan pembuatan pemutar di topik Fitur Dasar.
/*
    Parameter 1: Definisi pemutaran yang diinginkan. Nilai yang valid: FD, LD, SD, HD, 2K, 4K, dan OD.
    Parameter 2: Menentukan apakah pemutaran definisi yang diinginkan diberlakukan. false: Tidak memberlakukan pemutaran definisi yang diinginkan. SDK pemutar mencari definisi untuk diputar berdasarkan urutan default. true: Memberlakukan pemutaran definisi yang diinginkan. Jika definisi yang diinginkan tidak ditemukan, video tidak diputar.
*/
vidSts.setQuality("",false);