Petunjuk CLI untuk Membuat Saluran IVS - Amazon IVS
Buat Saluran Tanpa MerekamBuat Saluran dengan Rekaman

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

  1. Jalankan create-channel perintah dan berikan nama opsional:

    aws ivs create-channel --name test-channel

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

  3. Penting: PerhatikaningestEndpoint,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:

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

  2. Ini mengembalikan konfigurasi perekaman baru dengan ARN unik. Keadaan konfigurasi perekaman adalahCREATING, 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
      }
   }
}

  3. 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"

  4. Ini mengembalikan respons yang menunjukkan bahwa konfigurasi perekaman telah dibuat (stateisACTIVE):

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

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

  6. Ini mengembalikan objek saluran dengan nilai non-"tidak ada” untukrecordingConfigurationArn, yang menunjukkan bahwa perekaman diaktifkan. (Tanggapan di bawah ini adalah daricreate-channel. update-channelTanggapan 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"
   }
}

  7. Penting: PerhatikaningestEndpoint,streamKey value, danplaybackUrl. Anda akan menggunakan ini untuk mengatur streaming dan pemutaran.