View a markdown version of this page

Ikhtisar Komposisi IVS Server-Side - Amazon IVS
ManfaatSiklus Hidup KomposisiIVS APITata Letak

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

Ikhtisar Komposisi IVS Server-Side

Diagram ini menggambarkan bagaimana komposisi sisi server bekerja:

Menyiarkan panggung menggunakan komposisi sisi server.

Manfaat

Dibandingkan dengan komposisi sisi klien, komposisi sisi server memiliki manfaat sebagai berikut:

  • Mengurangi beban klien — Dengan komposisi sisi server, beban pemrosesan dan penggabungan sumber audio dan video bergeser dari perangkat klien individu ke server itu sendiri. Server-sidekomposisi menghilangkan kebutuhan perangkat klien untuk menggunakan CPU dan sumber daya jaringan mereka untuk menyusun tampilan dan mengirimkannya ke IVS. Ini berarti pemirsa dapat menonton siaran tanpa perangkat mereka harus menangani tugas-tugas padat sumber daya, yang dapat meningkatkan masa pakai baterai dan pengalaman menonton yang lebih lancar.

  • Kualitas yang konsisten — Server-side komposisi memungkinkan kontrol yang tepat atas kualitas, resolusi, dan bitrate aliran akhir. Ini memastikan pengalaman menonton yang konsisten untuk semua pemirsa, terlepas dari kemampuan masing-masing perangkat mereka.

  • Ketahanan — Dengan memusatkan proses komposisi di server, siaran menjadi lebih kuat. Bahkan jika perangkat penerbit mengalami keterbatasan atau fluktuasi teknis, server dapat beradaptasi dan memberikan aliran yang lebih lancar kepada semua anggota audiens.

  • Efisiensi bandwidth — Karena server menangani komposisi, penerbit panggung tidak perlu menghabiskan bandwidth ekstra untuk menyiarkan video ke IVS.

Atau, untuk menyiarkan panggung ke saluran IVS, Anda dapat melakukan komposisi sisi klien; lihat Mengaktifkan Beberapa Host pada Streaming IVS di Panduan Pengguna Stre Low-Latency aming IVS.

Siklus Hidup Komposisi

Gunakan diagram di bawah ini untuk memahami transisi keadaan suatu komposisi:

Siklus hidup sumber daya Server-Side Komposisi.

Pada tingkat tinggi, siklus hidup Komposisi adalah sebagai berikut:

  1. Sumber daya Komposisi dibuat ketika pengguna memanggil StartComposition operasi.

  2. Setelah IVS berhasil memulai Komposisi, EventBridge acara “Perubahan Status Komposisi IVS (Mulai Sesi)” dikirim. Lihat Menggunakan EventBridge dengan IVS Real-Time Streaming untuk detail tentang acara.

  3. Setelah Komposisi dalam keadaan aktif, hal berikut dapat terjadi:

    • Pengguna menghentikan Komposisi — Jika StopComposition operasi dipanggil, IVS memulai shutdown Komposisi yang anggun, mengirimkan peristiwa “Akhir Tujuan” diikuti oleh peristiwa “Akhir Sesi”.

    • Komposisi melakukan shutdown otomatis — Jika tahap IVS dihapus atau tidak ada peserta yang secara aktif menerbitkan ke tahap IVS selama 60 detik, Komposisi diselesaikan secara otomatis dan EventBridge acara dikirim.

    • Kegagalan tujuan — Jika tujuan gagal secara tak terduga (misalnya, saluran IVS dihapus), transisi tujuan ke RECONNECTING status dan peristiwa “Koneksi Ulang Tujuan” dikirim. Jika pemulihan tidak mungkin, IVS mengalihkan tujuan ke FAILED status dan peristiwa “Kegagalan Tujuan” dikirim. IVS menjaga komposisi tetap hidup jika setidaknya salah satu tujuannya aktif.

  4. Setelah komposisi dalam FAILED keadaan STOPPED atau, secara otomatis dibersihkan setelah lima menit. (Maka itu tidak lagi diambil oleh ListCompositions atau GetComposition.)

IVS API

Server-side komposisi menggunakan elemen API utama ini:

  • Sebuah EncoderConfiguration objek memungkinkan Anda untuk menyesuaikan format video yang akan dihasilkan (tinggi, lebar, bitrate, dan parameter streaming lainnya). Anda dapat menggunakan kembali EncoderConfiguration setiap kali Anda memanggil StartComposition operasi.

  • Operasi komposisi melacak komposisi video dan output ke saluran IVS.

  • StorageConfigurationmelacak bucket S3 tempat komposisi direkam.

Untuk menggunakan komposisi sisi server, Anda perlu membuat EncoderConfiguration dan melampirkannya saat memanggil operasi. StartComposition Dalam contoh ini, SquareVideo EncoderConfiguration digunakan dalam dua Komposisi:

Server-side komposisi menggunakan dua elemen API kunci.

Untuk informasi lengkap, lihat Refer ensi API Real-Time Streaming IVS.

Tata Letak

StartComposition Operasi ini menawarkan dua opsi tata letak: grid dan PiP (Picture-in-Picture).

Server-side komposisi merespons peristiwa pertukaran token secara real time. Ketika peserta menukar token untuk memperbarui atribut seperti status unggulan atau penugasan PiP, tata letak komposisi diperbarui secara otomatis tanpa mengharuskan peserta untuk meninggalkan dan bergabung kembali dengan panggung.

Anda juga dapat menggunakan pertukaran token untuk mengubah pesanan peserta selama komposisi langsung. Ketika peserta menukar token mereka dengan nilai atribut pesanan yang diperbarui, komposisi akan ditampilkan ulang secara otomatis untuk mencerminkan urutan baru. Ini menghilangkan kebutuhan peserta untuk memutuskan sambungan dan menyambung kembali. Untuk informasi selengkapnya, lihat Token Exchange.

Tata Letak Grid

Tata letak grid mengatur peserta panggung dalam kotak slot berukuran sama. Ini menyediakan beberapa properti yang dapat disesuaikan:

  • videoAspectRatiomengatur mode tampilan peserta untuk mengontrol rasio aspek ubin video.

  • videoFillModemenentukan bagaimana konten video cocok dengan ubin peserta.

  • gridGapmenentukan jarak antara ubin peserta dalam piksel.

  • omitStoppedVideomemungkinkan mengecualikan aliran video yang dihentikan dari komposisi.

  • featuredParticipantAttributemengidentifikasi slot unggulan. Ketika ini diatur, peserta unggulan ditampilkan di slot yang lebih besar di layar utama, dengan peserta lain ditampilkan di bawahnya.

  • participantOrderAttributememungkinkan pemesanan peserta kustom berdasarkan nilai atribut dalam token peserta. Ketika ditentukan, peserta diurutkan secara numerik berdasarkan nilai atribut mereka, dengan peserta yang tidak memiliki atribut kembali ke urutan waktu kedatangan. Ini memberikan posisi deterministik opsional dan memungkinkan tata letak berbasis peran.

Untuk detail tata letak grid (termasuk nilai yang valid dan default untuk semua bidang), lihat tipe GridConfiguration data.

Server-side komposisi tata letak grid

Picture-in-Picture (PiP) Tata Letak

Tata letak PiP memungkinkan menampilkan peserta di jendela overlay dengan ukuran, posisi, dan perilaku yang dapat dikonfigurasi. Properti utama meliputi:

  • pipParticipantAttributemenentukan peserta untuk jendela PiP.

  • pipPositionmenentukan posisi sudut jendela PiP.

  • pipWidthdan pipHeight konfigurasikan lebar dan tinggi jendela PiP.

  • pipOffsetmengatur posisi offset jendela PiP dalam piksel dari tepi terdekat.

  • pipBehaviormendefinisikan perilaku PiP ketika semua peserta lain telah pergi.

Seperti tata letak grid, tata letak PiP mendukung featuredParticipantAttributeomitStoppedVideo,videoFillMode,gridGap,, dan participantOrderAttribute untuk lebih menyesuaikan komposisi. Ini participantOrderAttribute memungkinkan pemesanan peserta khusus untuk memilih peserta untuk jendela PiP dan memposisikan peserta grid berdasarkan nilai atribut dalam token peserta.

Untuk detail tata letak PiP (termasuk nilai dan default yang valid untuk semua bidang), lihat tipe PipConfiguration data.

Server-side tata letak komposisi Picture-in-Picture (PiP)

Catatan: Resolusi maksimum yang didukung oleh penerbit panggung pada komposisi sisi server adalah 1080p. Jika penerbit mengirim video lebih tinggi dari 1080p, penerbit akan ditampilkan sebagai peserta khusus audio.

Penting: Pastikan aplikasi Anda tidak bergantung pada fitur spesifik dari tata letak saat ini, seperti ukuran dan posisi ubin. Perbaikan visual pada tata letak dapat diperkenalkan kapan saja.