Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Rekaman Komposit IVS \$1 Streaming Waktu Nyata
[Dokumen ini menjelaskan cara menggunakan fitur perekaman komposit dalam komposisi sisi server.](server-side-composition.md) Rekaman komposit memungkinkan Anda menghasilkan rekaman HLS dari tahap IVS dengan menggabungkan semua penerbit panggung secara efektif ke dalam satu tampilan menggunakan server IVS, dan kemudian menyimpan video yang dihasilkan ke ember S3.
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/).
## Prasyarat
Untuk menggunakan rekaman komposit, Anda harus memiliki panggung dengan penerbit aktif dan bucket S3 untuk digunakan sebagai tujuan perekaman. Di bawah ini, kami menjelaskan satu kemungkinan alur kerja yang menggunakan EventBridge peristiwa untuk merekam komposisi ke bucket S3. Atau, Anda dapat memulai dan menghentikan komposisi berdasarkan logika aplikasi Anda sendiri.
1. Buat [tahap IVS](getting-started-create-stage.md) dan token peserta untuk setiap penerbit.
1. Buat [EncoderConfiguration](https://docs.aws.amazon.com/ivs/latest/RealTimeAPIReference/API_CreateEncoderConfiguration.html)(objek yang mewakili bagaimana video yang direkam harus dirender).
1. Buat [ember S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html) dan a [StorageConfiguration](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_CreateStorageConfiguration.html)(tempat konten rekaman akan disimpan).
**Penting**: Jika Anda menggunakan bucket S3 yang sudah ada, setelan **Kepemilikan Objek** harus **diberlakukan oleh pemilik Bucket** atau lebih disukai **pemilik Bucket**. Untuk detailnya, lihat dokumentasi S3 tentang [pengendalian kepemilikan objek](https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html).
1. [Bergabunglah dengan panggung dan publikasikan ke sana](getting-started-pub-sub.md).
1. Saat Anda menerima [EventBridge acara](eventbridge.md) Peserta Published, hubungi [StartComposition](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_StartComposition.html)dengan DestinationConfiguration objek S3 sebagai tujuan
1. Setelah beberapa detik, Anda akan dapat melihat segmen HLS disimpan ke ember S3 Anda.
![\[Merekam panggung ke bucket S3 menggunakan komposisi sisi server.\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/images/Composite_Recording_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. Untuk detailnya, lihat [Siklus Hidup Komposisi](ssc-overview.md#ssc-composition-endpoint) dalam Komposisi Sisi *Server*.
## Contoh Perekaman Komposit: StartComposition dengan Tujuan Bucket S3
Contoh di bawah ini menunjukkan panggilan tipikal ke [StartComposition](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_StartComposition.html)operasi, menentukan S3 sebagai satu-satunya tujuan untuk komposisi. Setelah komposisi bertransisi ke `ACTIVE` status, segmen video dan metadata akan mulai ditulis ke bucket S3 yang ditentukan oleh objek. `storageConfiguration` Untuk membuat komposisi dengan layout yang berbeda, lihat “Layouts” di [Server-Side Composition](ssc-overview.md#ssc-api-layouts) dan [IVS](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_LayoutConfiguration.html) Real-Time Streaming API Reference.
### Permintaan
```
POST /StartComposition HTTP/1.1
Content-type: application/json
{
"destinations": [
{
"s3": {
"encoderConfigurationArns": [
"arn:aws:ivs:ap-northeast-1:927810967299:encoder-configuration/PAAwglkRtjge"
],
"storageConfigurationArn": "arn:aws:ivs:ap-northeast-1:927810967299:storage-configuration/ZBcEbgbE24Cq",
"thumbnailConfigurations": [
{
"storage": ["LATEST", "SEQUENTIAL"],
"targetIntervalSeconds": 30
}
]
}
}
],
"idempotencyToken": "db1i782f1g9",
"stageArn": "arn:aws:ivs:ap-northeast-1:927810967299:stage/WyGkzNFGwiwr"
}
```
### Respons
```
{
"composition": {
"arn": "arn:aws:ivs:ap-northeast-1:927810967299:composition/s2AdaGUbvQgp",
"destinations": [
{
"configuration": {
"name": "",
"s3": {
"encoderConfigurationArns": [
"arn:aws:ivs:ap-northeast-1:927810967299:encoder-configuration/PAAwglkRtjge"
],
"recordingConfiguration": {
"format": "HLS"
},
"storageConfigurationArn": "arn:aws:ivs:ap-northeast-1:927810967299:storage-configuration/ZBcEbgbE24Cq",
"thumbnailConfigurations": [
{
"storage": ["LATEST", "SEQUENTIAL"],
"targetIntervalSeconds": 30
}
]
}
},
"detail": {
"s3": {
"recordingPrefix": "MNALAcH9j2EJ/s2AdaGUbvQgp/2pBRKrNgX1ff/composite"
}
},
"id": "2pBRKrNgX1ff",
"state": "STARTING"
}
],
"layout": null,
"stageArn": "arn:aws:ivs:ap-northeast-1:927810967299:stage/WyGkzNFGwiwr",
"startTime": "2023-11-01T06:25:37Z",
"state": "STARTING",
"tags": {}
}
}
```
`recordingPrefix`Bidang, yang ada dalam StartComposition respons dapat digunakan untuk menentukan di mana konten rekaman akan disimpan.
## Isi Rekaman
Saat komposisi bertransisi ke `ACTIVE` status, segmen video HLS, file metadata, dan thumbnail (jika dikonfigurasi) akan mulai ditulis ke bucket S3 yang ditentukan selama panggilan berlangsung. StartComposition Konten ini tersedia untuk pasca-pemrosesan atau pemutaran sebagai video sesuai permintaan.
Perhatikan bahwa setelah komposisi menjadi live, peristiwa “Perubahan Status Komposisi IVS” dipancarkan, dan mungkin perlu sedikit waktu sebelum file manifes, segmen video, dan thumbnail ditulis. Kami menyarankan Anda memutar ulang atau memproses streaming yang direkam hanya setelah acara “Perubahan Status Komposisi IVS (Akhir Sesi)” 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:
```
MNALAcH9j2EJ/s2AdaGUbvQgp/2pBRKrNgX1ff/composite
events
recording-started.json
recording-ended.json
media
hls
thumbnails
latest_thumbnail
```
`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 akan 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 komposisi dan dapat dimainkan dengan pemutar IVS. Manifes HLS terletak di `multivariant.m3u8` folder. Jika dikonfigurasi, `latest_thumbnail` subfolder `thumbnails` dan berisi file media thumbnail JPEG yang dihasilkan selama sesi komposisi.
## Kebijakan Bucket untuk StorageConfiguration
Saat StorageConfiguration objek dibuat, IVS akan mendapatkan akses untuk menulis konten ke bucket S3 yang ditentukan. Akses ini diberikan dengan melakukan modifikasi pada kebijakan bucket S3. *Jika kebijakan untuk bucket diubah dengan cara yang menghapus akses IVS, rekaman yang sedang berlangsung dan baru akan gagal.*
Contoh di bawah ini menunjukkan kebijakan bucket S3 yang memungkinkan IVS menulis ke bucket S3:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "CompositeWrite-y1d212y",
"Effect": "Allow",
"Principal": {
"Service": "ivs-composite.ap-northeast-1.amazonaws.com"
},
"Action": [
"s3:PutObject",
"s3:PutObjectAcl"
],
"Resource": "arn:aws:s3:::my-s3-bucket/*",
"Condition": {
"StringEquals": {
"s3:x-amz-acl": "bucket-owner-full-control"
},
"Bool": {
"aws:SecureTransport": "true"
}
}
}
]
}
```
------
## File Metadata JSON
Metadata ini dalam format JSON. Ini terdiri dari informasi berikut:
| Bidang | Tipe | Diperlukan | Deskripsi |
| --- | --- | --- | --- |
| `stage_arn` | string | Ya | ARN dari panggung yang digunakan sebagai sumber komposisi. |
| `media` | object | Ya | Objek yang berisi objek yang disebutkan dari konten media yang tersedia untuk rekaman ini. Nilai yang valid:`"hls"`. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-composite-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-composite-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-composite-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-composite-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-composite-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-composite-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-composite-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-composite-recording.html) | int | Bersyarat | Tinggi resolusi piksel dari video yang dikodekan. Ini hanya tersedia ketika rendisi berisi trek video. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | int | Bersyarat | Lebar resolusi piksel dari video yang dikodekan. Ini hanya tersedia ketika rendisi berisi trek video. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-composite-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-composite-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-composite-recording.html) | object | Ya | Array resolusi (varian thumbnail) objek metadata. Setidaknya selalu ada satu resolusi. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | string | Ya | Jalur relatif dari awalan S3 tempat konten thumbnail disimpan untuk resolusi ini. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | int | Ya | Tinggi resolusi piksel dari thumbnail. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | int | Ya | Lebar resolusi piksel dari thumbnail. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-composite-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-composite-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-composite-recording.html) | object | Ya | Array resolusi (varian thumbnail) objek metadata. Setidaknya selalu ada satu resolusi. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | string | Ya | Jalur relatif dari awalan S3 tempat thumbnail terbaru disimpan untuk resolusi ini. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | int | Ya | Tinggi resolusi piksel dari thumbnail terbaru. |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/ivs/latest/RealTimeUserGuide/rt-composite-recording.html) | int | Ya | Lebar resolusi piksel dari thumbnail terbaru. |
| `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"`. `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_started_at` | string | Bersyarat | Stempel waktu RFC 3339 UTC saat perekaman dimulai. Ini tidak tersedia kapan`recording_status`. `RECORDING_START_FAILED` Lihat catatan di atas untuk`recording_ended_at`. |
| `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"`. |
| `version` | string | Ya | Versi skema metadata. |
### Contoh: recording-started.json
```
{
"version": "v1",
"stage_arn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/aAbBcCdDeE12",
"recording_started_at": "2023-11-01T06:01:36Z",
"recording_status": "RECORDING_STARTED",
"media": {
"hls": {
"path": "media/hls",
"playlist": "multivariant.m3u8",
"renditions": [
{
"path": "720p30-abcdeABCDE12",
"playlist": "playlist.m3u8",
"resolution_width": 1280,
"resolution_height": 720
}
]
},
"thumbnails": {
"path": "media/thumbnails",
"resolutions": [
{
"path": "1280x720",
"resolution_width": 1280,
"resolution_height": 720
}
]
},
"latest_thumbnail": {
"path": "media/latest_thumbnail",
"resolutions": [
{
"path": "1280x720",
"resolution_width": 1280,
"resolution_height": 720
}
]
}
}
}
```
### Contoh: recording-ended.json
```
{
"version": "v1",
"stage_arn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/aAbBcCdDeE12",
"recording_started_at": "2023-10-27T17:00:44Z",
"recording_ended_at": "2023-10-27T17:08:24Z",
"recording_status": "RECORDING_ENDED",
"media": {
"hls": {
"duration_ms": 460315,
"path": "media/hls",
"playlist": "multivariant.m3u8",
"renditions": [
{
"path": "720p30-abcdeABCDE12",
"playlist": "playlist.m3u8",
"resolution_width": 1280,
"resolution_height": 720
}
]
},
"thumbnails": {
"path": "media/thumbnails",
"resolutions": [
{
"path": "1280x720",
"resolution_width": 1280,
"resolution_height": 720
}
]
},
"latest_thumbnail": {
"path": "media/latest_thumbnail",
"resolutions": [
{
"path": "1280x720",
"resolution_width": 1280,
"resolution_height": 720
}
]
}
}
}
```
### Contoh: perekaman-failed.json
```
{
"version": "v1",
"stage_arn": "arn:aws:ivs:ap-northeast-1:123456789012:stage/aAbBcCdDeE12",
"recording_started_at": "2023-10-27T17:00:44Z",
"recording_ended_at": "2023-10-27T17:08:24Z",
"recording_status": "RECORDING_ENDED_WITH_FAILURE",
"media": {
"hls": {
"duration_ms": 460315,
"path": "media/hls",
"playlist": "multivariant.m3u8",
"renditions": [
{
"path": "720p30-abcdeABCDE12",
"playlist": "playlist.m3u8",
"resolution_width": 1280,
"resolution_height": 720
}
]
},
"thumbnails": {
"path": "media/thumbnails",
"resolutions": [
{
"path": "1280x720",
"resolution_width": 1280,
"resolution_height": 720
}
]
},
"latest_thumbnail": {
"path": "media/latest_thumbnail",
"resolutions": [
{
"path": "1280x720",
"resolution_width": 1280,
"resolution_height": 720
}
]
}
}
}
```
## Pemutaran Konten Rekaman dari Bucket Pribadi
Secara default, konten yang direkam bersifat pribadi; karenanya, objek ini tidak dapat diakses untuk pemutaran menggunakan URL S3 langsung. Jika Anda mencoba membuka daftar putar multivariat HLS (file m3u8) untuk pemutaran menggunakan pemutar IVS atau pemutar lain, Anda akan mendapatkan kesalahan (misalnya, “Anda tidak memiliki izin untuk mengakses sumber daya yang diminta”). Sebagai gantinya, Anda dapat memutar kembali file-file ini dengan Amazon CloudFront CDN (Jaringan Pengiriman Konten).
CloudFront distribusi dapat dikonfigurasi untuk menyajikan konten dari bucket pribadi. Biasanya ini lebih disukai daripada memiliki bucket yang dapat diakses secara terbuka di mana pembacaan melewati kontrol yang ditawarkan oleh. CloudFront Anda dapat mengatur distribusi agar dilayani dari bucket pribadi dengan membuat kontrol akses asal (OAC), yang merupakan CloudFront pengguna khusus yang memiliki izin membaca di bucket asal pribadi. Anda dapat membuat OAC setelah membuat distribusi, melalui CloudFront konsol atau API. Lihat [Membuat kontrol akses asal baru](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/private-content-restricting-access-to-s3.html#create-oac-overview-s3) di *Panduan CloudFront Pengembang Amazon*.
### Menyiapkan Pemutaran menggunakan CloudFront CORS Diaktifkan
Contoh ini mencakup bagaimana pengembang dapat mengatur CloudFront distribusi dengan CORS diaktifkan, memungkinkan pemutaran rekaman mereka dari domain apa pun. Ini sangat berguna selama fase pengembangan, tetapi Anda dapat memodifikasi contoh di bawah ini agar sesuai dengan kebutuhan produksi Anda.
#### Langkah 1: Buat Bucket S3
Buat bucket S3 yang akan digunakan untuk menyimpan rekaman. Perhatikan bahwa bucket harus berada di wilayah yang sama dengan yang Anda gunakan untuk alur kerja IVS Anda.
Tambahkan kebijakan CORS permisif ke bucket:
1. Di konsol AWS, buka tab **S3 Bucket Permissions**.
1. Salin kebijakan CORS di bawah ini dan tempel di bawah **Cross-origin resource sharing (CORS)**. Ini akan memungkinkan akses CORS pada bucket S3.
```
[
{
"AllowedHeaders": [
"*"
],
"AllowedMethods": [
"PUT",
"POST",
"DELETE",
"GET"
],
"AllowedOrigins": [
"*"
],
"ExposeHeaders": [
"x-amz-server-side-encryption",
"x-amz-request-id",
"x-amz-id-2"
]
}
]
```
#### Langkah 2: Buat CloudFront Distribusi
Lihat [Membuat CloudFront distribusi](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-console.html) di *Panduan CloudFront Pengembang*.
Menggunakan konsol AWS, masukkan informasi berikut:
| Untuk bidang ini... | Pilih ini... |
| --- | --- |
| Domain Asal | Bucket S3 dibuat pada langkah sebelumnya |
| Akses Asal | Pengaturan kontrol akses asal (disarankan), menggunakan parameter default |
| Perilaku cache default: Kebijakan Protokol Penampil | Arahkan ulang HTTP ke HTTPS |
| Perilaku cache default: Metode HTTP yang diizinkan | DAPATKAN, KEPALA, dan OPSI |
| Perilaku cache default: Kunci cache dan permintaan asal | CachingDisabled kebijakan |
| Perilaku cache default: Kebijakan permintaan asal | CORS-S3asal |
| Perilaku cache default: Kebijakan header respons | SimpleCORS |
| Firewall Aplikasi Web | Aktifkan perlindungan keamanan |
Kemudian simpan CloudFront distribusinya.
#### Langkah 3: Siapkan Kebijakan Bucket S3
1. Hapus semua StorageConfiguration yang telah Anda atur untuk bucket S3. Ini akan menghapus kebijakan bucket apa pun yang ditambahkan secara otomatis saat membuat kebijakan untuk bucket tersebut.
1. Buka CloudFront Distribusi Anda, pastikan semua bidang distribusi berada di status yang ditentukan pada langkah sebelumnya, dan **Salin Kebijakan Bucket** (gunakan tombol **Salin kebijakan**).
1. Pergi ke ember S3 Anda. Pada tab **Izin**, pilih **Edit Kebijakan Bucket** dan tempel kebijakan bucket yang Anda salin di langkah sebelumnya. Setelah langkah ini, kebijakan bucket harus memiliki CloudFront kebijakan secara eksklusif.
1. Buat StorageConfiguration, tentukan bucket S3.
Setelah StorageConfiguration dibuat, Anda akan melihat dua item dalam kebijakan bucket S3, satu memungkinkan CloudFront untuk membaca konten dan satu lagi memungkinkan IVS untuk menulis konten. Contoh kebijakan bucket final, with CloudFront dan akses IVS, ditampilkan di [Contoh: Kebijakan Bucket S3 dengan CloudFront dan Akses IVS](#comp-rec-playback-example).
#### Langkah 4: Putar Kembali Rekaman
Setelah berhasil mengatur CloudFront distribusi dan memperbarui kebijakan bucket, Anda harus dapat memutar ulang rekaman menggunakan pemutar IVS:
1. Berhasil memulai Komposisi dan pastikan Anda memiliki rekaman yang tersimpan di bucket S3.
1. Setelah mengikuti Langkah 1 hingga Langkah 3 dalam contoh ini, file video harus tersedia untuk dikonsumsi melalui CloudFront URL. CloudFront URL Anda adalah **nama domain Distribusi** pada tab **Detail** di CloudFront konsol Amazon. Seharusnya seperti ini:
`a1b23cdef4ghij.cloudfront.net`
1. Untuk memutar video yang direkam melalui CloudFront distribusi, temukan kunci objek untuk `multivariant.m3u8` file Anda di bawah bucket s3. Seharusnya seperti ini:
`FDew6Szq5iTt/9NIpWJHj0wPT/fjFKbylPb3k4/composite/media/hls/multivariant.m3u8`
1. Tambahkan kunci objek ke akhir CloudFront URL Anda. URL akhir Anda akan menjadi seperti ini:
`https://a1b23cdef4ghij.cloudfront.net/FDew6Szq5iTt/9NIpWJHj0wPT/fjFKbylPb3k4/composite/media/hls/multivariant.m3u8`
1. Anda sekarang dapat menambahkan URL akhir ke atribut sumber pemutar IVS untuk menonton rekaman lengkap. Untuk menonton video yang direkam, Anda dapat menggunakan demo di [Memulai](https://docs.aws.amazon.com//ivs/latest/LowLatencyUserGuide/web-getting-started.html) di *IVS Player SDK: Panduan Web*.
### Contoh: Kebijakan Bucket S3 dengan CloudFront dan Akses IVS
Cuplikan di bawah ini mengilustrasikan kebijakan bucket S3 yang memungkinkan membaca konten CloudFront ke bucket pribadi dan IVS untuk menulis konten ke bucket. **Catatan: Jangan menyalin dan menempelkan cuplikan di bawah ini ke ember Anda sendiri. Kebijakan Anda harus berisi IDs yang relevan dengan CloudFront distribusi Anda dan StorageConfiguration.**
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "CompositeWrite-7eiKaIGkC9DO",
"Effect": "Allow",
"Principal": {
"Service": "ivs-composite.ap-northeast-1.amazonaws.com"
},
"Action": [
"s3:PutObject",
"s3:PutObjectAcl"
],
"Resource": "arn:aws:s3:::eicheane-test-1026-2-ivs-recordings/*",
"Condition": {
"StringEquals": {
"s3:x-amz-acl": "bucket-owner-full-control"
},
"Bool": {
"aws:SecureTransport": "true"
}
}
},
{
"Sid": "AllowCloudFrontServicePrincipal",
"Effect": "Allow",
"Principal": {
"Service": "cloudfront.amazonaws.com"
},
"Action": "s3:GetObject",
"Resource": "arn:aws:s3:::eicheane-test-1026-2-ivs-recordings/*",
"Condition": {
"StringEquals": {
"AWS:SourceArn": "arn:aws:cloudfront::844311324168:distribution/E1NG4YMW5MN25A"
}
}
}
]
}
```
------
## Pemecahan masalah
+ **Komposisi tidak ditulis ke bucket S3 — Pastikan bucket** dan StorageConfiguration objek S3 dibuat dan berada di wilayah yang sama. Pastikan juga bahwa IVS memiliki akses ke bucket dengan memeriksa kebijakan bucket Anda; lihat [Kebijakan Bucket untuk StorageConfiguration](#comp-rec-bucket-policy).
+ **Saya tidak dapat menemukan komposisi saat tampil *ListCompositions*—** Komposisi adalah sumber daya fana. Setelah mereka beralih ke keadaan akhir, mereka dihapus secara otomatis setelah beberapa menit.
+ **Komposisi saya berhenti secara otomatis —** Komposisi akan berhenti secara otomatis jika tidak ada penerbit di atas panggung selama lebih dari 60 detik.
## Masalah yang Diketahui
Daftar putar media yang ditulis oleh rekaman komposit memiliki tag `#EXT-X-PLAYLIST-TYPE:EVENT` saat komposisi sedang berlangsung. Ketika komposisi selesai, tag diperbarui ke`#EXT-X-PLAYLIST-TYPE:VOD`. Untuk pengalaman pemutaran yang lancar, kami sarankan Anda menggunakan daftar putar ini hanya setelah komposisi berhasil diselesaikan.