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

Rekam Otomatis ke Amazon S3 (Streaming Latensi Rendah)

Bagian ini memberikan informasi tentang fitur auto-record-to -S3 dari streaming latensi rendah Amazon IVS. Kami membahas penyimpanan data untuk streaming Amazon IVS yang direkam. Kami menjelaskan konten penyimpanan dan skema file metadata. Kami juga membahas pemutaran konten rekaman Anda.

Awalan S3

Awalan S3 adalah struktur direktori unik untuk setiap live stream yang direkam. Semua file media dan metadata untuk streaming langsung ditulis dalam direktori ini. Untuk saluran dengan perekaman diaktifkan, awalan S3 dihasilkan ketika sesi langsung dimulai dan akan disediakan dalam CloudWatch acara di awal dan akhir rekaman.

Awalan S3 memiliki format berikut:

/ivs/v1/<aws_account_id>/<channel_id>/<year>/<month>/<day>/<hours>/<minutes>/<recording_id>

Di mana:

Sebagai contoh:

ivs/v1/123456789012/AsXego4U6tnj/2020/6/23/20/12/j8Z9O91ndcVs

Isi Rekaman

Saat perekaman dimulai, segmen video dan file metadata ditulis ke bucket S3 yang dikonfigurasi untuk saluran. Konten ini tersedia untuk pasca-pemrosesan atau pemutaran sebagai video sesuai permintaan.

Perhatikan bahwa setelah streaming langsung dimulai dan EventBridge acara Mulai Perekaman dipancarkan, dibutuhkan sedikit waktu sebelum file manifes dan segmen video ditulis. Kami menyarankan Anda memutar ulang atau memproses streaming yang direkam hanya setelah acara Akhir Perekaman dikirim. (Lihat Menggunakan Amazon EventBridge dengan IVS).

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

ivs/v1/123456789012/AsXego4U6tnj/2020/6/23/20/12/j8Z9O91ndcVs/
   events
      recording-started.json
      recording-ended.json
   media
      hls
      thumbnails

eventsFolder berisi file metadata yang sesuai dengan peristiwa perekaman. File metadata JSON dihasilkan saat perekaman dimulai, berakhir dengan sukses, atau diakhiri dengan kegagalan:

eventsFolder yang diberikan akan berisi recording-started.json dan salah satu recording-ended.json ataurecording-failed.json.

Ini berisi metadata yang terkait dengan sesi rekaman dan format outputnya. Rincian JSON diberikan di bawah ini.

mediaFolder berisi semua konten media yang didukung, dalam dua subfolder:

Penting: Konten dalam media folder dihasilkan secara dinamis dan ditentukan oleh karakteristik segmen video pertama yang diterima; konten folder mungkin tidak mewakili karakteristik utama (misalnya, kualitas rendisi). Jangan membuat asumsi tentang jalur statis. Untuk menemukan rendisi HLS yang tersedia dan jalurnya, gunakan file metadata JSON yang dijelaskan di bawah ini.

Daftar Putar Byte-Range

Fitur auto-record-to -S3 mendukung pembuatan daftar putar rentang byte, selain daftar putar HLS standar. Daftar putar rentang byte sesuai dengan versi 4 dari spesifikasi HLS. Hal ini memungkinkan kliping konten yang lebih halus: dalam daftar putar rentang byte, setiap segmen dalam file indeks rendisi mereferensikan subrange byte dari potongan video, memberikan perincian lebih dari ukuran file media 10 detik standar. Dengan playlist byte-range, durasi segmen sama dengan interval keyframe yang dikonfigurasi untuk streaming.

Thumbnail

thumbnailConfigurationProperti pada konfigurasi perekaman memungkinkan Anda untuk mengaktifkan atau menonaktifkan perekaman thumbnail untuk sesi langsung dan memodifikasi interval di mana thumbnail dihasilkan untuk sesi langsung. Interval thumbnail dapat berkisar dari 1 detik hingga 60 detik; secara default, perekaman thumbnail diaktifkan, pada interval 60 detik. Untuk detailnya, lihat Referensi Amazon IVS API.

Konfigurasi thumbnail juga dapat mencakup storage bidang (SEQUENTIALdan/atauLATEST) dan resolusi (LOWEST_RESOLUTION,, SDHD, atauFULL_HD). Di bawah ini adalah resolusi untuk setiap opsi:

160 <= LOWEST_RESOLUTION <= 360

360 < SD <= 480

480 < HD <= 720

720 < FULL_HD <= 1080

Gabungkan Aliran Terfragmentasi

recordingReconnectWindowSecondsProperti pada konfigurasi perekaman memungkinkan Anda menentukan jendela waktu (dalam detik) di mana, jika aliran Anda terganggu dan aliran baru dimulai, Amazon IVS mencoba merekam ke awalan S3 yang sama dengan aliran sebelumnya. Dengan kata lain, jika siaran terputus dan kemudian terhubung kembali dalam interval yang ditentukan, beberapa aliran dianggap sebagai siaran tunggal dan digabungkan bersama.

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

Untuk petunjuk cara menyiapkan fungsionalitas penggabungan aliran, lihat Langkah 4: Buat Saluran dengan Rekaman Opsional di Memulai Amazon IVS.

Kelayakan

Agar beberapa aliran merekam ke awalan S3 yang sama, kondisi tertentu harus dipenuhi untuk semua aliran:

Catatan:

Masalah yang Diketahui

Jika recordingReconnectWindowSeconds diaktifkan dan Web Broadcast SDK digunakan, perekaman ke awalan S3 yang sama mungkin tidak berfungsi, karena Web Broadcast SDK secara dinamis mengubah bitrate dan kualitas.

File Metadata JSON

Saat peristiwa perubahan status perekaman terjadi, CloudWatch metrik Amazon yang sesuai dibuat dan file metadata ditulis dalam awalan S3. (Lihat Memantau Streaming Latensi Rendah Amazon IVS.)

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

Contoh: recording_started.json

{
   "version" : "v1",
   "channel_arn" : "arn:aws:ivs:us-west-2:123456789012:channel/AsXego4U6tnj",
   "recording_started_at" : "2020-06-12T12:53:26Z",
   "recording_status : "RECORDING_STARTED",
   "media" : {
      "hls" : {
         "path" : "media/hls",
         "playlist" : "master.m3u8",
         "byte_range_playlist": "byte-range-multivariant.m3u8",
         "renditions" : [
            {
               "path" : "480p30",
               "playlist" : "playlist.m3u8",
               "byte_range_playlist": "byte-range-variant.m3u8",
               "resolution_height" : 480,
               "resolution_width" : 852
            },
            {
               "path" : "360p30",
               "playlist" : "playlist.m3u8",
               "byte_range_playlist": "byte-range-variant.m3u8",
               "resolution_height" : 360,
               "resolution_width" : 640
            },
            {
               "path" : "160p30",
               "playlist" : "playlist.m3u8",
               "byte_range_playlist": "byte-range-variant.m3u8",
               "resolution_height" : 160,
               "resolution_width" : 284
            },
            {
               "path" : "720p60",
               "playlist" : "playlist.m3u8",
               "byte_range_playlist": "byte-range-variant.m3u8",
               "resolution_height" : 720,
               "resolution_width" : 1280
            }
         ]
      },
      "thumbnails": {
         "path": "media/thumbnails",
         "resolution_height": 480,
         "resolution_width": 852
      },
      "latest_thumbnail": {
         "path": "media/latest_thumbnail/thumb.jpg",
         "resolution_height": 480,
         "resolution_width": 852
      }
   }
}

Contoh: recording_ended.json

{
   "version" : "v1",
   "channel_arn" : "arn:aws:ivs:us-west-2:123456789012:channel/AsXego4U6tnj",
   "recording_ended_at" : "2020-06-14T12:53:20Z",
   "recording_started_at" : "2020-06-12T12:53:26Z",
   "recording_status" : "RECORDING_ENDED",
   "media" : {
      "hls" : {
         "duration_ms" : 172794489,
         "path" : "media/hls",
         "playlist" : "master.m3u8",
         "byte_range_playlist": "byte-range-multivariant.m3u8",
         "renditions" : [
            {
               "path" : "480p30",
               "playlist" : "playlist.m3u8",
               "byte_range_playlist": "byte-range-variant.m3u8",
               "resolution_height" : 480,
               "resolution_width" : 852
            },
            {
               "path" : "360p30",
               "playlist" : "playlist.m3u8",
               "byte_range_playlist": "byte-range-variant.m3u8",
               "resolution_height" : 360,
               "resolution_width" : 640
            },
            {
               "path" : "160p30",
               "playlist" : "playlist.m3u8",
               "byte_range_playlist": "byte-range-variant.m3u8",
               "resolution_height" : 160,
               "resolution_width" : 284
            },
            {
               "path" : "720p60",
               "playlist" : "playlist.m3u8",
               "byte_range_playlist": "byte-range-variant.m3u8",
               "resolution_height" : 720,
               "resolution_width" : 1280
            }
         ]
      },
      "thumbnails": {
         "path": "media/thumbnails",
         "resolution_height": 480,
         "resolution_width": 852
      },
      "latest_thumbnail": {
         "path": "media/latest_thumbnail/thumb.jpg",
         "resolution_height": 480,
         "resolution_width": 852
      }
   }
}

Contoh: recording_failed.json

{
   "version" : "v1",
   "channel_arn" : "arn:aws:ivs:us-west-2:123456789012:channel/AsXego4U6tnj",
   "recording_ended_at" : "2020-06-14T12:53:20Z",
   "recording_started_at" : "2020-06-12T12:53:26Z",
   "recording_status" : "RECORDING_ENDED",
   "media" : {
      "hls" : {
         "duration_ms" : 172794489,
         "path" : "media/hls",
         "playlist" : "master.m3u8",
         "byte_range_playlist": "byte-range-multivariant.m3u8",
         "renditions" : [
            {
               "path" : "480p30",
               "playlist" : "playlist.m3u8",
               "byte_range_playlist": "byte-range-variant.m3u8",
               "resolution_height" : 480,
               "resolution_width" : 852
            },
            {
               "path" : "360p30",
               "playlist" : "playlist.m3u8",
               "byte_range_playlist": "byte-range-variant.m3u8",
               "resolution_height" : 360,
               "resolution_width" : 640
            },
            {
               "path" : "160p30",
               "playlist" : "playlist.m3u8",
               "byte_range_playlist": "byte-range-variant.m3u8",
               "resolution_height" : 160,
               "resolution_width" : 284
            },
            {
               "path" : "720p60",
               "playlist" : "playlist.m3u8",
               "byte_range_playlist": "byte-range-variant.m3u8",
               "resolution_height" : 720,
               "resolution_width" : 1280
            }
         ]
      },
      "thumbnails": {
         "path": "media/thumbnails",
         "resolution_height": 480,
         "resolution_width": 852
      },
      "latest_thumbnail": {
         "path": "media/latest_thumbnail/thumb.jpg",
         "resolution_height": 480,
         "resolution_width": 852
      }
   }
}

Menemukan Rendisi Rekaman

Saat Anda melakukan streaming konten ke saluran Amazon IVS, auto-record-to-s 3 menggunakan video sumber untuk menghasilkan beberapa rendisi. Menggunakan Adaptive Bitrate Streaming (ABR), Amazon IVS Player secara otomatis mengalihkan rendisi (bitrate) sesuai kebutuhan untuk mengoptimalkan pemutaran untuk berbagai kondisi jaringan.

Setiap rendisi yang dihasilkan selama streaming langsung direkam dalam jalur unik dalam awalan perekaman S3. Detail resolusi, jalur, dan nama file daftar putar disimpan dalam file metadata JSON selama awal dan penghentian perekaman. Jika renditionSelection nilai konfigurasi perekamanALL, semua rendisi dipilih untuk direkam. Jika renditionSelection yaCUSTOM, pengguna harus memilih satu atau beberapa opsi berikut:LOWEST_RESOLUTION,, SDHD, dan FULL_HD. Di bawah ini adalah resolusi untuk setiap opsi:

160 <= LOWEST_RESOLUTION <= 360

360 < SD <= 480

480 < HD <= 720

720 < FULL_HD <= 1080

Penting: Jangan membuat asumsi apa pun tentang jalur rendisi statis atau daftar rendisi yang dihasilkan, karena ini dapat berubah. Jangan berasumsi bahwa rendisi tertentu akan selalu tersedia untuk rekaman Amazon IVS. Untuk menentukan rendisi, resolusi, dan jalur yang tersedia, lihat file metadata.

event/recording_ended.jsonFile event/recording_started.json atau dalam awalan perekaman berisi jalur dan nama file media dalam awalan perekaman. Semua path elemen relatif terhadap jalur sebelumnya dalam hierarki. Elemen di bawah media > hls menggambarkan aset HLS, dengan nama daftar putar master dan jalur yang ditentukan pada level ini.

Berikut adalah cuplikan kode Python yang menunjukkan cara membuat jalur daftar putar master menggunakan awalan perekaman S3 dan file metadata:

def get_master_playlist(metadata_json, s3_recording_prefix):
   return s3_recording_prefix + '/' + metadata_json['media']['hls']['path'] + '/' + metadata_json['media']['hls']['playlist']

Elemen di bawah media > hls > renditions menggambarkan daftar rendisi yang direkam. resolution_widthProperti resolution_height dan dapat digunakan untuk mengidentifikasi resolusi video. playlistElemen path dan dapat digunakan untuk menurunkan jalur daftar putar rendisi. Gunakan bidang ini untuk menentukan rendisi mana yang akan digunakan untuk pemrosesan pos apa pun.

Untuk menemukan daftar putar rendisi tertinggi yang tersedia untuk rekaman, Anda dapat berlangganan acara “Perubahan Status Rekaman IVS”. EventBridge (Lihat Menggunakan Amazon EventBridge dengan IVS). Di bawah ini adalah contoh skrip Python yang menggambarkan penggunaan fungsi lambda berlangganan peristiwa tersebut.

import json
import boto3
s3 = boto3.resource('s3')

def get_highest_rendition_playlist(bucket_name, prefix_name):
   object_path = "{}/events/recording-started.json".format(prefix_name)
   object = s3.Object(bucket_name, object_path)
   body = str(object.get()['Body'].read().decode('utf-8'))
   metadata = json.loads(body)
   media_path = metadata["media"]["hls"]["path"]
   renditions = metadata["media"]["hls"]["renditions"]

   highest_rendition = None
   highest_rendition_size = 0

   for rendition in renditions:
       current_rendition_size = rendition["resolution_height"]
       if (current_rendition_size > highest_rendition_size):
           highest_rendition_size = current_rendition_size
           highest_rendition = rendition

   highest_rendition_playlist = media_path + '/' + highest_rendition['path'] + '/' + highest_rendition['playlist']
   return highest_rendition_playlist


def lambda_handler(event, context):
   prefix_name = event["detail"]["recording_s3_key_prefix"]
   bucket_name = event["detail"]["recording_s3_bucket_name"]
   rendition_playlist = get_highest_rendition_playlist(bucket_name, prefix_name)
   print("Highest rendition playlist: {}/{}".format(prefix_name, rendition_playlist))

   return {
       'statusCode': 200,
       'body': rendition_playlist
   }

Pemutaran Konten Rekaman dari Bucket Pribadi

Objek yang direkam dengan fitur Rekam Otomatis ke Amazon S3 bersifat pribadi secara default; karenanya, objek ini tidak dapat diakses untuk pemutaran menggunakan URL S3 langsung. Jika Anda mencoba membuka manifes master HLS (file m3u8) untuk pemutaran menggunakan pemutar Amazon 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 Amazon

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 Distribusi Anda dapat diatur ke layanan 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.

Pemutaran dari Amazon CloudFront

Setelah Anda mengatur distribusi menggunakan OAC untuk mendapatkan akses ke bucket pribadi Anda, file video Anda harus tersedia untuk dikonsumsi melalui CloudFront URL. CloudFront URL Anda adalah nama domain Distribusi pada tab Detail di CloudFront konsol AWS. Seharusnya seperti ini:

a1b23cdef4ghij.cloudfront.net.

Untuk melakukan streaming video yang direkam melalui distribusi, temukan kunci objek untuk master.m3u8 file Anda. Seharusnya seperti ini:

ivs/v1/012345678912/a0bCDeFGH1IjK/2021/4/20/12/03/aBcdEFghIjkL/media/hls/master.m3u8

Tambahkan kunci objek ke akhir CloudFront URL Anda. URL akhir Anda akan menjadi seperti ini:

https://a1b23cdef4ghij.cloudfront.net/ivs/v1/012345678912/a0bCDeFGH1IjK/2021/4/20/12/03/aBcdEFghIjkL/media/hls/master.m3u8

Untuk memutar kembali dari browser web, pastikan untuk mengonfigurasi CORS di bucket keduanya CloudFront dan S3. Untuk CloudFront konfigurasi, ikuti petunjuk dalam Membuat kebijakan permintaan asal untuk melampirkan kebijakan permintaan CORS-S3 Origin dan kebijakan header respons SimpleCORS ke distribusi. CloudFront Lihat contoh halaman konsol konfigurasi di bawah ini:

Untuk konfigurasi S3 CORS, lihat konfigurasi CORS untuk membuat aturan yang sesuai untuk bucket S3 Anda.

Sekarang Anda dapat memutar video yang direkam seolah-olah Anda sedang bermain langsung dari ember.

Untuk informasi selengkapnya, lihat Membatasi akses ke asal Amazon S3.