ApsaraVideo VOD：FAQ tentang Player SDK untuk Web

Masalah terkait lisensi

Untuk masalah seperti lisensi tidak valid atau kedaluwarsa, lihat FAQ Lisensi.

Masalah umum lintas platform

• Masalah lintas platform dirangkum dalam FAQ tentang Player SDK.

• Jika Anda memiliki pengalaman pengembangan, Anda dapat memperbaiki kesalahan pemutaran secara mandiri.

Masalah pengembangan

Bagaimana cara mengubah nilai parameter vid dan playauth di pemain HTML5?

 player.replayByVidAndPlayAuth(newVid, newPlayAuth)

Bagaimana cara mengubah ukuran dan lokasi tombol putar di pemain HTML5?

• Untuk mengubah ukuran tombol putar, tulis ulang kode CSS. Contoh berikut menunjukkan cara mengurangi ukuran tombol menjadi setengahnya. Contoh kode:

   .prism-player .prism-big-play-btn {
      width: 45px;
      height: 45px;
      background-size: 128px 256px;
  }

• Untuk mengubah lokasi tombol putar, ubah nilai properti x dan y pada parameter bigPlayButton dari skinLayout. Contoh kode:

  skinLayout: [
    { name: "bigPlayButton", align: "blabs", x: 30, y: 80 },
    {
      name: "H5Loading",
      align: "cc",
    },
    {
      name: "controlBar",
      align: "blabs",
      x: 0,
      y: 0,
      children: [
        { name: "progress", align: "tlabs", x: 0, y: 0 },
        { name: "playButton", align: "tl", x: 15, y: 26 },
        { name: "timeDisplay", align: "tl", x: 10, y: 24 },
        { name: "fullScreenButton", align: "tr", x: 20, y: 25 },
        { name: "volume", align: "tr", x: 20, y: 25 },
      ],
    },
  ]

Bagaimana saya bisa mengimplementasikan putar/jeda di pemain HTML5 setelah memanggil metode seek?

Panggil metode player.pause() setelah memanggil metode seek untuk mengaktifkan fitur jeda. Jika video sudah dijeda, Anda dapat menekan tombol untuk memutar video.

Bagaimana cara menentukan waktu mulai untuk pemutaran video di pemain?

Gunakan parameter watchStartTime untuk menentukan waktu mulai pemutaran video. Contoh kode:

new Aliplayer({
  watchStartTime: 60, // Mulai dari detik ke-60.
})

Untuk informasi lebih lanjut, lihat Deskripsi API Aliplayer.

Bagaimana cara mengaktifkan putar otomatis dalam mode layar penuh?

var player = new Aliplayer(
  {
    id: "player-con",
    source: "//example.aliyundoc.com/video/media02.mp4",
    width: "100%",
    height: "500px",
    autoplay: true,
    qualitySort: "asc",
    mediaType: "video",
    preload: true,
    isLive: false,
  },
  function (player) {
    player.mute();
    console.log("Pemain telah dibuat");
  }
);
player.on("ready", function () {
  player.fullscreenService.requestFullScreen();
});

Bagaimana cara menonaktifkan pencarian pada bilah kemajuan?

Gunakan parameter disableSeek: true untuk menonaktifkan pencarian pada bilah kemajuan. Untuk informasi lebih lanjut, lihat Nonaktifkan pencarian pada bilah kemajuan.

Bagaimana cara mendapatkan waktu pemutaran secara berkala?

Gunakan metode getCurrentTime setiap detik dengan timer untuk mendapatkan waktu pemutaran. Hapus timer ketika pemutaran video dijeda, gagal, atau berakhir.

var timer = null;

timer = setInterval(() => {
  var current = player.getCurrentTime();
  console.log(current);
}, 1000);

// Hapus timer.
function clear() {
  if (timer) {
    clearTimeout(timer);
    timer = null;
  }
}
player.on("ended", function (e) {
  clear();
});
player.on("pause", function (e) {
  clear();
});
player.on("error", function (e) {
  clear();
});

Masalah pemutaran dan kesalahan

Apa yang harus saya lakukan jika video yang dikodekan dengan H.265 tidak dapat diputar?

Player SDK untuk Web V2.14.0 atau yang lebih baru mendukung pemutaran aliran video yang dikodekan dengan H.265. Ajukan permohonan lisensi dan konfigurasikan parameter untuk mengaktifkan fitur H.265. Untuk informasi lebih lanjut, lihat Putar video H.265 dan H.266.

Apa yang harus saya lakukan jika terjadi kesalahan lintas asal saat saya menggunakan pemain HTML5 untuk memutar file FLV atau M3U8?

Jika muncul pesan "Akses ditolak untuk dokumen ini" atau terjadi kesalahan terkait "Access-Control-Allow-Origin", aktifkan CORS untuk domain pemutaran Anda. Untuk informasi lebih lanjut, lihat Konfigurasi CORS.

Apa yang harus saya lakukan jika video tidak dapat diputar dalam mode lanskap di pemain HTML5?

Tidak ada operasi API yang disediakan di Player SDK untuk mengaktifkan pemutaran dalam mode lanskap. Untuk perangkat iOS, mode lanskap dapat diaktifkan di pengaturan sistem. Untuk perangkat Android, video secara otomatis diputar dalam mode lanskap setelah pengguna mengaktifkan mode layar penuh.

Apa yang harus saya lakukan jika header Referer tidak termasuk dalam permintaan saat saya menggunakan pemain HTML5 untuk memutar video FLV?

1. Periksa apakah Anda telah menentukan bahwa header Referer dapat disertakan dalam permintaan di situs web Anda. Untuk informasi lebih lanjut, lihat Kebijakan Referrer. Saat pemain memulai permintaan, kebijakan Referer yang Anda tentukan untuk situs web akan digunakan sebagai prioritas.

2. Jika Anda telah menentukan bahwa header Referer dapat disertakan tetapi tidak ada header Referer yang disertakan dalam permintaan, konfigurasikan parameter enableWorker: false di pemain. Jika Anda telah mengaktifkan kontrol akses berbasis ACL menggunakan Referer tetapi tidak ada header Referer yang disertakan, pemutaran video mungkin dilarang.

Apa yang harus saya lakukan jika bilah hitam ditampilkan saat saya menggunakan pemain HTML5 untuk memutar video?

Bilah hitam menunjukkan warna latar belakang wadah pemain. Untuk menyelesaikan masalah ini, konfigurasikan properti CSS object-fit: cover; untuk tag video.

Apa yang harus saya lakukan jika loadByUrl tidak dapat dipanggil di perangkat iOS atau Android?

// Metode seek hanya mengarahkan pengguna ke posisi yang ditentukan dalam operasi loadByUrl. Namun, video tidak dapat diputar.
// Jika Anda memanggil metode play di perangkat iOS, video diputar ulang dari awal.
// Video yang diputar dalam mode layar penuh di perangkat iOS dipaksa diputar di pemain bawaan.

document.querySelector(".no1").onclick = function () {
  player.loadByUrl("//player.alicdn.com/resource/player/qupai.mp4");
};

 // Panggil metode seek dalam event play dan canplay. Metode seek mungkin tidak berlaku untuk browser tertentu. Dalam hal ini, panggil metode seek dalam event timeupdate pertama kali.
player.on("canplay", function () {
  player.seek(20);
});
 // Anda tidak dapat menyelesaikan masalah di mana video yang diputar dalam mode layar penuh di perangkat iOS diambil alih oleh pemain bawaan.

Apa yang harus saya lakukan jika video sebelumnya masih diputar setelah sumber video diubah?

Deskripsi masalah: Di Windows 10, operasi loadByUrl di Player SDK untuk Web 2.9.11 tidak normal dalam mode kompatibilitas di 360 Secure Browser. Setelah sumber video diubah, video sebelumnya masih diputar.

Penyebab: Kompatibilitas browser.

Solusi: Gunakan Player SDK untuk Web 2.9.19 atau yang lebih baru.

Apa yang harus saya lakukan jika metode player.seek() tidak berlaku untuk perangkat iOS?

 // Panggil metode player.seek() dalam event play dan canplay. Jika tidak, metode tersebut mungkin tidak berlaku.
player.on("canplay", function () {
  player.seek(20);
});

Bagaimana cara mendapatkan klip terbaru setelah streaming langsung dilanjutkan?

Deskripsi Masalah

Jika Anda beralih aplikasi ke latar belakang saat memutar streaming langsung, pemutaran dijeda. Setelah Anda kembali ke aplikasi, streaming langsung terus diputar dari titik waktu di mana jeda terjadi. Apakah ada konfigurasi yang dapat dilakukan untuk mengurangi latensi pemutaran sehingga klip terbaru dapat diputar setelah pemutaran dilanjutkan?

Solusi

Setelah melanjutkan pemutaran, streaming langsung terus diputar dari titik waktu di mana jeda terjadi. Anda tidak dapat mengonfigurasi parameter untuk mempercepat pemutaran. Kami merekomendasikan agar Anda menarik ulang streaming langsung dan menggunakan pemain untuk memutar ulang streaming langsung.

Bagaimana cara menggunakan Player untuk Web untuk memutar video di WeChat mini program?

Player untuk Web tidak mendukung WeChat mini-program. Anda harus menggunakan pemain bawaan untuk memutar video di WeChat mini program. Untuk informasi lebih lanjut tentang demo, lihat Uji coba online dan kode sumber demo.

Apa yang harus saya lakukan jika penarikan aliran lintas asal gagal?

Jika verifikasi lintas asal lokal gagal, periksa halaman Nama Domain di konsol. Jika hanya nama domain kustom yang dikonfigurasi, kesalahan localhost mungkin dilaporkan. Secara default, jika Anda tidak mengonfigurasi nama domain, localhost akan lolos verifikasi.

Apa yang harus saya lakukan jika video yang diunggah ke ApsaraVideo VOD dapat diputar di semua perangkat kecuali perangkat iOS?

Penyebab: Kompatibilitas Safari di perangkat iOS terbatas. Video mungkin gagal diputar di Safari jika video sangat terkompresi atau profil pengkodean video tinggi.

Solusi: Kami merekomendasikan agar Anda melakukan transkoding video sebelum pemutaran. Untuk informasi lebih lanjut, lihat Transkoding audio dan video.

FAQ tentang platform

Bagaimana cara menghapus thumbnail default WebView?

Deskripsi masalah: Di ponsel Android tertentu, jika Anda tidak menentukan properti poster untuk tag <video>, thumbnail default ditampilkan. Gambar berikut menunjukkan thumbnail default.

Solusi: Jika ingin menghapus thumbnail default, tentukan properti poster yang tidak valid untuk tag <video> untuk menimpa konfigurasi thumbnail default. Contoh kode:

extraInfo: { poster: 'noposter' } // Informasi yang terkandung dalam parameter pemain extraInfo dilewatkan ke tag <video>.

Bagaimana cara menampilkan konten dalam mode tertinggi yang tersedia di Internet Explorer?

<meta http-equiv="x-ua-compatible" content="IE=edge" >

Bagaimana cara mengaktifkan fitur putar otomatis di WeChat?

<script src="http://res.wx.qq.com/open/js/jweixin-1.0.0.js"></script>
<script>
function autoPlay() {            
wx.config({
                // Informasi konfigurasi. Metode wx.ready tersedia bahkan jika informasi konfigurasi tidak valid.
                debug: false,
                appId: '',
                timestamp: 1,
                nonceStr: '',
                signature: '',
                jsApiList: []
            });
            wx.ready(function() {
                var video=$(player.el()).find('video')[0];
                video.play();
            });
    };
    // Aktifkan pemutaran video otomatis di perangkat iOS.
    autoPlay();
</script>