

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

# Ikhtisar Komposisi Sisi Server IVS
<a name="ssc-overview"></a>

Diagram ini menggambarkan cara kerja komposisi sisi server:

![\[Menyiarkan panggung menggunakan komposisi sisi server.\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/images/ssc_Intro_Composite_Recording.png)


## Manfaat
<a name="ssc-benefits"></a>

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 digeser dari perangkat klien individual ke server itu sendiri. Komposisi sisi server 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 intensif sumber daya, yang dapat meningkatkan masa pakai baterai dan pengalaman menonton yang lebih lancar.
+ **Kualitas yang konsisten** — Komposisi sisi server memungkinkan kontrol yang tepat atas kualitas, resolusi, dan bitrate aliran akhir. Ini memastikan pengalaman menonton yang konsisten untuk semua pemirsa, terlepas dari kemampuan perangkat masing-masing.
+ **Ketahanan** — Dengan memusatkan proses komposisi di server, siaran menjadi lebih kuat. Bahkan jika perangkat penerbit mengalami keterbatasan teknis atau fluktuasi, 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 Aliran IVS di Panduan Pengguna Streaming Latensi](https://docs.aws.amazon.com//ivs/latest/LowLatencyUserGuide/multiple-hosts.html) *Rendah IVS*.

## Siklus Hidup Komposisi
<a name="ssc-composition-endpoint"></a>

Gunakan diagram di bawah ini untuk memahami transisi status komposisi:

![\[Siklus hidup sumber daya Komposisi Sisi Server.\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/images/ssc_Composition_Lifecycle.png)


Pada tingkat tinggi, siklus hidup suatu Komposisi adalah sebagai berikut:

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

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

1. Setelah Komposisi dalam keadaan aktif, hal berikut dapat terjadi:
   + Pengguna menghentikan Komposisi - Jika StopComposition operasi dipanggil, IVS memulai penutupan Komposisi yang anggun, mengirimkan peristiwa “Akhir Tujuan” diikuti dengan acara “Akhir Sesi”.
   + Komposisi melakukan shutdown otomatis - Jika tahap IVS dihapus atau tidak ada peserta yang secara aktif mempublikasikan ke tahap IVS selama 60 detik, Komposisi diselesaikan secara otomatis dan acara dikirim. EventBridge 
   + Kegagalan tujuan — Jika tujuan tiba-tiba gagal (misalnya, saluran IVS akan dihapus), tujuan transisi ke `RECONNECTING` status dan acara “Destination Reconnecting” akan dikirim. Jika pemulihan tidak mungkin, IVS mentransisikan tujuan ke `FAILED` negara bagian dan acara “Kegagalan Tujuan” dikirim. IVS membuat komposisi tetap hidup jika setidaknya salah satu tujuannya aktif.

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

## IVS API
<a name="ssc-api"></a>

Komposisi sisi server 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 dan output video ke saluran IVS.
+ *StorageConfiguration*melacak ember 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:

![\[Komposisi sisi server menggunakan dua elemen API utama.\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/images/ssc_IVS_API_Composite_Recording.png)


Untuk informasi selengkapnya, lihat [Referensi API Streaming Waktu Nyata IVS](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/Welcome.html).

## Tata letak
<a name="ssc-api-layouts"></a>

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

Komposisi sisi server merespons peristiwa pertukaran token secara real time. Ketika peserta menukar token untuk memperbarui atribut seperti status unggulan atau penetapan 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. Saat peserta menukar token mereka dengan nilai atribut pesanan yang diperbarui, komposisi akan dirender ulang secara otomatis untuk mencerminkan urutan baru. Ini menghilangkan kebutuhan peserta untuk memutuskan dan menyambung kembali. Untuk informasi selengkapnya, lihat [Token Exchange](broadcast-mobile-token-exchange.md).

### Tata Letak Grid
<a name="ssc-api-layouts-grid"></a>

Tata letak grid mengatur peserta panggung dalam kotak slot berukuran sama. Ini menyediakan beberapa properti yang dapat disesuaikan:
+ `videoAspectRatio`mengatur mode tampilan peserta untuk mengontrol rasio aspek ubin video.
+ `videoFillMode`mendefinisikan bagaimana konten video cocok dalam ubin peserta.
+ `gridGap`menentukan jarak antara ubin peserta dalam piksel.
+ `omitStoppedVideo`memungkinkan mengecualikan aliran video yang dihentikan dari komposisi.
+ `featuredParticipantAttribute`mengidentifikasi slot unggulan. Ketika ini diatur, peserta unggulan ditampilkan dalam slot yang lebih besar di layar utama, dengan peserta lain ditampilkan di bawahnya.
+ `participantOrderAttribute`memungkinkan pemesanan peserta khusus 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 penentuan posisi deterministik opsional dan memungkinkan tata letak berbasis peran.

Untuk detail tentang tata letak kisi (termasuk nilai dan default yang valid untuk semua bidang), lihat tipe data. [GridConfiguration](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_GridConfiguration.html)

![\[Tata letak kisi komposisi sisi server\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/images/ssc_Grid_Layout.png)


### Picture-in-Picture (PiP) Tata Letak
<a name="ssc-api-layouts-pip"></a>

Tata letak PiP memungkinkan menampilkan peserta di jendela overlay dengan ukuran, posisi, dan perilaku yang dapat dikonfigurasi. Properti utama meliputi:
+ `pipParticipantAttribute`menentukan peserta untuk jendela PiP.
+ `pipPosition`menentukan posisi sudut jendela PiP.
+ `pipWidth`dan `pipHeight` konfigurasikan lebar dan tinggi jendela PiP.
+ `pipOffset`mengatur posisi offset jendela PiP dalam piksel dari tepi terdekat.
+ `pipBehavior`mendefinisikan perilaku PiP ketika semua peserta lain telah pergi.

Seperti tata letak kisi, tata letak PiP mendukung`featuredParticipantAttribute`,`omitStoppedVideo`,`videoFillMode`,`gridGap`,, dan `participantOrderAttribute` untuk lebih menyesuaikan komposisi. `participantOrderAttribute`Ini memungkinkan peserta khusus memesan untuk memilih peserta untuk jendela PiP dan memposisikan peserta kisi berdasarkan nilai atribut dalam token peserta.

Untuk detail tentang tata letak PiP (termasuk nilai dan default yang valid untuk semua bidang), lihat tipe data. [PipConfiguration](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_PipConfiguration.html)

![\[Tata letak komposisi sisi server (PiP Picture-in-Picture)\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/images/ssc_PiP_Layout.png)


**Catatan**: Resolusi maksimum yang didukung oleh penerbit panggung pada komposisi sisi server adalah 1080p. Jika penerbit mengirimkan video yang 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*. 