

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

# Langkah 2: Buat Panggung dengan Rekaman Peserta Opsional
<a name="getting-started-create-stage"></a>

Panggung adalah ruang virtual di mana peserta dapat bertukar video secara real time. Ini adalah sumber daya dasar dari Real-Time Streaming API. Anda dapat membuat panggung menggunakan konsol atau CreateStage operasi.

Sebaiknya jika memungkinkan, Anda membuat tahap baru untuk setiap sesi logis dan menghapusnya setelah selesai, daripada menyimpan tahapan lama untuk kemungkinan digunakan kembali. Jika sumber daya basi (tahap lama, tidak untuk digunakan kembali) tidak dibersihkan, Anda cenderung mencapai batas jumlah tahapan maksimum lebih cepat.

Anda dapat membuat panggung — dengan atau tanpa rekaman peserta individual — melalui konsol Amazon IVS atau AWS CLI. Pembuatan dan perekaman panggung dibahas di bawah ini.

## Rekaman Peserta Individu
<a name="getting-started-create-stage-ipr-overview"></a>

Anda memiliki opsi untuk mengaktifkan perekaman peserta individu untuk panggung. Jika fitur perekaman peserta individu ke S3 diaktifkan, semua siaran peserta individual ke panggung direkam dan disimpan ke bucket penyimpanan Amazon S3 yang Anda miliki. Selanjutnya, rekaman tersedia untuk pemutaran sesuai permintaan.

*Menyiapkan ini adalah opsi lanjutan. * Secara default, perekaman dinonaktifkan saat panggung dibuat.

Sebelum Anda dapat mengatur panggung untuk merekam, Anda harus membuat konfigurasi * penyimpanan*. Ini adalah sumber daya yang menentukan lokasi Amazon S3 tempat streaming yang direkam untuk panggung disimpan. Anda dapat membuat dan mengelola konfigurasi penyimpanan menggunakan konsol atau CLI; kedua prosedur diberikan di bawah ini. Setelah Anda membuat konfigurasi penyimpanan, Anda mengaitkannya dengan tahap baik saat Anda membuat panggung (seperti dijelaskan di bawah) atau yang lebih baru, dengan memperbarui tahap yang ada. (Di API, lihat [ CreateStage ](https://docs.aws.amazon.com/ivs/latest/RealTimeAPIReference/API_CreateStage.html) dan [ UpdateStage](https://docs.aws.amazon.com/ivs/latest/RealTimeAPIReference/API_UpdateStage.html).) Anda dapat mengaitkan beberapa tahap dengan konfigurasi penyimpanan yang sama. Anda dapat menghapus konfigurasi penyimpanan yang tidak lagi terkait dengan tahapan apa pun.

Ingatlah kendala berikut:
+ Anda harus memiliki bucket S3. Artinya, akun yang menyiapkan panggung untuk direkam harus memiliki bucket S3 tempat rekaman akan disimpan.
+ Tahap, konfigurasi penyimpanan, dan lokasi S3 harus berada di AWS wilayah yang sama. Jika Anda membuat tahapan di wilayah lain dan ingin merekamnya, Anda juga harus menyiapkan konfigurasi penyimpanan dan bucket S3 di wilayah tersebut.

Merekam ke bucket S3 memerlukan otorisasi dengan kredenSIAL AWS Anda. Untuk memberikan IVS akses yang diperlukan, Peran AWS IAM [ Service-Linked ](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html) (SLR) dibuat secara otomatis saat konfigurasi perekaman dibuat: SLR dibatasi untuk memberikan izin menulis IVS hanya pada bucket tertentu.

Perhatikan bahwa masalah jaringan antara lokasi streaming dan AWS atau di dalam AWS dapat mengakibatkan hilangnya data saat merekam streaming Anda. Dalam kasus ini, Amazon IVS memprioritaskan streaming langsung daripada rekaman. Untuk redundansi, rekam secara lokal melalui alat streaming Anda.

Untuk informasi selengkapnya (termasuk cara mengatur pemutaran pasca-pemrosesan atau VOD pada file rekaman Anda), lihat Perekaman [ Pes ](rt-individual-participant-recording.md) erta Individu.

### Cara Menonaktifkan Rekaman
<a name="getting-started-disable-recording"></a>

Untuk menonaktifkan perekaman Amazon S3 pada panggung yang ada:
+ Konsol — Pada halaman detail untuk tahap yang relevan, di bagian Rek ** am ** aliran peserta individual, matikan ** Aktifkan perekaman otomatis ** di bawah ** Auto-record ke S3 ** lalu pilih S ** impan perubahan**. Ini menghapus asosiasi konfigurasi penyimpanan dengan panggung; aliran di panggung itu tidak akan lagi direkam.
+ CLI - Jalankan `update-stage` perintah dan meneruskan ARN konfigurasi perekaman sebagai string kosong:

  ```
  aws ivs-realtime update-stage --arn arn:aws:ivs:us-west-2:123456789012:stage/abcdABCDefgh --auto-participant-recording-configuration storageConfigurationArn=""
  ```

  Ini mengembalikan objek stage dengan string kosong untuk`storageConfigurationArn`, menunjukkan bahwa rekaman dinonaktifkan.

## Instruksi Konsol untuk Membuat Tahap IVS
<a name="getting-started-create-stage-console"></a>

1. Buka konsol [https://console.aws.amazon.com/ivs](https://console.aws.amazon.com/ivs) Amazon IVS.

   (Anda juga dapat mengakses konsol Amazon IVS melalui [Konsol Manajemen AWS](https://console.aws.amazon.com/).)

1. Di panel navigasi kiri, pilih ** Tahapan**, lalu pilih ** Buat tahap**. Jen ** dela Create ** stage muncul.  
![Gunakan jendela Buat panggung untuk membuat panggung baru dan token peserta untuk itu.](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/images/Create_Stage_Console_IPR.png)

1. Secara opsional, masukkan nama Pang ** gung**.

1. Jika Anda ingin mengaktifkan perekaman peserta individual, selesaikan langkah-langkah di Mengatur Perek [ aman Peserta Individu Otomatis ke Amazon S3 (Opsional) ](#getting-started-create-stage-ipr) di bawah ini.

1. Pilih ** Buat tahap ** untuk membuat panggung. Halaman detail panggung muncul, untuk tahap baru.

### Mengatur Perekaman Peserta Individu Otomatis ke Amazon S3 (Opsional)
<a name="getting-started-create-stage-ipr"></a>

Ikuti langkah-langkah berikut untuk mengaktifkan perekaman peserta individu saat membuat panggung:

1. Pada ** halaman Buat ** panggung, di bawah ** Rekam peserta individual**, aktifkan ** Aktifkan perekaman otomatis**. Bidang tambahan ditampilkan, untuk memilih jenis media yang ** direkam**, untuk memilih konfigurasi ** Penyimpanan yang ada ** atau membuat yang baru, dan untuk memilih apakah akan merekam thumbnail pada interval tertentu.  
![Gunakan dialog Rekam peserta individual untuk mengonfigurasi perekaman peserta individu untuk panggung.](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/images/Create_Stage_Console_enable_IPR.png)

1. Pilih jenis media yang akan direkam.

1. Pilih ** Buat konfigurasi penyimpanan**. Jendela baru terbuka, dengan opsi untuk membuat bucket Amazon S3 dan melampirkannya ke konfigurasi perekaman baru.  
![Gunakan jendela Buat konfigurasi penyimpanan untuk membuat konfigurasi penyimpanan baru untuk tahap.](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/images/Create_Storage_Configuration_IPR.png)

1. Isi kolom:

   1. Secara opsional masukkan nama konfigurasi Peny ** impanan**.

   1. Masukkan nama ** Bucket**.

1. Pilih ** Buat konfigurasi penyimpanan**, untuk membuat sumber daya konfigurasi penyimpanan baru dengan ARN unik. Biasanya, pembuatan konfigurasi perekaman membutuhkan waktu beberapa detik, tetapi bisa hingga 20 detik. Ketika konfigurasi penyimpanan dibuat, Anda dikembalikan ke ** jendela ** Create stage. Di sana, ** area ** Rekam peserta individual menunjukkan konfigurasi Peny ** impanan baru Anda ** dan bucket S3 (Peny ** impanan**) yang Anda buat.  
![Buat panggung menggunakan IVS Console: Konfigurasi penyimpanan baru dibuat.](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/images/Create_Stage_Console_Storage_Configuration.png)

1. Anda dapat secara opsional mengaktifkan opsi non-default lainnya seperti merekam replika peserta, menggabungkan rekaman peserta individual, dan perekaman thumbnail.  
![Buat panggung menggunakan IVS Console: aktifkan opsi lanjutan seperti perekaman thumbnail dan jahitan IPR.](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/images/Create_Stage_Console_IPR_Stitching.png)

## Petunjuk CLI untuk Membuat Tahap IVS
<a name="getting-started-create-stage-cli"></a>

Untuk menginstal AWS CLI, lihat Meng [ instal atau memperbarui ke versi terbaru AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).

Sekarang Anda dapat menggunakan CLI untuk membuat dan mengelola sumber daya mengikuti salah satu dari dua prosedur di bawah ini, tergantung pada apakah Anda ingin membuat panggung dengan atau tanpa perekaman peserta individual diaktifkan.

### Membuat Panggung tanpa Rekaman Peserta Individu
<a name="getting-started-create-stage-cli-without-ipr"></a>

API tahap berada di bawah namespace ivs-realtime. Misalnya, untuk membuat panggung:

```
aws ivs-realtime create-stage --name "test-stage"
```

Tanggapannya adalah:

```
{
   "stage": {
      "arn": "arn:aws:ivs:us-west-2:376666121854:stage/VSWjvX5XOkU3",
      "name": "test-stage"
   }
}
```

### Buat Panggung dengan Perekaman Peserta Individu
<a name="getting-started-create-stage-cli-with-ipr"></a>

Untuk membuat panggung dengan perekaman peserta individual diaktifkan:

```
aws ivs-realtime create-stage --name "test-stage-participant-recording" --auto-participant-recording-configuration storageConfigurationArn=arn:aws:ivs:us-west-2:123456789012:storage-configuration/LKZ6QR7r55c2,mediaTypes=AUDIO_VIDEO
```

Secara opsional, berikan `thumbnailConfiguration` parameter untuk mengatur penyimpanan thumbnail dan mode perekaman secara manual, dan interval thumbnail detik:

```
aws ivs-realtime create-stage --name "test-stage-participant-recording" --auto-participant-recording-configuration storageConfigurationArn=arn:aws:ivs:us-west-2:123456789012:storage-configuration/LKZ6QR7r55c2,mediaTypes=AUDIO_VIDEO,thumbnailConfiguration="{targetIntervalSeconds=10,storage=[SEQUENTIAL,LATEST],recordingMode=INTERVAL}"
```

Secara opsional, berikan `recordingReconnectWindowSeconds` parameter untuk mengaktifkan gabungan rekaman peserta individu yang terfragmentasi:

```
aws ivs-realtime create-stage --name "test-stage-participant-recording" --auto-participant-recording-configuration "storageConfigurationArn=arn:aws:ivs:us-west-2:123456789012:storage-configuration/LKZ6QR7r55c2,mediaTypes=AUDIO_VIDEO,thumbnailConfiguration="{targetIntervalSeconds=10,storage=[SEQUENTIAL,LATEST],recordingMode=INTERVAL}",recordingReconnectWindowSeconds=60"
```

Tanggapannya adalah:

```
{
   "stage": {
      "arn": "arn:aws:ivs:us-west-2:123456789012:stage/VSWjvX5XOkU3",
      "autoParticipantRecordingConfiguration": {
         "hlsConfiguration": {
             "targetSegmentDurationSeconds": 6
         },
         "mediaTypes": [
            "AUDIO_VIDEO"
         ],
         "recordingReconnectWindowSeconds": 60,
         "recordParticipantReplicas": true,
         "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/LKZ6QR7r55c2",
         "thumbnailConfiguration": {
            "recordingMode": "INTERVAL",
            "storage": [
               "SEQUENTIAL",
               "LATEST"
            ],
            "targetIntervalSeconds": 10
         }
      },
      "endpoints": {
         "events": "<events-endpoint>",
         "rtmp": "<rtmp-endpoint>",
         "rtmps": "<rtmps-endpoint>",
         "whip": "<whip-endpoint>"
      },
      "name": "test-stage-participant-recording"
   }
}
```