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

Video Multitrack Amazon IVS: Panduan Integrasi Perangkat Lunak Siaran

Pengantar

Agar alat atau layanan perangkat lunak penyiar pihak ketiga mengklaim bahwa ia mendukung video multitrack IVS, ia harus mengikuti panduan ini dan menerapkan dua fitur yang diperlukan, konfigurasi aliran otomatis dan metrik kinerja siaran. Kami sangat merekomendasikan juga menerapkan Fitur yang Direkomendasikan.

Diagram berikut menunjukkan interaksi tingkat tinggi antara perangkat lunak siaran Anda dan Amazon IVS:

Audiens

Dokumen ini ditujukan untuk pengembang perangkat lunak yang ingin menerapkan dukungan klien untuk video multitrack untuk:

Terminologi

Dokumen ini menggunakan beberapa istilah secara bergantian:

Fitur yang Diperlukan: Konfigurasi Aliran Otomatis

Konfigurasi aliran otomatis membantu pengguna memulai dengan cepat dan secara otomatis meningkatkan kualitas streaming dari waktu ke waktu. Alih-alih pengguna memilih pengaturan secara manual (misalnya, bitrate, resolusi, framerate) yang disetel sekali dan jarang diubah, konfigurasi aliran otomatis mempertimbangkan pengaturan perangkat lunak saat ini, konfigurasi perangkat keras, dan dukungan platform setiap kali pengguna memulai aliran baru. Misalnya, ketika pengguna memutakhirkan pengaturan (misalnya, dengan GPU baru), menginstal driver GPU baru, atau tujuan mulai mendukung codec baru (mis., H.265/HEVC), konfigurasi aliran otomatis bereaksi dan meningkatkan kualitas aliran pengguna berikutnya.

Langsung

Saat pengguna memulai streaming, perangkat lunak Anda harus menanyakan informasi tentang pengaturan perangkat keras dan perangkat lunak pengguna, memanggil GetClientConfiguration, mengonfigurasi video scaler/encoders, dan membuka koneksi RTMP (E-RTMP) yang disempurnakan. Langkah-langkah ini dijelaskan secara lebih rinci di bawah ini.

Gunakan GetClientConfiguration

GetClientConfigurationmembutuhkan informasi tentang pengaturan perangkat keras dan perangkat lunak pengguna.

Algoritma mempertimbangkan banyak faktor untuk memberikan konfigurasi yang:

Di dunia nyata, keterbatasan termasuk GPU yang lebih tua, jaringan mil pertama yang buruk, pengaturan pengguna tertentu, perdebatan sumber daya GPU, dan dukungan codec platform yang terbatas. Ketika dihadapkan dengan keterbatasan ini, konfigurasi aliran otomatis harus kembali secara bertahap dan dengan cara yang masuk akal. Contoh:

Mengekspos Preferensi kepada Pengguna

Anda harus mengaktifkan pengguna untuk mengkonfigurasi pengaturan berikut:

Opsional: Menetapkan Batas di Perangkat Lunak Siaran

Perangkat lunak atau layanan Anda dapat memberikan default atau membatasi kemampuan pengguna untuk mengkonfigurasi pengaturan ini. Misalnya, jika perangkat lunak atau layanan Anda perlu mempertahankan sumber daya GPU dan Anda ingin membatasi jumlah sesi encoder video yang digunakan oleh video multitrack, Anda dapat memilih untuk membatasi pengguna menjadi 3 Trek Video Maksimum dan menunjukkan dengan jelas kepada pengguna bahwa Otomatis berarti “hingga 3.”

Batas yang ditetapkan oleh tujuan

Kunci aliran dalam GetClientConfiguration permintaan diperlukan agar layanan dapat mengidentifikasi saluran dan menentukan apakah ada batasan per saluran. Misalnya, Amazon IVS menyediakan multitrackInputConfiguration.maximumResolution properti untuk STANDARD saluran. Ini dapat digunakan untuk membatasi resolusi trek individu mana pun, sehingga pelanggan dapat menyediakan kualitas khusus (misalnya, streaming 720p60 atau 1080p60) kepada pembuat konten tertentu atau mengontrol biaya keluaran mereka.

Menangani Peringatan dan Kesalahan

GetClientConfiguration mengembalikan peringatan dan kesalahan dalam keadaan yang berbeda, jadi Anda harus menerapkan dukungan yang menghadap pengguna untuk menangani peringatan dan kesalahan.

Peringatan bersifat informatif. Pengguna harus diizinkan untuk melanjutkan streaming atau membatalkan. Berikut adalah contoh peringatan:

Kes alahan dianggap fatal. Pengguna tidak boleh diizinkan untuk melanjutkan streaming. Berikut adalah contoh kesalahan:

Konfigurasikan Penskalaan dan Pengkodean Video

GetClientConfigurationmengembalikan pengaturan penskalaan dan pengkodean yang mengoptimalkan untuk pengalaman penampil terbaik, tanpa mempengaruhi kinerja aplikasi (misalnya, game/broadcast perangkat lunak) dan mempertimbangkan pengaturan pengguna. Gunakan pengaturan penskalaan dan pengkodean yang tepat yang dikembalikan oleh GetClientConfiguration. GetClientConfiguration memperhitungkan kebutuhan spesifik vendor yang berbeda dan arsitektur GPU yang berubah dari waktu ke waktu.

Selain pengaturan penskalaan dan pengkodean (seperti preset), Anda harus:

Hubungkan Menggunakan RTMP yang Ditingkatkan

Untuk dokumentasi tentang streaming multitrack melalui RTMP yang disempurnakan, lihat spesifikasi Enh anced RTMP v2.

Saat menghubungkan dengan RTMP yang ditingkatkan, video multitrack Amazon IVS memiliki beberapa persyaratan:

Berikut ini adalah contoh konfigurasi aliran:

Perangkat lunak siaran Anda harus menggunakan data yang dikembalikan oleh GetClientConfiguration in ingest_endpoints dan protokol (RTMP atau RTMPS) yang dipilih oleh pengguna untuk mengidentifikasi titik akhir untuk terhubung. Gunakan url_template dan kunci aliran yang dikembalikan authentication untuk membuat URL dan sertakan config_id sebagai argumen clientConfigId kueri. Jika Anda mengizinkan pengguna untuk menentukan argumen kueri RTMP (misalnya,?bandwidthtest=1), Anda harus menambahkannya selain menentukan. clientConfigId Berikut adalah contoh tanggapan dari GetClientConfiguration:

{
   "ingest_endpoints": [
      {
         "protocol": "RTMP",
         "url_template": "rtmp://iad05.contribute.live-video.net/app/{stream_key}",
         "authentication": "v1_5f2e593731dad88b6bdb03a3517d306ef88a73e29619ee4b49012d557e881484_65c5dc81_7b2276223a302c2262223a393939392c2274223a5b7b2277223a3634302c2268223a3336302c2262223a3530302c226330223a312c226331223a302c226332223a307d2c7b2277223a313238302c2268223a3732302c2262223a313730302c226330223a312c226331223a302c226332223a307d2c7b2277223a313932302c2268223a313038302c2262223a363030302c226330223a312c226331223a302c226332223a307d5d7d_live_495665160_FC45sNuCYUwLnCVtCnXSjEWkusXzJI"
      },
      {
         "protocol": "RTMPS",
         "url_template": "rtmps://iad05.contribute.live-video.net/app/{stream_key}",
         "authentication": "v1_5f2e593731dad88b6bdb03a3517d306ef88a73e29619ee4b49012d557e881484_65c5dc81_7b2276223a302c2262223a393939392c2274223a5b7b2277223a3634302c2268223a3336302c2262223a3530302c226330223a312c226331223a302c226332223a307d2c7b2277223a313238302c2268223a3732302c2262223a313730302c226330223a312c226331223a302c226332223a307d2c7b2277223a313932302c2268223a313038302c2262223a363030302c226330223a312c226331223a302c226332223a307d5d7d_live_495665160_FC45sNuCYUwLnCVtCnXSjEWkusXzJI"
      }
   ],
   "meta": {
      "config_id": "d34c2f7e-ce3a-4be4-a6a0-f51960abbc4f",
      …
   }
   …
}

Kemudian, jika pengguna memilih RTMP, Anda akan membuka koneksi ke:

rtmp://iad05.contribute.live-video.net/app/v1_5f2e593731dad88b6bdb03a3517d306ef88a73e29619ee4b49012d557e881484_65c5dc81_7b2276223a302c2262223a393939392c2274223a5b7b2277223a3634302c2268223a3336302c2262223a3530302c226330223a312c226331223a302c226332223a307d2c7b2277223a313238302c2268223a3732302c2262223a313730302c226330223a312c226331223a302c226332223a307d2c7b2277223a313932302c2268223a313038302c2262223a363030302c226330223a312c226331223a302c226332223a307d5d7d_live_495665160_FC45sNuCYUwLnCVtCnXSjEWkusXzJI?clientConfigId=d34c2f7e-ce3a-4be4-a6a0-f51960abbc4f

Menangani Pemutusan Video

Sistem video multitrack memberlakukan beberapa batasan. Secara umum, batasannya ada karena tiga alasan:

Sistem video memutuskan koneksi klien dalam beberapa skenario:

Pemutusan dapat terjadi pada awal streaming (yaitu, saluran tidak pernah ditayangkan) atau mid-stream (yaitu, saluran langsung, ketidakcocokan terdeteksi, dan kemudian klien terputus).

Menghubungkan Kembali Secara Otomatis

Validitas kunci aliran yang dikembalikan GetClientConfiguration adalah 48 jam atau hingga kunci aliran dibatalkan dengan panggilan DeleteStreamKey. Durasi maksimum streaming IVS adalah 48 jam; setelah itu, streaming dihentikan dan sesi streaming terputus. Sambungan kembali yang berhasil (secara otomatis atau manual) memulai aliran baru.

Perangkat lunak siaran Anda dapat menerapkan koneksi ulang otomatis. Jika Anda mendukung koneksi ulang otomatis, Anda harus mengizinkan pengguna untuk enable/disable itu dan ikuti panduan ini:

Menghentikan Streaming dan Memutuskan Sambungan

Ketika pengguna berhenti streaming, dan jika koneksi TCP masih terbuka (misalnya, koneksi tingkat bawah tidak diatur ulang), Anda harus mengirim FCUNPublish (contoh implementasi di OBS Studio) sebelum menutup koneksi RTMP. Ini sangat penting untuk menandakan niat pengguna tentang akhir aliran, karena fitur hilir bergantung padanya untuk beroperasi dengan baik.

Fitur yang Diperlukan: Metrik Kinerja Siaran (BPM)

Untuk mengaktifkan peningkatan berkelanjutan dari konfigurasi aliran otomatis, untuk memberikan pengaturan aliran terbaik, metrik kinerja siaran (BPM) harus diukur dan dikirim.

Metrik dikumpulkan dan dikirim dalam band melalui pesan SEI (for AVC/HEVC). Dua kelas data dikumpulkan:

Menyisip SEI/OBU kan Pesan

Lihat Definisi Pesan BPM untuk definisi aliran byte pesan tertentu.

Metrik BPM harus dimasukkan pada semua trek video sebelum IDR. Tiga pesan (BPM TS, BPM SM, dan BPM ERM) harus dikirim bersama, tetapi masing-masing harus dikirim sebagai NUT () terpisah. AVC/HEVC

BPM SM dan BPM ERM yang dikirim di segmen pertama harus memiliki penghitung bingkai disetel ke 0. Ini mungkin tampak berlawanan dengan intuisi pada awalnya; namun, penghitung seperti jumlah frame yang dikodekan per rendisi tidak memiliki data yang berarti sampai setelah encoding selesai, dan hasilnya adalah penghitung bingkai di segmen N sejajar dengan segmen. N-1 Yang terbaik adalah memikirkan metrik BPM sebagai seri data berwaktu yang dikirimkan dalam bitstream video pada interval IDR. Jika perlu, penataan ulang seri data yang tepat harus dilakukan oleh penerima menggunakan stempel waktu yang disediakan.

Ilustrasi di bawah ini menggambarkan skenario khas untuk aliran multitrack tiga rendisi. Dengan ukuran segmen tipikal dua detik, metrik akan dikirim setiap dua detik untuk setiap rendisi.

Fitur yang Direkomendasikan

Izinkan Pemilihan Server Otomatis

Pemilihan server otomatis membantu pengguna memilih server ingest terbaik untuk dihubungkan untuk streaming langsung mereka, mengingat perubahan kondisi jaringan global dan menyerap ketersediaan PoP (Point of Presence).

Jika perangkat lunak siaran Anda mendukung pemilihan server otomatis, kami mengharapkan perilaku yang berbeda tergantung pada apakah perangkat lunak diimplementasikan GetClientConfiguration and/or FindIngest. Setiap skenario tercantum secara terpisah di bawah ini.

Jika perangkat lunak siaran mengimplementasikan keduanya GetClientConfiguration dan FindIngest:

Jika perangkat lunak siaran mengimplementasikan GetClientConfiguration tetapi tidak mengimplementasikan FindIngest:

Jika perangkat lunak siaran tidak mengimplementasikan GetClientConfiguration tetapi mengimplementasikan FindIngest:

Jika perangkat lunak siaran tidak mengimplementasikan GetClientConfiguration atau FindIngest:

Lihat Menggunakan FindIngest Server untuk Tujuan Streaming Otomatis untuk informasi selengkapnya tentang menggunakan titik akhir ingest yang ditentukan oleh. FindIngest

Izinkan Pengguna Mengkonfigurasi Tujuan Streaming

Saat pengguna mengonfigurasi tujuan streaming mereka, Anda harus menanyakan FindIngest dan memberi pengguna kemampuan untuk:

Anda dapat memfilter daftar yang dikembalikan FindIngest berdasarkan protokol yang dipilih oleh pengguna (RTMP vs RTMPS) atau pertimbangan lainnya.

Misalnya, implementasi Amazon IVS di OBS Studio mencapai ini dengan menyediakan drop-down Server sederhana dengan opsi berikut:

Ketika Tentukan Server Kustom dipilih, kotak teks disediakan bagi pengguna untuk memasukkan URL RTMP.

Menggunakan FindIngest Server untuk Tujuan Streaming Otomatis

Jika Anda menggunakan titik akhir ingest yang ditentukan oleh FindIngest saat Auto ditentukan untuk tujuan streaming, gunakan entri dengan priority nilai terendah yang dikembalikan oleh. FindIngest Untuk mengurangi waktu yang dibutuhkan streaming untuk ditayangkan, Anda dapat menyimpan FindIngest respons dalam cache. Jika Anda melakukan cache respons, perbarui nilai cache secara teratur.

Jika pengguna memilih RTMP, gunakan url_template string sebagai tujuan siaran RTMP. Jika pengguna memilih RTMPS, gunakan url_template_secure string sebagai tujuan siaran RTMPS. Dalam kedua kasus, ganti {stream_key} dengan kunci aliran pengguna.

Definisi Pesan Metrik Kinerja Siaran (BPM)

Pesan BPM didasarkan pada sintaks SEI H.264 standar. Untuk referensi, sintaks SEI data pengguna yang tidak terdaftar dari H.264 spesifikasi adalah:

Untuk pesan BPM, semua aturan parsing dan notasi dari H.264 standar berlaku, misalnya, “u (128)” berarti bilangan bulat 128-bit yang tidak ditandatangani, MSB terlebih dahulu.

Tiga pesan SEI didefinisikan untuk BPM:

Semua pesan BPM SEI mengirim UUID 128-bit yang diperlukan oleh user_data_unregistered() sintaks, diikuti oleh loop byte muatan. Pesan yang dihasilkan kemudian dienkapsulasi dalam semantik tingkat yang lebih tinggi (misalnya, NALU, RBSP, dan pencegahan emulasi kode awal).

BPM TS (Stempel Waktu) SEI

Pesan BPM TS SEI menyampaikan satu atau lebih stempel waktu terkait. Misalnya, klien dapat memberi sinyal stempel waktu untuk komposisi bingkai, permintaan enkode bingkai, permintaan enkode bingkai selesai, dan paket disisipkan dalam satu pesan SEI, dan klien dapat memutuskan apakah masing-masing stempel waktu ini harus dikirim sebagai jam dinding () atau delta (perbedaanRFC3339/ISO8601-style) jam atau durasi-sejak zaman. Harus ada satu stempel waktu yang menyediakan referensi untuk tipe delta; ini harus ditangani oleh penerapan, bukan oleh kendala sintaksis apa pun.

Tabel Deskripsi Bidang BPM TS SEI

Tabel timestamp_type

timestamp_typemenentukan jenis seperti:

Catatan tentang detik kab isat: Penting untuk dicatat bahwa kesepakatan dibuat untuk menghapus penggunaan detik kabisat pada tahun 2035. Lihat entri Wikipedia pada detik kabisat untuk detailnya. Sebaiknya gunakan stempel waktu yang mengecualikan detik kabisat. Ini sejalan dengan praktik yang diharapkan pada tahun 2035 dan menghindari kemungkinan kesalahan perhitungan dalam waktu.

BPM SM (Metrik Sesi) SEI

Pesan BPM SM SEI menyampaikan kumpulan metrik yang berhubungan dengan sesi pengirim keseluruhan. Di OBS Studio, ini berarti mengirim penghitung bingkai berikut:

Pesan SEI ini juga menyertakan stempel waktu. Ini berlebihan dengan BPM TS SEI; Namun, memberikan stempel waktu eksplisit di setiap pesan SEI menyediakan unit perilaku atom dan mengurangi beban pada penerima untuk menyelaraskan kembali data. Juga, jika muncul kebutuhan untuk menghentikan atau tidak mengirim BPM TS SEI, masih akan ada stempel waktu eksplisit dalam pesan BPM SM SEI untuk digunakan.

Tabel Deskripsi Bidang BPM SM SEI

Banyak bidang dalam pesan SEI ini mirip dengan bidang BPM TS SEI. Perbedaan yang signifikan adalah nilai UUID, jumlah stempel waktu yang diharapkan, dan penghitung yang ditransmisikan.

Contoh BPM SM

Berikut adalah contoh BPM SM SEI yang dikirim ke Amazon IVS:

BPM ERM (Metrik Rendisi Terkodekan) SEI

Pesan BPM ERM SEI menyampaikan kumpulan metrik yang berhubungan dengan setiap rendisi yang dikodekan. Di OBS Studio, ini berarti mengirim penghitung bingkai berikut:

Pesan SEI ini juga menyertakan stempel waktu. Ini berlebihan dengan BPM TS SEI; Namun, memberikan stempel waktu eksplisit di setiap pesan SEI menyediakan unit perilaku atom dan mengurangi beban pada penerima untuk menyelaraskan kembali data. Juga, jika muncul kebutuhan untuk menghentikan atau tidak mengirim BPM TS SEI, masih akan ada stempel waktu eksplisit dalam pesan BPM ERM SEI untuk digunakan.

Tabel Deskripsi Bidang BPM ERM SEI

Banyak bidang dalam pesan SEI ini mirip dengan bidang BPM TS SEI dan bidang BPM SM SEI. Perbedaan yang signifikan adalah nilai UUID, jumlah stempel waktu yang diharapkan, dan penghitung yang ditransmisikan.

Contoh BPM ERM

Berikut adalah contoh BPM ERM SEI yang dikirim ke Amazon IVS: