ApsaraVideo VOD：FAQ pemutar Android

Secara default, SDK pemutar menyediakan callback untuk progres pemutaran setiap 500 ms. Anda dapat mengubah interval callback ini. Untuk mengambil progres pemutaran lebih sering, perpendek interval tersebut. Kode berikut memberikan contohnya:

// 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 dienkripsi. Kode berikut memberikan contohnya:

// 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;
    }
});

Anda dapat mengambil lebar dan tinggi video dengan salah satu dari tiga cara berikut:

• Setelah instans AliPlayer menyelesaikan metode `prepare` dan memasuki status `prepared`, Anda dapat mengambil lebar dan tinggi menggunakan metode berikut:

  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) {
  
      }
  });

• Anda dapat memperolehnya menggunakan metode 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 mengaktifkan switching bitrate otomatis dengan memanggil antarmuka mAliPlayer.selectTrack(TrackInfo.AUTO_SELECT_INDEX), SDK pemutar menghitung kecepatan jaringan saat ini. Jika kecepatan jaringan dapat mendukung level bitrate berikutnya selama 10 detik, pemutar akan beralih ke bitrate tersebut. Jika tidak, pemutar tidak beralih.

• Saat beralih dari bitrate tinggi ke bitrate rendah, jika kecepatan jaringan mencapai level bitrate berikutnya dalam waktu 10 detik, pemutar menyelesaikan pemutaran konten bitrate tinggi yang telah dicache sebelum beralih.

• Saat beralih dari bitrate rendah ke bitrate tinggi, pemutar beralih secara langsung. Peralihan terjadi jika kecepatan jaringan meningkat ke level bitrate berikutnya selama 10 detik.

Untuk mengaktifkan switching bitrate otomatis, Anda harus terlebih dahulu melakukan transkoding video menjadi aliran bitrate adaptif di Konsol. Kemudian, tentukan bahwa pemutar mengambil aliran bitrate adaptif tersebut. Kode berikut menunjukkan contoh penggunaan metode pemutaran VidAuth:

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

Anda dapat menyesuaikan logika retry. Saat retry dipicu, event retry dikirim ke layanan eksternal yang menentukan logika retry spesifik. Kode berikut memberikan contohnya:

PlayerConfig config = mAliPlayer.getConfig();
// 1. Atur jumlah retry. Dalam contoh ini, diatur ke 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.
        }
    }
});

Kode berikut menunjukkan cara mengalihkan mode seek:

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

Solusi: Anda dapat menggunakan antarmuka untuk mengatur interval maksimum untuk seek akurat. Meningkatkan interval maksimum mengurangi frekuensi peralihan dari seek akurat ke tidak akurat, sehingga meningkatkan akurasi seek. Namun, interval yang lebih panjang berarti operasi seek akan memakan waktu lebih lama jika titik seek jauh dari keyframe. Anda harus mengatur interval maksimum yang wajar untuk seek akurat berdasarkan kebutuhan bisnis Anda. Kode berikut memberikan contohnya:

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

Diagnosis 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 diintegrasikan dalam proyek.

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

   Solusi yang direkomendasikan: Jika Anda menggunakan kedua metode tersebut, hapus library dinamis dan gunakan hanya dependensi Maven. Jika Anda harus mengintegrasikan library dinamis, pastikan semua file .so terkait SDK pemutar berasal dari versi yang sama. Untuk informasi tentang cara mengintegrasikan SDK pemutar dan mendapatkan library dinamis, lihat Integrasikan SDK. Gambar berikut menunjukkan library dinamis terkait pemutar:

3. Jika Anda mengintegrasikan paket parsial, konfirmasi bahwa dependensi versi AlivcFFmpeg benar.

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

Diagnosis masalah sebagai berikut:

1. Konfirmasi apakah crash terjadi di SDK pemutar.

   Periksa adanya stack crash dengan awalan AliyunPlayer. Jika ada stack dengan awalan ini, masalahnya berada di SDK pemutar.

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

3. Jika masalah tetap ada, siapkan file crash terkait (termasuk semua thread), log crash, dan informasi skenario crash. Untuk informasi lebih lanjut, lihat Cara mengambil log masalah.

Diagnosis masalah sebagai berikut:

1. Periksa apakah video sumber itu sendiri memiliki bilah 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. Bilah 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.

Diagnosis masalah sebagai berikut:

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

2. Konfirmasi bahwa view yang merender video dikonfigurasi dengan benar. Misalnya, periksa apakah view tampilan telah diatur untuk pemutar atau telah dihapus dari antarmuka pemutaran. Untuk petunjuk mengatur view tampilan, lihat Langkah 4 di Fitur dasar.

Diagnosis 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 versi sebelumnya, kami menyarankan agar Anda upgrade ke V5.4.6.0-full-15467853 atau versi yang lebih baru. Untuk versi terbaru dan historis SDK pemutar, lihat Catatan rilis SDK Android.

Versi SDK pemutar sebelum V5.4.5.0 tidak mendukung penggunaan pemutar daftar AliListPlayer untuk memutar video HLS (m3u8). Mulai dari V5.4.5.0, video HLS (m3u8) didukung. Namun, Anda harus mengaktifkan caching lokal. Untuk informasi tentang cara mengaktifkan caching lokal, lihat Cache lokal.

Kode berikut memberikan contohnya:

// 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 akan memaksakan pemutaran definisi yang diinginkan. false: Tidak memaksakan pemutaran definisi yang diinginkan. SDK pemutar mencari definisi untuk diputar berdasarkan urutan default. true: Memaksakan pemutaran definisi yang diinginkan. Jika definisi yang diinginkan tidak ditemukan, video tidak diputar.
*/
vidSts.setQuality("",false);