View a markdown version of this page

IVS Player SDK: Integrasi Pemain JW - Amazon IVS
MemulaiPeristiwaKesalahanKebijakan Keamanan KontenBatasan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

IVS Player SDK: Integrasi Pemain JW

Dokumen ini menjelaskan fungsi terpenting yang tersedia dalam integrasi JW Player Amazon Interactive Video Service (IVS).

Versi terbaru integrasi JW Player: 1.55.0 (Catatan R ilis)

Memulai

Dukungan Amazon IVS untuk JW Player diimplementasikan melalui Penyedia. Penyedia Amazon IVS hanya didukung pada pemutar web JW Player. Penyedia dimuat melalui tag skrip, dan semua aliran yang memerlukan pemutaran Penyedia Amazon IVS harus diberi tag type: 'ivs' di daftar putar. Amazon IVS mendukung JW Player versi 8.18.4 dan yang lebih baru.

Pengaturan

Dalam instruksi ini, JW_PLAYER_DIV adalah nama instance JW Player Anda dan IVS_STREAM URL pemutaran IVS Anda. <div> Untuk mengatur Penyedia Amazon IVS dan mengaktifkan pemutaran:

  1. Sertakan script tag berikut (untuk versi terbaru dari integrasi pemain; dalam hal ini, 1.55.0):

    <script src="https://player.live-video.net/1.55.0/amazon-ivs-jw-provider.min.js"></script>

  2. Gunakan ivs jenis untuk menandai item daftar putar IVS Anda. Tetapkan cast nilai di setup() ke Anda null (karena Chromecast tidak didukung).

    jwplayer(JW_PLAYER_DIV).setup({
   playlist: [{
      file:IVS_STREAM,
      type: 'ivs',
   }]
});

  3. Jika Anda ingin referensi ke Amazon IVS Player yang mendasarinya untuk melakukan panggilan API Amazon IVS Player atau Anda ingin referensi ke IVS-specific enum Amazon untuk penanganan panggilan balik, tambahkan pendengar ke acara tersebut: 'providerPlayer'

    jwplayer(JW_PLAYER_DIV).on('providerPlayer', function (player) {
   // player object has 'ivsPlayer' and 'ivsEvents' properties
   // ...callback code...
});

Kode Sampel

Dalam contoh ini, JW_PLAYER_LIB adalah URL ke skrip pustaka JW Player Anda dan IVS_STREAM merupakan URL pemutaran IVS Anda.

<!DOCTYPE html>
<html lang="en">
<head>
   <script src=JW_PLAYER_LIB></script>
   <script src="https://player.live-video.net/1.55.0/amazon-ivs-jw-provider.min.js"></script>
</head>
<body>
   <div id='player'></div>
   <script>
      // set default values for ivsPlayer and ivsEvents
      var ivsPlayer = {};
      var ivsEvents = {};

      // define our player setup
      const ivsConfig = {
         playlist: [{
            file: IVS_STREAM,
            type: 'ivs',
         }]
      };

      jwplayer('player')
         .setup(ivsConfig)
         .on('providerPlayer', function (player) {
            console.log('Amazon IVS Player: ', player.ivsPlayer);
            console.log('Amazon IVS Player Events: ', player.ivsEvents);

            // store the reference to the Amazon IVS Player
            ivsPlayer = player.ivsPlayer;
            // store the reference to the Amazon IVS Player Events
            ivsEvents = player.ivsEvents;
         });
   </script>
</body>
</html>

Peristiwa

Untuk mendengarkan acara JW Player standar, gunakan fungsi on dari JW Player.

Untuk mendengarkan acara yang khusus untuk Amazon IVS, atau untuk menambah dan menghapus pendengar acara di pemutar Web Amazon IVS, Anda harus mendengarkan 'providerPlayer' acara tersebut untuk mendapatkan referensi ke Amazon IVS Player dan kemudian menambahkan acara mendengarkan ke dalamnya. Contoh:

// store a default value for ivsPlayer
var ivsPlayer = {};

// store references to the Amazon IVS Player and Amazon IVS Events:
jwplayer(JW_PLAYER_DIV).on('providerPlayer', function (player) {
   ivsPlayer = player.ivsPlayer;
});

// set up event listening
ivsPlayer.addEventListener(event, callback);
ivsPlayer.removeEventListener(event, callback);

callbackdimana callback yang Anda definisikan, dan event merupakan salah satu dari:PlayerEventType,PlayerState, atauErrorType. Untuk informasi selengkapnya tentang acara, lihat Amazon IVS Player SDK: Refer ensi Web.

A 'providerPlayer' cara ini dipancarkan oleh JW Player, dan panggilan balik yang Anda daftarkan dengannya akan menerima objek dengan bidang berikut:

Bidang Deskripsi

ivsPlayer

Mengembalikan instance pemutar Amazon IVS yang mendasarinya. Amazon IVS Player Web API lengkap tersedia melalui instance ini. Sebaiknya gunakan API pemutaran JW Player dasar sebanyak mungkin, dan menggunakan fungsi ini hanya untuk mengakses IVS-specific fitur Amazon. Fungsi paling umum yang mungkin perlu Anda akses di instance pemutar Amazon IVS adalah addEventListener() danremoveEventListener().

ivsEvents

Mengembalikan objek denganPlayerEventType,PlayerState, dan ErrorType bidang, yang dipetakan ke IVS-specific enum Amazon terkait. Untuk informasi selengkapnya, lihat Amazon IVS Player SDK: Refer ensi Web.

Kesalahan

Untuk kesalahan umum JW Player, gunakan fungsi on dari JW Player untuk mendengarkan peristiwa kesalahan.

Untuk kesalahan khusus untuk Amazon IVS, dengarkan di pemutar Amazon IVS untuk kesalahannya sendiri:

// set default values for ivsPlayer and ivsEvents
var ivsPlayer = {};
var ivsEvents = {};

// store references to the Amazon IVS Player and Amazon IVS Events
jwplayer(JW_PLAYER_DIV).on('providerPlayer', function (player) {
   ivsPlayer = player.ivsPlayer;
   ivsEvents = player.ivsEvents;
});

// set up event listening:
let playerEvent = ivsEvents.PlayerEventType;
ivsPlayer.addEventListener(playerEvent.ERROR, callback);

Panggilan balik akan menerima objek dengan bidang berikut:

Bidang Deskripsi

type

Jenis kesalahan. Sesuai dengan ErrorType peristiwa. Untuk informasi selengkapnya, lihat Amazon IVS Player SDK: Refer ensi Web.

code

Kode kesalahan.

source

Sumber kesalahan.

message

Pesan kesalahan yang dapat dibaca manusia.

Kebijakan Keamanan Konten

Amazon IVS Provider API dikonfigurasi untuk bekerja pada halaman yang menggunakan Kebijakan Keamanan Konten (CSP). Lihat bagian “Bekerja dengan Kebijakan Keamanan Konten” diIVS Player SDK: Panduan Web.

Batasan

Penyedia tidak mendukung casting. Jika Anda mengaktifkan casting di dasbor JW Player, Anda dapat menonaktifkannya dengan menyetel cast ke null saat menelep setup() on. Ini menyembunyikan tombol casting.