Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
SDK Pemutar Amazon IVS
Untuk menggunakan Amazon Interactive Video Service (IVS), Anda harus menggunakan Amazon IVS Player. Player adalah rangkaian SDK lintas platform untuk pemutaran aliran Amazon IVS. Ini dirancang untuk memanfaatkan arsitektur Amazon IVS dan dioptimalkan untuk pemutaran Amazon IVS.
Satu-satunya pemain yang kinerjanya dapat kami jamin adalah pemain Amazon IVS. Untuk mencapai latensi rendah, pemutar Amazon IVS diperlukan.
Fitur utama dari pemutar Amazon IVS adalah:
-
ltra-low-latency Streaming U — Latensi rendah adalah komponen penting dalam membangun pengalaman pengguna interaktif yang baik yang memperkaya pengalaman audiens. Latensi merayap secara bertahap di seluruh jalur transmisi antara penyiar dan pemirsa, mengikis daya tanggap.
nd-to-end Latensi E adalah penundaan dari saat streaming langsung ditangkap di kamera hingga saat muncul di layar pemirsa. Amazon IVS dirancang untuk memberikan end-to-end latensi ultra-rendah (di bawah lima detik, tergantung pada lokasi siaran dan pengaturan penyiar). Untuk mencapai latensi rendah ini, pemutar Amazon IVS diperlukan.
-
Konsistensi lintas platform — Pemirsa menonton siaran di berbagai platform. Dari perangkat seluler hingga browser web, Amazon IVS Player memberi semua pemirsa pengalaman serupa. Konsistensi ini dimungkinkan karena setiap platform menggunakan perpustakaan fungsi pemain yang sama. Pustaka pemain adalah komponen integral dari arsitektur Amazon IVS. Menggunakan satu tumpukan video memastikan bahwa semua perilaku pemutaran video - termasuk mode latensi rendah, metadata berjangka waktu, analitik, pelacakan kesalahan, pelaporan, dan pencatatan - tersedia secara konsisten di semua platform yang didukung.
-
Adaptive bitrate streaming (ABR) — Amazon IVS Player menggunakan algoritma ABR yang dioptimalkan untuk lingkungan latensi rendah. Player mengukur kualitas layanan dan ketersediaan bandwidth secara real time dan menyesuaikan kualitas video dan tingkat buffer, untuk memberikan pemutaran tanpa gangguan. Ketika kualitas koneksi menurun, ABR beralih ke bitrate yang lebih rendah; ketika kualitas koneksi meningkat, itu beralih ke bitrate yang lebih tinggi.
-
Metadata berwaktu — Amazon IVS Player mendukung metadata berjangka waktu, yang dapat digunakan untuk membangun elemen interaktif seperti jajak pendapat dan kuis. Metadata adalah sekumpulan data yang menjelaskan dan memberikan informasi tentang data lain. Dengan metadata “berjangka waktu”, kode waktu menyertai potongan data tentang aliran. Selama pemutaran, kode waktu berfungsi sebagai titik isyarat untuk memicu tindakan berdasarkan data, seperti:
-
Mengirim statistik pemain untuk aliran olahraga
-
Mengirim detail produk untuk streaming belanja langsung
-
Mengirim pertanyaan untuk streaming kuis langsung
-
-
Penanganan kesalahan yang kuat - Menangani kesalahan sementara dengan baik menghindari gangguan dalam pengalaman menonton. Penanganan kesalahan Amazon IVS Player yang kuat mendeteksi banyak potensi kesalahan streaming, secara otomatis beralih ke rendisi alternatif. Pemirsa terus menonton siaran tanpa gangguan, tanpa harus mengambil tindakan korektif apa pun.
-
Kemudahan integrasi - Amazon IVS Player API menjembatani kesenjangan antara aplikasi pelanggan Amazon IVS dan pustaka Player. API memiliki binding untuk semua platform yang didukung, sehingga mudah untuk mengintegrasikan Player ke dalam aplikasi saat menggunakan lingkungan dan teknik pengkodean yang sudah dikenal. Dengan kontrol penuh atas elemen UI, pelanggan dapat menyesuaikan aspek branding dan presentasi aplikasi mereka.
Pemutar Amazon IVS tidak mendukung casting dengan Airplay. Casting dengan Chromecast dapat diimplementasikan di luar pemutar menggunakan aplikasi penerima Chromecast default. Namun, latensi di aplikasi tersebut lebih tinggi daripada di SDK pemutar Amazon IVS, sehingga sakelar tidak akan mulus. Lihat juga dokumentasi kami di Amazon IVS Broadcast SDK: untuk Streaming Latensi Rendah dan Streaming Waktu Nyata.
Persyaratan Browser & Platform
Untuk detail tentang versi terbaru dari berbagai browser yang dirilis, lihat:
Meskipun Amazon IVS dapat bekerja dengan beberapa browser lama, kami tidak memperbaiki bug yang terkait dengan browser lama.
SDK Web IVS Player (termasuk integrasi Video.js dan Player JW) tidak didukung di lingkungan seperti browser. Ini termasuk Native WebViews dan “perangkat 10 kaki” (TV, konsol, set-top box) yang mendukung aplikasi web. Silakan hubungi Dukungan IVS jika Anda tidak yakin dengan dukungan browser tertentu di luar tabel yang tercantum di bawah ini.
Browser Desktop
| Peramban Desktop | Platform yang Didukung | Versi yang Didukung |
|---|---|---|
| Chrome | Windows, macOS | Dua versi utama (versi sebelumnya saat ini dan terbaru) |
| Firefox | Windows, macOS | Dua versi utama (versi sebelumnya saat ini dan terbaru) |
| Edge | Windows 8.1 dan yang lebih baru | 44.0 dan kemudian (Dalam mode kualitas otomatis di Microsoft Edge Legacy |
| Safari | macOS | Dua versi utama (versi sebelumnya saat ini dan terbaru) (Dalam mode kualitas otomatis di Safari untuk macOS 14 ke atas, IVS Player 1.3.0 ke atas mendukung pemutaran latensi ultra-rendah. Untuk versi Safari dan IVS Player sebelumnya, hanya pemutaran latensi normal yang didukung. Lihat di atas untuk “mode kualitas otomatis.”) |
Browser Seluler
| Browser Seluler | Versi yang Didukung |
|---|---|
| Chrome untuk iOS, Safari untuk iOS | Dua versi utama (versi sebelumnya saat ini dan terbaru) (Pemutaran latensi ultra-rendah tidak didukung. Pemutaran latensi normal didukung. Kendala ini berlaku untuk semua browser untuk iOS.) (Metadata berwaktu hanya didukung di Player 1.3.0 dan yang lebih baru.) |
| Chrome untuk iPadOS, Safari untuk iPadOS | Dua versi utama (versi sebelumnya saat ini dan terbaru) (Ketika “Permintaan Situs Web Seluler” dipilih:
|
| Chrome untuk Android | Dua versi utama (versi sebelumnya saat ini dan terbaru) |
Platform Asli
| Platform | Versi yang Didukung | Perangkat yang Didukung |
|---|---|---|
| Android | 5.0 (Lollipop) dan yang lebih baru | Ponsel dan tablet |
| iOS | 12.0 dan kemudian | Semua |
IVS mendukung minimal 4 versi iOS utama dan 6 versi Android utama. Dukungan versi kami saat ini dapat melampaui batas minimum ini. Pelanggan akan diberi tahu melalui catatan rilis SDK setidaknya 3 bulan sebelum versi utama tidak lagi didukung.
Mengurangi Latensi pada Pemain Pihak Ketiga
Untuk jenis saluran Dasar dan Standar: Untuk latensi serendah mungkin, Anda harus menggunakan pemutar Amazon IVS. Di pemain pihak ketiga (termasuk iOS Safari), Anda dapat mengurangi latensi hingga sekitar 10 detik dengan menggunakan konfigurasi berikut:
-
Atur interval keyframe encoder Anda (misalnya OBS) ke 2 detik atau lebih rendah.
-
Tambahkan
?keyframeInterval=2ke URL RTMP (S). Sebagai contoh:rtmps://a1b2c3d4e5f6.global-contribute.live-video.net:443/app/sk_us-west-2_abcd1234efgh5678ijkl?keyframeInterval=2
Catatan: Interval keyframe yang ditentukan sebagai bagian dari URL RTMP harus lebih besar dari atau sama dengan nilai yang dikonfigurasi dalam encoder; jika tidak, Anda mungkin memiliki masalah pemutaran. Anda dapat mengatur nilai ke bilangan bulat apa pun antara 2 dan 6 inklusif, tetapi 2 memungkinkan latensi terendah.
Untuk jenis saluran Lanjutan: Panduan di atas tidak berlaku. Jenis saluran lanjutan menghasilkan interval keyframe secara otomatis untuk efisiensi pengkodean, dengan paling banyak 2 detik antara keyframe, terlepas dari pengaturan interval keyframe pengkodean sumber.
iOS Safari
Di iOS Safari, Anda dapat mengurangi latensi hingga sekitar 6-8 detik dengan menggunakan pemutar IVS dan mengonfigurasinya untuk menggunakan service worker. Lihat Mengatur Service Worker di Player SDK: Panduan Web untuk detail implementasi dan contoh referensi.
Catatan: Mendapatkan latensi terendah memerlukan aliran IVS dengan interval keyframe disetel ke 2 detik.
Pemutaran Hanya Audio
Semua jenis saluran IVS mendukung rendisi khusus audio. Ini bisa sangat berharga untuk aplikasi seluler. Misalnya, di aplikasi seluler Anda, Anda dapat mengalihkan pemutar ke rendisi audio saja saat pengguna mem-background aplikasi untuk menghemat bandwidth.
Untuk saluran ADVANCED-SD dan ADVANCED-HD, rendisi audio saja disertakan secara otomatis dalam daftar putar multivariant. Untuk saluran BASIC dan STANDARD, Anda harus menambahkan parameter ?allow_audio_only=true kueri ke URL pemutaran untuk mengaktifkan penyertaan rendisi khusus audio.
Catatan: SDK pemutar web IVS hanya mendukung pemutaran audio saja di versi 1.24.0 dan yang lebih baru.
Dukungan
Jika Anda mengalami kesalahan pemutaran atau masalah pemutaran lainnya dengan streaming Anda, tentukan pengenal sesi pemutaran unik melalui API pemutar.
| Untuk pemutar Amazon IVS ini: | Gunakan ini: |
|---|---|
| Android | Fungsi |
| iOS |
|
| Web | Fungsi |
Bagikan pengenal sesi pemutaran ini dengan dukungan AWS. Dengan itu, mereka bisa mendapatkan informasi untuk membantu memecahkan masalah Anda.
Catatan: Pemain terus ditingkatkan. Lihat Catatan Rilis Amazon IVS untuk versi yang tersedia dan masalah yang diperbaiki. Jika perlu, sebelum menghubungi dukungan, perbarui versi Pemain Anda dan lihat apakah itu menyelesaikan masalah Anda.
Versioning
SDK Amazon IVS Player menggunakan versi semantik
Untuk diskusi ini, misalkan:
-
Rilis terbaru adalah 4.1.3.
-
Rilis terbaru dari versi utama sebelumnya adalah 3.2.4.
-
Rilis terbaru versi 1.x adalah 1.5.6.
Fitur baru yang kompatibel dengan mundur ditambahkan sebagai rilis kecil dari versi terbaru. Dalam hal ini, rangkaian fitur baru berikutnya akan ditambahkan sebagai versi 4.2.0.
Perbaikan bug minor yang kompatibel ke belakang ditambahkan sebagai rilis patch dari versi terbaru. Di sini, set perbaikan bug minor berikutnya akan ditambahkan sebagai versi 4.1.4.
Perbaikan bug utama yang kompatibel ke belakang ditangani secara berbeda; ini ditambahkan ke beberapa versi:
-
Patch rilis versi terbaru. Di sini, ini adalah versi 4.1.4.
-
Rilis patch dari versi minor sebelumnya. Di sini, ini adalah versi 3.2.5.
-
Rilis patch dari rilis 1.x versi terbaru. Di sini, ini adalah versi 1.5.7.
Perbaikan bug utama ditentukan oleh tim produk Amazon IVS. Contoh umum adalah pembaruan keamanan penting dan perbaikan lain yang dipilih yang diperlukan untuk pelanggan.
Catatan: Dalam contoh di atas, versi yang dirilis meningkat tanpa melewatkan angka apa pun (misalnya, dari 4.1.3 ke 4.1.4). Pada kenyataannya, satu atau lebih nomor patch mungkin tetap internal dan tidak dirilis, sehingga versi yang dirilis dapat meningkat dari 4.1.3 menjadi, katakanlah, 4.1.6.
