Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Petunjuk CLI untuk Membuat Saluran IVS
Membuat saluran dengan 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).
Ikuti salah satu dari dua prosedur di bawah ini, tergantung pada apakah Anda ingin membuat saluran dengan atau tanpa rekaman diaktifkan.
## Buat Saluran Tanpa Merekam
1. Jalankan `create-channel` perintah dan berikan nama opsional:
```
aws ivs create-channel --name test-channel
```
1. Ini mengembalikan saluran baru:
```
{
"channel": {
"arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
"authorized": false,
"ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
"insecureIngest": false,
"latencyMode": "LOW",
"name": "channel-live",
"playbackRestrictionPolicyArn": "arn:aws:ivs:us-west-2:123456789012:playback-restriction-policy/abcdABCDefgh",
"playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
"recordingConfigurationArn": "none",
"srt": {
"endpoint": "a1b2c3d4e5f6.srt.live-video.net",
"passphrase: "ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ",
},
"tags": {},
"type": "STANDARD"
},
"streamKey": {
"arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6",
"channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
"tags": {},
"value": "sk_us-west-2_abcdABCDefgh_567890abcdef"
}
}
```
1. **Penting**: Perhatikan`ingestEndpoint`,`streamKey value`, dan`playbackUrl`. Anda akan menggunakan ini untuk mengatur streaming dan pemutaran.
## Buat Saluran dengan Rekaman
**Prasyarat:** Sebelum memulai prosedur ini, buat bucket Amazon S3 dan catat ARN-nya. Lihat [Memulai dengan Amazon S3](https://docs.aws.amazon.com//AmazonS3/latest/userguide/GetStartedWithS3.html). Bucket S3 harus berada di wilayah yang sama di mana Anda akan membuat konfigurasi perekaman; lihat masalah yang diketahui pada Langkah 1 di bawah ini.
Kemudian ikuti langkah-langkah ini untuk membuat saluran:
1. Jalankan `create-recording-configuration` perintah dan teruskan ARN bucket Amazon S3 yang ada:
```
aws ivs create-recording-configuration --name configuration-1 --destination-configuration s3={bucketName=test-bucket}
```
Secara opsional, teruskan `thumbnail-configuration` parameter untuk mengatur mode perekaman thumbnail dan interval thumbnail secara manual:
```
aws ivs create-recording-configuration --name configuration-1 --destination-configuration s3={bucketName=s3_bucket_name} --thumbnail-configuration recordingMode="INTERVAL",targetIntervalSeconds=60
```
Secara opsional, teruskan `recording-reconnect-window-seconds` parameter untuk mengaktifkan fungsionalitas gabungan aliran terfragmentasi:
```
aws ivs create-recording-configuration --name configuration-1 --destination-configuration s3={bucketName=test-bucket} --recording-reconnect-window-seconds 60
```
**Masalah yang diketahui:** Di wilayah us-east-1, jika Anda menggunakan AWS CLI untuk membuat konfigurasi perekaman, ia mengembalikan kesuksesan meskipun bucket S3 berada di wilayah yang berbeda. Dalam hal ini, konfigurasi perekaman adalah `CREATE_FAILED` (bukan`ACTIVE`). `state` (Di wilayah lain, CLI mengembalikan kegagalan dengan benar jika bucket berada di wilayah yang berbeda.)
**Solusi:** Pastikan bucket S3 Anda berada di wilayah yang sama dengan konfigurasi perekaman. Jika Anda membuat konfigurasi perekaman di wilayah yang berbeda sebagai bucket S3 Anda, hapus konfigurasi perekaman itu dan buat yang baru dengan bucket S3 dari wilayah yang benar.
1. Ini mengembalikan konfigurasi perekaman baru dengan ARN unik. Keadaan konfigurasi perekaman adalah`CREATING`, menunjukkan bahwa itu sedang dalam proses pembuatan.
```
{
"recordingConfiguration": {
"arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te",
"name": "configuration-1",
"destinationConfiguration": {
"s3": {
"bucketName": "s3_bucket_name"
}
},
"recordingReconnectWindowSeconds": 60,
"state": "CREATING",
"tags": {},
"thumbnailConfiguration": {
"recordingMode": "INTERVAL",
"targetIntervalSeconds": 60
}
}
}
```
1. Biasanya, pembuatan konfigurasi perekaman membutuhkan beberapa detik, tetapi bisa sampai 20 detik. Untuk memeriksa apakah konfigurasi perekaman telah dibuat, jalankan `get-recording-configuration` perintah:
```
aws ivs get-recording-configuration --arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te"
```
1. Ini mengembalikan respons yang menunjukkan bahwa konfigurasi perekaman telah dibuat (`state`is`ACTIVE`):
```
{
"recordingConfiguration": {
"arn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te",
"name": "configuration-1",
"destinationConfiguration": {
"s3": {
"bucketName": "s3_bucket_name"
}
},
"recordingReconnectWindowSeconds": 60,
"state": "ACTIVE",
"tags": {},
"thumbnailConfiguration": {
"recordingMode": "INTERVAL",
"targetIntervalSeconds": 60
}
}
}
```
1. Untuk membuat saluran dan mengaktifkan perekaman di atasnya, jalankan `create-channel` perintah dan teruskan ARN konfigurasi perekaman:
```
aws ivs create-channel --name channel-live --recording-configuration-arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te"
```
Bergantian, untuk mengaktifkan perekaman pada saluran yang ada, jalankan `update-channel` perintah dan teruskan ARN konfigurasi perekaman:
```
aws ivs update-channel --arn "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh" --recording-configuration-arn "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te"
```
1. Ini mengembalikan objek saluran dengan nilai non-"tidak ada” untuk`recordingConfigurationArn`, menunjukkan bahwa perekaman diaktifkan. (Tanggapan di bawah ini adalah dari`create-channel`. `update-channel`Tanggapan tidak termasuk `streamKey` objek.)
```
{
"channel": {
"arn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
"authorized": false,
"ingestEndpoint": "a1b2c3d4e5f6.global-contribute.live-video.net",
"insecureIngest": false,
"latencyMode": "LOW",
"name": "channel-live",
"playbackUrl": "https://a1b2c3d4e5f6.us-west-2.playback.live-video.net/api/video/v1/us-west-2.123456789012.channel.abcdEFGH.m3u8",
"recordingConfigurationArn": "arn:aws:ivs:us-west-2:123456789012:recording-configuration/mhndauNaO1te",
"srt": {
"endpoint": "a1b2c3d4e5f6.srt.live-video.net",
"passphrase: "ZU5A3yrjGAkghUNDr0c5NXBhsPrjlmtcKMNBluh7oImwJQ3ijeyClvMKxlpPcGAMziICJ",
},
"tags": {},
"type": "STANDARD"
},
"streamKey": {
"arn": "arn:aws:ivs:us-west-2:123456789012:stream-key/g1H2I3j4k5L6",
"channelArn": "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh",
"tags": {},
"value": "sk_us-west-2_abcdABCDefgh_567890abcdef"
}
}
```
1. **Penting**: Perhatikan`ingestEndpoint`,`streamKey value`, dan`playbackUrl`. Anda akan menggunakan ini untuk mengatur streaming dan pemutaran.