Langkah 2: Buat Panggung dengan Rekaman Peserta Opsional

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

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 dan UpdateStage.) 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 (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 erta Individu.

Cara Menonaktifkan Rekaman

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 untukstorageConfigurationArn, menunjukkan bahwa rekaman dinonaktifkan.

Instruksi Konsol untuk Membuat Tahap IVS

1. Buka konsol https://console.aws.amazon.com/ivs Amazon IVS.

   (Anda juga dapat mengakses konsol Amazon IVS melalui Konsol Manajemen AWS.)

2. Di panel navigasi kiri, pilih Tahapan, lalu pilih Buat tahap. Jen dela Create stage muncul.

   

3. Secara opsional, masukkan nama Pang gung.

4. Jika Anda ingin mengaktifkan perekaman peserta individual, selesaikan langkah-langkah di Mengatur Perek aman Peserta Individu Otomatis ke Amazon S3 (Opsional) di bawah ini.

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

Mengatur Perekaman Peserta Individu Otomatis ke Amazon S3 (Opsional)

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.

   

2. Pilih jenis media yang akan direkam.

3. Pilih Buat konfigurasi penyimpanan. Jendela baru terbuka, dengan opsi untuk membuat bucket Amazon S3 dan melampirkannya ke konfigurasi perekaman baru.

   

4. Isi kolom:

   1. Secara opsional masukkan nama konfigurasi Peny impanan.

   2. Masukkan nama Bucket.

5. 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.

   

6. Anda dapat secara opsional mengaktifkan opsi non-default lainnya seperti merekam replika peserta, menggabungkan rekaman peserta individual, dan perekaman thumbnail.

   

Petunjuk CLI untuk Membuat Tahap IVS

Untuk menginstal AWS CLI, lihat Meng instal atau memperbarui ke versi terbaru AWS CLI.

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

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

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"
   }
}