Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Komposisi Sisi Server IVS \$1 Streaming Waktu Nyata Komposisi sisi server menggunakan server IVS untuk mencampur audio dan video dari semua peserta panggung dan kemudian mengirimkan video campuran ini ke saluran IVS (misalnya, untuk menjangkau audiens yang lebih besar) atau bucket S3. Komposisi sisi server dipanggil melalui operasi pesawat kontrol IVS di wilayah asal panggung. Menyiarkan atau merekam panggung menggunakan komposisi sisi server menawarkan banyak manfaat, menjadikannya pilihan yang menarik bagi pengguna yang mencari alur kerja video berbasis cloud yang efisien dan andal. **Topics** + [Ikhtisar Komposisi Sisi Server IVS](ssc-overview.md) + [Memulai dengan Komposisi Sisi Server IVS](ssc-getting-started.md) + [Pemesanan Peserta Kustom](ssc-getting-started-custom-participant-ordering.md) + [Mengaktifkan Berbagi Layar dalam Komposisi Sisi Server IVS](ssc-getting-started-screen-share.md) + [Masalah dan Solusi yang Diketahui](ssc-known-issues.md) # Ikhtisar Komposisi Sisi Server IVS 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 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 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 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). ## Layout StartComposition Operasi ini menawarkan dua opsi tata letak: grid dan pip (Picture-in-Picture). ### Tata Letak Grid 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 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*. # Memulai dengan Komposisi Sisi Server IVS Dokumen ini membawa Anda melalui langkah-langkah yang terlibat dalam memulai dengan komposisi sisi server IVS. ## Prasyarat Untuk menggunakan komposisi sisi server, Anda harus memiliki panggung dengan penerbit aktif dan menggunakan saluran and/or IVS bucket S3 sebagai tujuan komposisi. Untuk membuat bucket S3, lihat dokumentasi S3 tentang [cara membuat](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html) bucket. Bucket S3 harus dibuat di wilayah AWS yang sama dengan tahap IVS. **Penting**: Jika Anda menggunakan bucket S3 yang ada: + Pengaturan **Kepemilikan Objek** harus **diberlakukan oleh pemilik Bucket** atau **pemilik Bucket lebih disukai**. + Pengaturan **Enkripsi Default** harus berupa **enkripsi sisi server dengan kunci terkelola Amazon S3 (SSE-S3**). Untuk detailnya, lihat dokumentasi S3 tentang [mengendalikan kepemilikan objek](https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html) dan [melindungi data dengan enkripsi](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingEncryption.html). ## Instruksi API Di bawah ini, kami menjelaskan satu kemungkinan alur kerja yang menggunakan EventBridge peristiwa untuk memulai komposisi yang menyiarkan panggung ke saluran IVS saat peserta menerbitkan. Atau, Anda dapat memulai dan menghentikan komposisi berdasarkan logika aplikasi Anda sendiri. Lihat [Perekaman Komposit](rt-composite-recording.md) untuk contoh lain yang menampilkan penggunaan komposisi sisi server untuk merekam panggung langsung ke bucket S3. 1. Buat saluran IVS. Lihat [Memulai dengan Streaming Latensi Rendah Amazon IVS](https://docs.aws.amazon.com//ivs/latest/LowLatencyUserGuide/getting-started.html). 1. Buat tahap IVS dan token peserta untuk setiap penerbit. 1. Buat [EncoderConfiguration](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_EncoderConfiguration.html). 1. Bergabunglah dengan panggung dan publikasikan ke sana. (Lihat bagian “Penerbitan dan Berlangganan” dari panduan SDK siaran streaming real-time: [Web](https://docs.aws.amazon.com//ivs/latest/RealTimeUserGuide/web-publish-subscribe.html), [Android](https://docs.aws.amazon.com//ivs/latest/RealTimeUserGuide/android-publish-subscribe.html), dan [iOS](https://docs.aws.amazon.com//ivs/latest/RealTimeUserGuide/ios-publish-subscribe.html).) 1. Saat Anda menerima EventBridge acara Peserta Diterbitkan, hubungi [StartComposition](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_StartComposition.html)dengan konfigurasi tata letak yang Anda inginkan. 1. Tunggu beberapa detik dan lihat tampilan gabungan di pemutaran saluran. ![\[Alur kerja komposisi sisi server yang menggunakan EventBridge peristiwa untuk memulai komposisi saat peserta menerbitkan.\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/images/ssc_Workflow.png) **Catatan**: Komposisi melakukan shutdown otomatis setelah 60 detik tidak aktif dari peserta penerbit di atas panggung. Pada saat itu, Komposisi dihentikan dan transisi ke keadaan. `STOPPED` Komposisi secara otomatis dihapus setelah beberapa menit di `STOPPED` negara bagian. ## Instruksi CLI Menggunakan AWS CLI adalah opsi lanjutan dan mengharuskan Anda mengunduh dan mengonfigurasi CLI terlebih dahulu di mesin Anda. Untuk detail, lihat [Panduan Pengguna AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html). Sekarang Anda dapat menggunakan CLI untuk membuat dan mengelola sumber daya. Operasi Komposisi berada di bawah `ivs-realtime` namespace. ### Buat Sumber EncoderConfiguration Daya An EncoderConfiguration adalah objek yang memungkinkan Anda untuk menyesuaikan format video yang dihasilkan (tinggi, lebar, bitrate, dan parameter streaming lainnya). Anda dapat menggunakan kembali EncoderConfiguration setiap kali Anda memanggil operasi Komposisi, seperti yang dijelaskan pada langkah berikutnya. Perintah di bawah ini membuat EncoderConfiguration sumber daya yang mengonfigurasi parameter komposisi video sisi server seperti bitrate video, kecepatan bingkai, dan resolusi: ``` aws ivs-realtime create-encoder-configuration --name "MyEncoderConfig" --video "bitrate=2500000,height=720,width=1280,framerate=30" ``` Tanggapannya adalah: ``` { "encoderConfiguration": { "arn": "arn:aws:ivs:us-east-1:927810967299:encoder-configuration/9W59OBY2M8s4", "name": "MyEncoderConfig", "tags": {}, "video": { "bitrate": 2500000, "framerate": 30, "height": 720, "width": 1280 } } } ``` ### Mulai Komposisi Menggunakan EncoderConfiguration ARN yang disediakan dalam respons di atas, buat sumber daya Komposisi Anda: **Contoh Tata Letak Grid** ``` aws ivs-realtime start-composition --stage-arn "arn:aws:ivs:us-east-1:927810967299:stage/8faHz1SQp0ik" --destinations '[{"channel": {"channelArn": "arn:aws:ivs:us-east-1:927810967299:channel/DOlMW4dfMR8r", "encoderConfigurationArn": "arn:aws:ivs:us-east-1:927810967299:encoder-configuration/9W59OBY2M8s4"}}]' --layout '{"grid":{"participantOrderAttribute":"order","featuredParticipantAttribute":"isFeatured","videoFillMode":"COVER","gridGap":0}}' ``` **Contoh Tata Letak PiP** ``` aws ivs-realtime start-composition --stage-arn "arn:aws:ivs:us-east-1:927810967299:stage/8faHz1SQp0ik" --destinations '[{"channel": {"channelArn": "arn:aws:ivs:us-east-1:927810967299:channel/DOlMW4dfMR8r", "encoderConfigurationArn": "arn:aws:ivs:us-east-1:927810967299:encoder-configuration/DEkQHWPVaOwO"}}]' --layout '{"pip":{"participantOrderAttribute":"priority","pipParticipantAttribute":"isPip","pipOffset":10,"pipPosition":"TOP_RIGHT"}}' ``` **Catatan**: Anda dapat menggunakan [alat ini](https://composition.ivsdemos.com/) untuk lebih mudah menghasilkan `--layout` konfigurasi berdasarkan pilihan tata letak Anda. Tanggapan akan menunjukkan bahwa Komposisi dibuat dengan `STARTING` status. Setelah Komposisi mulai menerbitkan komposisi, status bertransisi ke`ACTIVE`. (Anda dapat melihat status dengan memanggil ListCompositions atau GetComposition operasi.) Setelah Komposisi`ACTIVE`, tampilan komposit tahap IVS terlihat di saluran IVS, menggunakan: ListCompositions ``` aws ivs-realtime list-compositions ``` Tanggapannya adalah: ``` { "compositions": [ { "arn": "arn:aws:ivs:us-east-1:927810967299:composition/YVoaXkKdEdRP", "destinations": [ { "id": "bD9rRoN91fHU", "startTime": "2023-09-21T15:38:39+00:00", "state": "ACTIVE" } ], "stageArn": "arn:aws:ivs:us-east-1:927810967299:stage/8faHz1SQp0ik", "startTime": "2023-09-21T15:38:37+00:00", "state": "ACTIVE", "tags": {} } ] } ``` **Catatan**: Anda harus memiliki peserta penerbit yang aktif menerbitkan ke panggung untuk menjaga komposisi tetap hidup. [Untuk informasi selengkapnya, lihat bagian “Menerbitkan dan Berlangganan” dari panduan SDK siaran streaming real-time: [Web](https://docs.aws.amazon.com//ivs/latest/RealTimeUserGuide/web-publish-subscribe.html), [Android](https://docs.aws.amazon.com//ivs/latest/RealTimeUserGuide/android-publish-subscribe.html), dan iOS.](https://docs.aws.amazon.com//ivs/latest/RealTimeUserGuide/ios-publish-subscribe.html) Anda harus membuat token panggung yang berbeda untuk setiap peserta. # Pemesanan Peserta Kustom Pemesanan peserta khusus memungkinkan Anda untuk mengontrol posisi peserta di tata letak kisi dan PiP berdasarkan nilai atribut khusus dalam token peserta, termasuk posisi peserta unggulan dan pemilihan peserta di jendela PiP. Ini memberikan penentuan posisi peserta deterministik dan memungkinkan tata letak berbasis peran. ## Cara Kerja Pemesanan Kustom Bila `participantOrderAttribute` ditentukan dalam konfigurasi tata letak Anda, peserta diurutkan sesuai dengan aturan berikut: + Peserta dengan atribut pemesanan yang ditentukan dalam token mereka diposisikan terlebih dahulu, diurutkan secara numerik berdasarkan nilai atribut mereka. + Peserta tanpa atribut pemesanan kembali ke pemesanan waktu kedatangan dan diposisikan setelah peserta yang dipesan. + Ketika beberapa peserta memiliki nilai urutan yang identik, mereka diurutkan berdasarkan waktu kedatangan mereka ke panggung. + Urutan menggunakan pengurutan numerik (bukan leksikografik), jadi “10" muncul setelah “9" (bukan setelah “1"). + Nilai negatif didukung. Mereka diposisikan sebelum nilai-nilai positif. + Nilai non-numerik (misalnya, “abc”, “1.5") diperlakukan sebagai tidak valid, dan peserta tersebut kembali ke pemesanan waktu kedatangan. **Penting:** Pemesanan peserta (baik berdasarkan waktu kedatangan atau kebiasaan) berlaku setelah komposisi dimulai. Urutan peserta yang benar tidak dijamin untuk peserta yang bergabung dengan panggung sebelum komposisi dimulai. ## Membuat Token dengan Atribut Pemesanan Untuk menggunakan pemesanan peserta khusus, sertakan atribut pemesanan dalam token peserta Anda saat membuatnya: ``` aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=1 aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=2 aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=3 ``` Anda dapat menggabungkan custom-participant-order atribut dengan atribut untuk memilih peserta untuk slot unggulan dan jendela PiP: ``` aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=2,isFeatured=true aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=3,isFeatured=true aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=4,isPip=true ``` ## Contoh Kasus Penggunaan Contoh kasus penggunaan meliputi: + Pemosisian yang konsisten — Peserta mempertahankan posisi mereka saat menyambung kembali dengan token yang sama. + Posisi berbasis peran — Misalnya, Anda dapat menentukan guru dengan order=1 dan siswa dengan order=2. + Tata letak berbasis prioritas - Peserta VIP dengan nilai urutan lebih rendah akan muncul terlebih dahulu. + Tata letak dinamis - Anda dapat menggabungkan pemesanan kustom dengan `featuredParticipantAttribute` dan `pipParticipantAttribute` untuk skenario yang kompleks. + Interaksi lintas tahap — Saat menggunakan replikasi peserta untuk skenario seperti kompetisi Mode VS di mana streamer dari berbagai tahap berinteraksi, Anda dapat mengganti atribut pengurutan untuk mengontrol pemosisian dalam komposisi tahap tujuan. **Catatan:** Untuk kasus penggunaan replikasi peserta, Anda dapat mengganti atribut peserta (termasuk atribut urutan) sesuai kebutuhan saat memulai replikasi untuk mencapai tata letak yang diinginkan di tahap tujuan. ## Kompatibilitas Ke Belakang Pemesanan peserta khusus adalah fitur opsional dan sepenuhnya kompatibel ke belakang. Komposisi yang ada tanpa `participantOrderAttribute` terus bekerja tidak berubah, menggunakan pemesanan waktu kedatangan. Ketika `participantOrderAttribute` disetel ke string kosong, sistem mengabaikan pemesanan kustom sepenuhnya dan kembali ke perilaku default. # Mengaktifkan Berbagi Layar dalam Komposisi Sisi Server IVS Untuk menggunakan tata letak berbagi layar tetap, ikuti langkah-langkah di bawah ini. ## Buat Sumber EncoderConfiguration Daya Perintah di bawah ini membuat EncoderConfiguration sumber daya yang mengonfigurasi parameter komposisi sisi server (bitrate video, framerate, dan resolusi). ``` aws ivs-realtime create-encoder-configuration --name "test-ssc-with-screen-share" --video={bitrate=2000000,framerate=30,height=720,width=1280} ``` Buat token peserta panggung dengan `screen-share` atribut. Karena kita akan menentukan `screen-share` sebagai nama `featured` slot, kita perlu membuat token panggung dengan `screen-share` atribut diatur ke`true`: ``` aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes screen-share=true ``` Tanggapannya adalah: ``` { "participantToken": { "attributes": { "screen-share": "true" }, "expirationTime": "2023-08-04T05:26:11+00:00", "participantId": "E813MFklPWLF", "token": "eyJhbGciOiJLTVMiLCJ0eXAiOiJKV1QifQ.eyJleHAiOjE2OTExMjY3NzEsImlhdCI6MTY5MTA4MzU3MSwianRpIjoiRTgxM01Ga2xQV0xGIiwicmVzb3VyY2UiOiJhcm46YXdzOml2czp1cy1lYXN0LTE6OTI3ODEwOTY3Mjk5OnN0YWdlL3U5T2lFMjliVDdYcCIsInRvcGljIjoidTlPaUUyOWJUN1hwIiwiZXZlbnRzX3VybCI6IndzczovL3VzLWVhc3QtMS5ldmVudHMubGl2ZS12aWRlby5uZXQiLCJ3aGlwX3VybCI6Imh0dHBzOi8vYjJlYTVjMmZmMzU1Lmdsb2JhbC53aGlwLmxpdmUtdmlkZW8ubmV0IiwiYXR0cmlidXRlcyI6eyJzY3JlZW4tc2hhcmUiOiJ0cnVlIn0sImNhcGFiaWxpdGllcyI6eyJhbGxvd19wdWJsaXNoIjp0cnVlLCJhbGxvd19zdWJzY3JpYmUiOnRydWV9LCJ2ZXJzaW9uIjoiMC4zIn0.MGUCMFvMzv35O4yVzM9tIWZl7n3mmFQhleqsRSBx_G2qT2YUDlWSNg6H1vL7sAWQMeydSAIxAIvdfqt3Fh1MLiyelc9NnTjI5hL3YPKqDX6J3NDH1fksh8_5y1jztoPDy4yVA5OmtA" } } ``` ## Mulai Komposisi Untuk memulai komposisi menggunakan fitur berbagi layar, kami menggunakan perintah ini: ``` aws ivs-realtime start-composition --stage-arn "arn:aws:ivs:us-east-1:927810967299:stage/8faHz1SQp0ik" --destinations '[{"channel": {"channelArn": "arn:aws:ivs:us-east-1:927810967299:channel/DOlMW4dfMR8r", "encoderConfigurationArn": "arn:aws:ivs:us-east-1:927810967299:encoder-configuration/DEkQHWPVaOwO"}}]' --layout '{"grid":{"featuredParticipantAttribute":"screen-share"}}' ``` Tanggapannya adalah: ``` { "composition" : { "arn" : "arn:aws:ivs:us-east-1:927810967299:composition/B19tQcXRgtoz", "destinations" : [ { "configuration" : { "channel" : { "channelArn" : "arn:aws:ivs:us-east-1:927810967299:channel/DOlMW4dfMR8r", "encoderConfigurationArn" : "arn:aws:ivs:us-east-1:927810967299:encoder-configuration/DEkQHWPVaOwO" }, "name" : "" }, "id" : "SGmgBXTULuXv", "state" : "STARTING" } ], "layout" : { "grid" : { "featuredParticipantAttribute" : "screen-share", "gridGap": 2, "omitStoppedVideo": false, "videoAspectRatio": "VIDEO" } }, "stageArn" : "arn:aws:ivs:us-east-1:927810967299:stage/8faHz1SQp0ik", "startTime" : "2023-09-27T21:32:38Z", "state" : "STARTING", "tags" : { } } } ``` Ketika peserta panggung `E813MFklPWLF` bergabung dengan panggung, video peserta tersebut akan ditampilkan di slot unggulan, dan semua penerbit panggung lainnya akan ditampilkan di bawah slot: ![\[Memulai Komposisi menggunakan fitur berbagi layar.\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/images/ssc_StartComposition.png) ## Hentikan Komposisi Untuk menghentikan komposisi kapan saja, hubungi StopComposition operasi: ``` aws ivs-realtime stop-composition --arn arn:aws:ivs:us-east-1:927810967299:composition/B19tQcXRgtoz ``` # Masalah dan Solusi yang Diketahui Bagian ini mencantumkan masalah yang diketahui yang mungkin Anda temui saat menggunakan komposisi sisi server IVS dan menyarankan solusi potensial. + Beberapa komposisi mungkin menunjukkan gagap audio singkat setelah periode hening. **Solusi**: Tidak ada