Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# 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.