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.
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
-
Jalankan
create-channel
perintah dan berikan nama opsional:aws ivs create-channel --name test-channel
-
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" } }
-
Penting: Perhatikan
ingestEndpoint
,streamKey value
, danplaybackUrl
. 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. 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:
-
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
(bukanACTIVE
).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.
-
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 } } }
-
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"
-
Ini mengembalikan respons yang menunjukkan bahwa konfigurasi perekaman telah dibuat (
state
isACTIVE
):{ "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 } } }
-
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"
-
Ini mengembalikan objek saluran dengan nilai non-"tidak ada” untuk
recordingConfigurationArn
, yang menunjukkan bahwa perekaman diaktifkan. (Tanggapan di bawah ini adalah daricreate-channel
.update-channel
Tanggapan tidak termasukstreamKey
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" } }
-
Penting: Perhatikan
ingestEndpoint
,streamKey value
, danplaybackUrl
. Anda akan menggunakan ini untuk mengatur streaming dan pemutaran.