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

IVS Auto-Record ke Amazon S3 | Streaming Low-Latency

Bagian ini memberikan informasi tentang fitur Auto-Record-to-S3 dari streaming latensi rendah Amazon IVS. Kami membahas penyimpanan data untuk aliran 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 streaming langsung yang direkam. Semua file media dan metadata untuk streaming langsung ditulis dalam direktori ini. Untuk saluran dengan perekaman diaktifkan, awalan S3 dihasilkan saat 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:

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 Recording Start dipancarkan, dibutuhkan sedikit waktu sebelum file manifes dan segmen video ditulis. Kami menyarankan Anda memutar ulang atau memproses streaming yang direkam hanya setelah peristiwa Rekaman Akhir 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

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

F events older yang diberikan akan berisi recording-started.json dan recording-ended.json ataurecording-failed.json.

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

F media older berisi semua konten media yang didukung, dalam dua subfolder:

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

Byte-Range Daftar Putar

Fitur Auto-Record-to-S3 mendukung pembuatan daftar putar rentang byte, selain daftar putar HLS standar. Byte-range daftar putar 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 sub-range byte dari potongan video, memberikan perincian lebih dari ukuran file media 10 detik standar. Dengan daftar putar rentang byte, durasi segmen sama dengan interval keyframe yang dikonfigurasi untuk streaming.

Thumbnail

Pro thumbnailConfiguration perti pada konfigurasi perekaman memungkinkan Anda untuk mengaktifkan atau menonaktifkan perekaman thumbnail untuk sesi langsung dan mengubah interval di mana thumbnail dibuat untuk sesi langsung. Interval thumbnail dapat berkisar dari 1 detik hingga 60 detik; secara default, perekaman thumbnail diaktifkan, dengan interval 60 detik. Untuk detailnya, lihat Refer ensi API Low-Latency Streaming Amazon IVS.

Konfigurasi thumbnail juga dapat mencakup storage bidang (SEQUENTIAL and/or LATEST) 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

Jika resolution tidak disetel untuk aliran yang menggunakan input video multitrack, thumbnail dari semua rendering akan direkam. Untuk informasi tentang multitrack, lihat Video Multitrack.

Gabungkan Aliran Terfragmentasi

Pro recordingReconnectWindowSeconds perti pada konfigurasi perekaman memungkinkan Anda menentukan jendela waktu (dalam detik) di mana, jika streaming 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: Peristiwa Akhir Perek aman dan file metadata JSON yang berakhir perekaman ditunda setidaknyarecordingReconnectWindowSeconds, karena Amazon IVS menunggu untuk memastikan aliran baru tidak dimulai.

Untuk petunjuk tentang cara mengatur fungsionalitas merge-stream, lihat Langkah 3: Buat Saluran dengan Rekaman Opsional di Mem ulai dengan Amazon IVS.

Kelayakan

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

Catatan:

Masalah yang Diketahui

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

File Metadata JSON

Ketika peristiwa perubahan status perekaman terjadi, CloudWatch metrik Amazon yang sesuai dihasilkan dan file metadata ditulis dalam awalan S3. (Lihat Mem antau Amazon IVS Low-Latency Streaming.)

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_WITH_FAILURE",
   "recording_status_message": "InternalServerException",
   "media": {
      "hls": {
         "duration_ms": 172794489,
         "path": "media/hls",
         "playlist": "master.m3u8",
         "renditions": [
            {
               "path": "480p30",
               "playlist": "playlist.m3u8",
               "resolution_height": 480,
               "resolution_width": 852
            },
            {
               "path": "720p60",
               "playlist": "playlist.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-s3 menggunakan video sumber untuk menghasilkan beberapa rendering. Menggunakan Adaptive Bitrate Streaming (ABR), Amazon IVS Player secara otomatis mengalihkan rendering (bitrate) sesuai kebutuhan untuk mengoptimalkan pemutaran untuk berbagai kondisi jaringan.

Setiap rendering 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 perekaman adalahALL, semua rendering dipilih untuk perekaman. Jika renditionSelection yaCUSTOM, pengguna harus memilih satu atau lebih opsi berikut:LOWEST_RESOLUTION,SD,HD, danFULL_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 rendering yang dihasilkan, karena ini dapat berubah. Jangan berasumsi bahwa rendisi tertentu akan selalu tersedia untuk rekaman Amazon IVS. Untuk menentukan rendering, resolusi, dan jalur yang tersedia, lihat file metadata.

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

Berikut adalah cuplikan kode Python yang menunjukkan cara membuat jalur daftar putar utama menggunakan awalan rekaman 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 rendering yang direkam. Pro resolution_height resolution_width perti dan dapat digunakan untuk mengidentifikasi resolusi video. playlistElem path en dan dapat digunakan untuk memperoleh jalur daftar putar rendisi. Gunakan bidang ini untuk menentukan rendisi mana yang akan digunakan untuk pemrosesan pasca apa pun.

Untuk menemukan daftar putar rendisi tertinggi yang tersedia untuk rekaman, Anda dapat berlangganan acara “IVS Recording State Change”. EventBridge (Lihat Menggunakan Amazon EventBridge dengan IVS). Di bawah ini adalah contoh skrip Python yang menggambarkan penggunaan fungsi lambda yang berlangganan acara 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 Auto-Record ke Amazon S3 bersifat pribadi secara default; oleh karena itu, 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 (Content Delivery Network).

Distri CloudFront busi 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 untuk layanan dari bucket pribadi dengan membuat kontrol akses asal (OAC), yang merupakan CloudFront pengguna khusus yang memiliki izin baca pada bucket asal pribadi. Anda dapat membuat OAC setelah Anda 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 Distri busi pada tab Detail di CloudFront konsol AWS. Seharusnya seperti ini:

a1b23cdef4ghij.cloudfront.net.

Untuk melakukan streaming video yang direkam melalui distribusi Anda, 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 mengkonfigurasi CORS di kedua CloudFront dan S3 bucket. Untuk CloudFront konfigurasi, ikuti petunjuk dalam Membuat kebijakan permintaan asal untuk melampirkan kebijakan permintaan CORS-S3 Origin dan kebijakan header respons SimpleCors ke CloudFront distribusi. 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 ulang video yang direkam seolah-olah Anda sedang memutar langsung dari ember.

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