

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

# Rekaman Peserta Individu IVS \$1 Streaming Waktu Nyata
<a name="rt-individual-participant-recording"></a>

Dokumen ini menjelaskan cara menggunakan rekaman peserta individu dengan streaming real-time IVS.

Biaya penyimpanan dan permintaan S3 standar berlaku. Thumbnail tidak dikenakan biaya IVS tambahan. Untuk detailnya, lihat [Harga Amazon IVS](https://aws.amazon.com/ivs/pricing/).

## Pengantar
<a name="ind-part-rec-introduction"></a>

Rekaman peserta individu memungkinkan pelanggan streaming real-time IVS untuk merekam penerbit panggung IVS satu per satu ke dalam ember S3. Ketika rekaman peserta individu diaktifkan untuk sebuah panggung, konten penerbit direkam setelah mereka mulai menerbitkan ke panggung.

**Catatan:** Jika Anda perlu membuat semua peserta panggung dicampur dalam satu video, fitur perekaman komposit lebih cocok. Lihat [Merekam](rt-recording.md) untuk ringkasan perekaman real-time-streaming konten IVS.

![\[Merekam setiap media penerbit dalam file terpisah menggunakan rekaman partisipan individu.\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/images/Individual_Participant_Recording.png)


## Alur kerja
<a name="ind-part-rec-workflow"></a>

![\[Alur kerja untuk merekam setiap media penerbit dalam file terpisah menggunakan rekaman partisipan individu.\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/images/Workflow_Participant_Recording.png)


### 1. Buat Bucket S3
<a name="ind-part-rec-create-s3-bucket"></a>

Anda akan membutuhkan ember S3 untuk menulis VODs. Untuk detailnya, lihat dokumentasi S3 tentang [cara membuat bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html). Perhatikan bahwa untuk perekaman peserta individu, 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).

### 2. Buat StorageConfiguration Objek
<a name="ind-part-rec-create-storageconfig-object"></a>

Setelah membuat bucket, panggil API streaming real-time IVS untuk [membuat StorageConfiguration](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_CreateStorageConfiguration.html) objek. Setelah konfigurasi penyimpanan berhasil dibuat, IVS akan memiliki izin untuk menulis ke bucket S3 yang disediakan. Anda dapat menggunakan kembali StorageConfiguration objek ini pada beberapa tahap.

### 3. Buat Panggung dengan Token Peserta
<a name="ind-part-rec-create-stage-with-part-tokens"></a>

Sekarang Anda perlu [membuat tahap IVS](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_CreateStage.html) dengan rekaman peserta individu diaktifkan (dengan mengatur AutoParticipantRecordingConfiguration objek), serta token peserta untuk setiap penerbit.

Permintaan di bawah ini membuat panggung dengan dua token peserta dan rekaman peserta individu diaktifkan.

```
POST /CreateStage HTTP/1.1
Content-type: application/json

{
   "autoParticipantRecordingConfiguration": { 
      "mediaTypes": ["AUDIO_VIDEO"],
      "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/AbCdef1G2hij",
      "thumbnailConfiguration": {
         "recordingMode": "INTERVAL",
         "storage": ["LATEST", "SEQUENTIAL"],
         "targetIntervalSeconds": 60
      }
   },
   "name": "TestStage",
   "participantTokenConfigurations": [ 
      { 
         "capabilities": ["PUBLISH", "SUBSCRIBE"],
         "duration": 20160,
         "userId": "1"
      },
      { 
         "capabilities": ["PUBLISH", "SUBSCRIBE"],
         "duration": 20160,
         "userId": "2"
      }
   ]
}
```

### 4. Bergabunglah dengan Panggung sebagai Penerbit Aktif
<a name="ind-part-rec-join-stage-as-active-pub"></a>

Bagikan token peserta ke penerbit Anda, dan minta mereka bergabung dengan panggung dan mulai [mempublikasikannya](https://docs.aws.amazon.com//ivs/latest/RealTimeUserGuide/getting-started-pub-sub.html).

Ketika mereka bergabung dengan panggung dan mulai mempublikasikannya menggunakan salah satu [siaran streaming real-time IVS SDKs](https://docs.aws.amazon.com//ivs/latest/RealTimeUserGuide/broadcast.html), proses perekaman peserta dimulai secara otomatis dan mengirimi Anda [EventBridgeacara](eventbridge.md) yang menunjukkan bahwa rekaman dimulai. (Acara ini adalah Perubahan Status Rekaman Peserta IVS - Merekam Mulai.) Secara bersamaan, proses perekaman peserta mulai menulis file VOD dan metadata ke bucket S3 yang dikonfigurasi. Catatan: Peserta yang terhubung untuk jangka waktu yang sangat singkat (kurang dari 5 d) tidak dijamin akan direkam.

Ada dua cara untuk mendapatkan awalan S3 untuk setiap rekaman:
+ Dengarkan EventBridge acara:

  ```
  {
     "version": "0",
     "id": "12345678-1a23-4567-a1bc-1a2b34567890",
     "detail-type": "IVS Participant Recording State Change",
     "source": "aws.ivs",
     "account": "123456789012",
     "time": "2024-03-13T22:19:04Z",
     "region": "us-east-1",
     "resources": ["arn:aws:ivs:us-west-2:123456789012:stage/AbCdef1G2hij"],
     "detail": {
        "session_id": "st-ZyXwvu1T2s",
        "event_name": "Recording Start",
        "participant_id": "xYz1c2d3e4f",
        "recording_s3_bucket_name": "ivs-recordings",
        "recording_s3_key_prefix": "<stage_id>/<session_id>/<participant_id>/2024-01-01T12-00-55Z"
     }
  }
  ```
+ Gunakan operasi [GetParticipant](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_GetParticipant.html)API — Responsnya mencakup bucket S3 dan awalan tempat peserta direkam. Berikut permintaannya:

  ```
  POST /GetParticipant HTTP/1.1
  Content-type: application/json
  {
     "participantID": "xYz1c2d3e4f",
     "sessionId": "st-ZyXwvu1T2s",
     "stageArn": "arn:aws:ivs:us-west-2:123456789012:stage/AbCdef1G2hij"
  }
  ```

  Dan inilah tanggapannya:

  ```
  Content-type: application/json
  {
     "participant": {
        ...
        "recordingS3BucketName": "ivs-recordings",
        "recordingS3Prefix": "<stage_id>/<session_id>/<participant_id>",
        "recordingState": "ACTIVE",
        ...
     }
  }
  ```

### 5. Mainkan Kembali VOD
<a name="ind-part-rec-play-back-vod"></a>

Setelah rekaman selesai, Anda dapat menontonnya menggunakan pemutar [IVS](https://debug.ivsdemos.com/?p=ivs). Lihat [Pemutaran Konten yang Direkam dari Bucket Pribadi](https://docs.aws.amazon.com//ivs/latest/RealTimeUserGuide/rt-composite-recording.html#comp-rec-playback) untuk petunjuk tentang pengaturan CloudFront distribusi untuk pemutaran VOD.

## Rekaman Hanya Audio
<a name="ind-part-rec-audio-only-recordings"></a>

Saat menyiapkan rekaman peserta individu, Anda dapat memilih untuk hanya memiliki segmen HLS audio yang ditulis ke bucket S3 Anda. Untuk menggunakan fitur ini, pilih `AUDIO_ONLY mediaType` saat membuat panggung:

```
POST /CreateStage HTTP/1.1
Content-type: application/json

{
   "autoParticipantRecordingConfiguration": { 
      "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/AbCdef1G2hij",
      "mediaTypes": ["AUDIO_ONLY"],
      "thumbnailConfiguration": {
         "recordingMode": "DISABLED"
      }
   },
   "name": "TestStage",
   "participantTokenConfigurations": [ 
      { 
         "capabilities": ["PUBLISH", "SUBSCRIBE"],
         "duration": 20160,
         "userId": "1"
      },
      { 
         "capabilities": ["PUBLISH", "SUBSCRIBE"],
         "duration": 20160,
         "userId": "2"
      }
   ]
}
```

## Rekaman Khusus Thumbnail
<a name="ind-part-rec-recording-thumbnail-only"></a>

Saat menyiapkan rekaman peserta individu, Anda dapat memilih untuk hanya memiliki thumbnail yang ditulis ke bucket S3 Anda. Untuk menggunakan fitur ini, atur `mediaType` ke `NONE` saat membuat panggung. Ini memastikan bahwa tidak ada segmen HLS yang dihasilkan; thumbnail masih dibuat dan ditulis ke bucket S3 Anda.

```
POST /CreateStage HTTP/1.1
Content-type: application/json
{
   "autoParticipantRecordingConfiguration": { 
      "storageConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:storage-configuration/AbCdef1G2hij",
      "mediaTypes": ["NONE"],
      "thumbnailConfiguration": {
         "recordingMode": "INTERVAL",
         "storage": ["LATEST", "SEQUENTIAL"],
         "targetIntervalSeconds": 60
      }
   },
   "name": "TestStage",
   "participantTokenConfigurations": [ 
      { 
         "capabilities": ["PUBLISH", "SUBSCRIBE"],
         "duration": 20160,
         "userId": "1"
      },
      { 
         "capabilities": ["PUBLISH", "SUBSCRIBE"],
         "duration": 20160,
         "userId": "2"
      }
   ]
}
```

## Isi Rekaman
<a name="ind-part-rec-recording-contents"></a>

Saat perekaman peserta individu aktif, segmen video HLS, file metadata, dan thumbnail akan mulai ditulis ke bucket S3 yang disediakan saat panggung dibuat. Konten ini tersedia untuk pasca-pemrosesan atau pemutaran sebagai video sesuai permintaan.

Perhatikan bahwa setelah rekaman diselesaikan, acara Perubahan Status Perekaman Peserta IVS - Perekaman Akhir dikirim melalui. EventBridge Kami menyarankan Anda memutar kembali atau memproses streaming yang direkam hanya setelah acara ini diterima. Untuk detailnya, lihat [Menggunakan EventBridge dengan IVS Real-Time Streaming](eventbridge.md).

Berikut ini adalah struktur direktori sampel dan isi rekaman sesi IVS langsung:

```
s3://mybucket/stageId/stageSessionId/participantId/timestamp
   events
      recording-started.json
      recording-ended.json
   media
      hls
	 multivariant.m3u8
         high
            playlist.m3u8
            1.mp4
      thumbnails
         high
            1.jpg
            2.jpg
      latest_thumbnail
         high
            thumb.jpg
```

`events`Folder berisi file metadata yang sesuai dengan peristiwa perekaman. File metadata JSON dihasilkan saat perekaman dimulai, berakhir dengan sukses, atau diakhiri dengan kegagalan:
+ `events/recording-started.json`
+ `events/recording-ended.json`
+ `events/recording-failed.json`

`events`Folder tertentu berisi `recording-started.json` dan salah satu `recording-ended.json` atau`recording-failed.json`. Ini berisi metadata yang terkait dengan sesi rekaman dan format outputnya. Rincian JSON diberikan di bawah ini.

`media`Folder berisi konten media yang didukung. `hls`Subfolder berisi semua media dan file manifes yang dihasilkan selama sesi perekaman dan dapat dimainkan dengan pemutar IVS. Jika dikonfigurasi, `latest_thumbnail` subfolder `thumbnails` dan berisi file media thumbnail JPEG yang dihasilkan selama sesi perekaman.

## Gabungkan Rekaman Peserta Individu yang Terfragmentasi
<a name="ind-part-rec-merge-frag"></a>

`recordingReconnectWindowSeconds`Properti pada konfigurasi perekaman memungkinkan Anda menentukan jendela waktu (dalam detik) di mana, jika penerbit panggung terputus dari panggung dan kemudian menyambung kembali, IVS mencoba merekam ke awalan S3 yang sama dengan sesi sebelumnya. Dengan kata lain, jika penerbit terputus dan kemudian menyambung kembali dalam interval yang ditentukan, beberapa rekaman dianggap sebagai rekaman tunggal dan digabungkan bersama.

Jika perekaman thumbnail diaktifkan dalam `SEQUENTIAL` mode, maka thumbnail juga digabungkan di bawah yang sama. `recordingS3Prefix` Saat rekaman digabungkan, penghitung thumbnail dimulai ulang dari nilai thumbnail sebelumnya yang ditulis untuk rekaman sebelumnya.

**Peristiwa Perubahan Status Perekaman IVS di Amazon EventBridge:** Perekaman peristiwa Akhir dan file metadata JSON yang berakhir perekaman ditunda setidaknya`recordingReconnectWindowSeconds`, karena IVS menunggu untuk memastikan aliran baru tidak dimulai.

Untuk petunjuk cara menyiapkan fungsionalitas penggabungan aliran, lihat [Langkah 2: Membuat Tahap dengan Perekaman Peserta Opsional](getting-started-create-stage.md) dalam *Memulai Streaming Waktu Nyata Amazon IVS*.

### Kelayakan
<a name="ind-part-rec-merge-frag-eligibility"></a>

Agar beberapa rekaman digabungkan menggunakan awalan S3 yang sama, kondisi tertentu harus dipenuhi untuk semua rekaman:
+ Nilai `recordingReconnectWindowSeconds` properti AutoParticipantRecordingConfiguration untuk tahap ditetapkan lebih besar dari 0.
+ Yang `StorageConfigurationArn` digunakan untuk menulis artefak VOD adalah sama untuk setiap rekaman.
+ Perbedaan waktu dalam detik antara saat peserta meninggalkan dan bergabung kembali dengan panggung kurang dari atau sama dengan. `recordingReconnectWindowSeconds`

Perhatikan bahwa nilai default `recordingReconnectWindowSeconds` adalah 0, yang menonaktifkan penggabungan.

## Sinkronkan Beberapa Rekaman Peserta
<a name="ind-part-rec-sync-multiple"></a>

Rekaman peserta individu menyertakan `EXT-X-PROGRAM-DATE-TIME` tag dalam daftar putar HLS, yang memberikan stempel waktu UTC yang tepat dengan akurasi milidetik untuk menyinkronkan rekaman dari beberapa peserta selama pasca-pemrosesan.

Saat Anda merekam beberapa peserta satu per satu dan ingin membuat komposisi yang disinkronkan (seperti side-by-side atau picture-in-picture tata letak), Anda dapat menggunakan stempel waktu ini untuk menyelaraskan rekaman secara akurat, bahkan jika peserta bergabung dengan panggung pada waktu yang berbeda atau mengalami diskontinuitas yang berpotensi disebabkan oleh gangguan jaringan.

Daftar putar HLS setiap peserta menyertakan `EXT-X-PROGRAM-DATE-TIME` tag yang menandai:
+ Awal rekaman (segmen pertama).
+ Setiap titik diskontinuitas selama perekaman; misalnya, ketika jahitan terjadi.

Stempel waktu ini menggunakan presisi milidetik dan disinkronkan di semua peserta menggunakan referensi waktu yang sama.

### Contoh Daftar Putar HLS
<a name="ind-part-rec-sync-multiple-hls-playlist"></a>

```
#EXTM3U
#EXT-X-VERSION:7
#EXT-X-TARGETDURATION:12
#EXT-X-PLAYLIST-TYPE:VOD
#EXT-X-MAP:URI="init-0.mp4"
#EXT-X-PROGRAM-DATE-TIME:2024-01-01T12:00:00.000Z
#EXTINF:3.30091,
0.mp4
#EXTINF:5.63794,
1.mp4
#EXTINF:2.74290,
2.mp4
#EXT-X-DISCONTINUITY
#EXT-X-MAP:URI="init-1.mp4"
#EXT-X-PROGRAM-DATE-TIME:2024-01-01T12:00:52.772Z
#EXTINF:2.54412,
3.mp4
#EXTINF:5.63649,
4.mp4
```

`EXT-X-PROGRAM-DATE-TIME`Tag memberikan waktu UTC yang tepat untuk segmen pertama dan pada setiap titik diskontinuitas, memungkinkan sinkronisasi yang tepat dengan rekaman peserta lain.

### Alur Kerja Sinkronisasi
<a name="ind-part-rec-sync-multiple-workflow"></a>

Untuk menyinkronkan beberapa rekaman peserta, ekstrak `EXT-X-PROGRAM-DATE-TIME` stempel waktu dari daftar putar HLS masing-masing peserta dan gunakan untuk menghitung offset waktu. Offset ini kemudian dapat diterapkan selama komposisi pasca-pemrosesan menggunakan alat pemrosesan video seperti. FFmpeg Ketika diskontinuitas hadir dalam rekaman, stempel waktu pada titik-titik tersebut memberikan referensi waktu yang diperlukan untuk mempertahankan sinkronisasi yang akurat di seluruh rekaman.

Catatan: Untuk output yang disinkronkan secara real-time tanpa pasca-pemrosesan, pertimbangkan untuk menggunakan komposisi sisi server alih-alih perekaman peserta individu.

## File Metadata JSON
<a name="ind-part-rec-json-metadata-files"></a>

Metadata ini dalam format JSON. Ini terdiri dari informasi berikut: 


| Bidang | Tipe | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
| `stage_arn` | string | Ya | ARN panggung digunakan sebagai sumber rekaman. | 
| `session_id` | string | Ya | String mewakili panggung `session_id` di mana peserta direkam. | 
| `participant_id` | string | Ya | String yang mewakili pengidentifikasi peserta yang direkam. | 
| `recording_started_at` | string | Bersyarat | Stempel waktu RFC 3339 UTC saat perekaman dimulai. Ini tidak tersedia kapan`recording_status`. `RECORDING_START_FAILED` Juga, lihat catatan di bawah ini untuk`recording_ended_at`. | 
| `recording_ended_at` | string | Bersyarat | Stempel waktu RFC 3339 UTC saat rekaman berakhir. Ini hanya tersedia jika `recording_status` ada `"RECORDING_ENDED"` atau`"RECORDING_ENDED_WITH_FAILURE"`. **Catatan:** `recording_started_at` dan `recording_ended_at` merupakan stempel waktu saat peristiwa ini dihasilkan dan mungkin tidak sama persis dengan stempel waktu segmen video HLS. Untuk menentukan durasi rekaman secara akurat, gunakan `duration_ms` bidang. | 
| `recording_status` | string | Ya | Status rekaman. Nilai yang valid:`"RECORDING_STARTED"`,`"RECORDING_ENDED"`,`"RECORDING_START_FAILED"`,`"RECORDING_ENDED_WITH_FAILURE"`. | 
| `recording_status_message` | string | Bersyarat | Informasi deskriptif tentang status. Ini hanya tersedia jika `recording_status` ada `"RECORDING_ENDED"` atau`"RECORDING_ENDED_WITH_FAILURE"`. | 
| `media` | object | Ya | Objek yang berisi objek yang disebutkan dari konten media yang tersedia untuk rekaman ini. Nilai valid: `"hls"`. | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-individual-participant-recording.html)  | object | Ya | Bidang yang disebutkan yang menjelaskan output format Apple HLS. | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-individual-participant-recording.html)  | integer | Bersyarat | Durasi konten HLS yang direkam dalam milidetik. Ini hanya tersedia jika `recording_status` ada `"RECORDING_ENDED"` atau`"RECORDING_ENDED_WITH_FAILURE"`. Jika terjadi kegagalan sebelum perekaman dilakukan, ini adalah 0. | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-individual-participant-recording.html)  | string | Ya | Jalur relatif dari awalan S3 tempat konten HLS disimpan. | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-individual-participant-recording.html)  | string | Ya | Nama file daftar putar master HLS. | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-individual-participant-recording.html)  | object | Ya | Array rendisi (varian HLS) objek metadata. Selalu ada setidaknya satu rendisi. | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-individual-participant-recording.html)  | string | Ya | Jalur relatif dari awalan S3 tempat konten HLS disimpan untuk rendisi ini. | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-individual-participant-recording.html)  | string | Ya | Nama file playlist media untuk rendisi ini. | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-individual-participant-recording.html)  | object | Bersyarat | Bidang enumerasi yang menjelaskan output thumbnail. Ini hanya tersedia jika bidang konfigurasi thumbnail termasuk `storage` `SEQUENTIAL` | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-individual-participant-recording.html)  | string | Ya | Jalur relatif dari awalan S3 tempat konten thumbnail berurutan disimpan. | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-individual-participant-recording.html)  | object | Ya | Array rendisi (varian thumbnail) objek metadata. Selalu ada setidaknya satu rendisi. | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-individual-participant-recording.html)  | string | Ya | Jalur relatif dari awalan S3 tempat konten thumbnail disimpan untuk rendisi ini. | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-individual-participant-recording.html)  | object | Bersyarat | Bidang enumerasi yang menjelaskan output thumbnail. Ini hanya tersedia jika `storage` bidang konfigurasi thumbnail disertakan. `LATEST` | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-individual-participant-recording.html)  | string | Ya | Jalur relatif dari awalan S3 tempat `latest_thumbnail` disimpan. | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-individual-participant-recording.html)  | object | Ya | Array rendisi (varian thumbnail) objek metadata. Selalu ada setidaknya satu rendisi. | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-individual-participant-recording.html)  | string | Ya | Jalur relatif dari awalan S3 tempat thumbnail terbaru disimpan untuk rendisi ini. | 
| `version` | string | Ya | Versi skema metadata. | 

### Contoh: recording-started.json
<a name="ind-part-rec-json-ex-rec-start"></a>

```
{
   "version": "v1",
   "stage_arn": "arn:aws:ivs:us-west-2:aws_account_id:stage/AbCdef1G2hij",
   "session_id": "st-ZyXwvu1T2s",
   "participant_id": "xYz1c2d3e4f",
   "recording_started_at": "2024-03-13T13:17:17Z",
   "recording_status": "RECORDING_STARTED",
   "media": {
      "hls": {
         "path": "media/hls",
         "playlist": "multivariant.m3u8",
         "renditions": [
            {
               "path": "high",
               "playlist": "playlist.m3u8"
            }
         ]
      },
      "thumbnails": {
         "path": "media/thumbnails",
         "renditions": [
            {
               "path": "high"
            }
         ]
      },
      "latest_thumbnail": {
         "path": "media/latest_thumbnail",
         "renditions": [
            {
               "path": "high"
            }
         ]
      }
   }
}
```

### Contoh: recording-ended.json
<a name="ind-part-rec-json-ex-rec-end"></a>

```
{
   "version": "v1",
   "stage_arn": "arn:aws:ivs:us-west-2:aws_account_id:stage/AbCdef1G2hij",
   "session_id": "st-ZyXwvu1T2s",
   "participant_id": "xYz1c2d3e4f",
   "recording_started_at": "2024-03-13T19:44:19Z",
   "recording_ended_at": "2024-03-13T19:55:04Z",
   "recording_status": "RECORDING_ENDED",
   "media": {
      "hls": {
         "duration_ms": 645237,
         "path": "media/hls",
         "playlist": "multivariant.m3u8",
         "renditions": [
            {
               "path": "high",
               "playlist": "playlist.m3u8"
            }
         ]
      },
      "thumbnails": {
         "path": "media/thumbnails",
         "renditions": [
            {
               "path": "high"
            }
         ]
      },
      "latest_thumbnail": {
         "path": "media/latest_thumbnail",
         "renditions": [
            {
               "path": "high"
            }
         ]
      }
   }
}
```

### Contoh: perekaman-failed.json
<a name="ind-part-rec-json-ex-rec-failed"></a>

```
{
   "version": "v1",
   "stage_arn": "arn:aws:ivs:us-west-2:aws_account_id:stage/AbCdef1G2hij",
   "session_id": "st-ZyXwvu1T2s",
   "participant_id": "xYz1c2d3e4f",
   "recording_started_at": "2024-03-13T19:44:19Z",
   "recording_ended_at": "2024-03-13T19:55:04Z",
   "recording_status": "RECORDING_ENDED_WITH_FAILURE",
   "media": {
      "hls": {
         "duration_ms": 645237,
         "path": "media/hls",
         "playlist": "multivariant.m3u8",
         "renditions": [
            {
               "path": "high",
               "playlist": "playlist.m3u8"
            }
         ]
      },
      "thumbnails": {
         "path": "media/thumbnails",
         "renditions": [
            {
               "path": "high"
            }
         ]
      },
      "latest_thumbnail": {
         "path": "media/latest_thumbnail",
         "renditions": [
            {
               "path": "high"
            }
         ]
      }
   }
}
```

## Mengonversi Rekaman ke MP4
<a name="ind-part-rec-convert-rec-mp4"></a>

Rekaman peserta individu disimpan dalam format HLS, yang terdiri dari daftar putar dan segmen terfragmentasi MP4 (fMP4). Untuk mengonversi rekaman HLS menjadi satu MP4 file, instal FFmpeg dan jalankan perintah berikut:

```
ffmpeg -i /path/to/playlist.m3u8 -i /path/to/playlist.m3u8 -map 0:v -map 1:a -c copy output.mp4
```