Petunjuk pengemasan langsung - Intelligent Media Services

Topik ini menjelaskan fitur live packaging.

Overview

Live packaging memungkinkan Anda mengemas aliran langsung (live stream) untuk berbagai protokol pemutaran dan mendukung time shifting. Fitur time shifting memungkinkan penonton menonton konten siaran langsung secara on demand selama siaran berlangsung. Misalnya, selama acara olahraga langsung, penonton dapat menggunakan time shifting untuk memutar ulang bagian-bagian tertentu seperti aset video-on-demand (VOD). Anda juga dapat menyimpan konten langsung ke Object Storage Service (OSS).

Penting

Penggunaan fitur live packaging dikenai biaya. Untuk informasi lebih lanjut tentang penagihan, lihat Penagihan live packaging.

Konfigurasikan fitur

Untuk menggunakan live packaging, Anda harus membuat konfigurasi pengemasan.

Masuk ke Konsol Intelligent Media Services.
Pada panel navigasi di sebelah kiri, pilih Media Packaging > Live Packaging, lalu buat kelompok saluran (channel group).
Deskripsi parameter:
Parameter
Deskripsi
Channel Group Name
Input kustom
Description
Menerima input kustom.
Catatan
- Informasi saluran dalam fitur ini tidak terkait dengan fitur Channel Assembly.
- Setelah konfigurasi selesai, Origin Domain Name akan ditetapkan secara otomatis.

Klik nama kelompok saluran untuk membuka halaman daftar saluran, lalu buat saluran (channel).

Deskripsi parameter:

Nama Parameter	Deskripsi
Channel Name	Input kustom
Input Protocol	Protokol aliran sumber. HLS dan HLS_CMAF didukung.
Segment length	Durasi satu segmen dalam aliran yang dikemas. Atur nilai ini ke 6. Jangan atur terlalu tinggi atau terlalu rendah. Nilai yang lebih tinggi meningkatkan konten dalam satu segmen dan menambah latensi. Nilai yang lebih rendah mengurangi konten dalam satu segmen tetapi meningkatkan jumlah permintaan, sehingga menambah beban sumber daya.
Number of segments	Jumlah segmen yang disertakan dalam file M3U8 yang dikembalikan saat aliran yang dikemas diputar. Atur nilai ini ke 3. Angka yang lebih besar memperpanjang timeline siaran langsung pada pemutar, tetapi juga meningkatkan trafik permintaan M3U8 dan latensi.

Klik nama saluran untuk membuka halaman detail saluran. Kemudian, klik tab Endpoints dan buat titik akhir (endpoint).

Deskripsi parameter:

Parameter	Deskripsi
Endpoint Name	Anda dapat menyesuaikan nama endpoint.
Protocol	Protokol pemutaran setelah pengemasan. HLS, HLS_CMAF, dan DASH didukung.
Playlist Name	Nama file manifest. Misalnya, jika Anda memasukkan index, URL streaming-nya adalah https://example.aliyundoc.com/index.m3u8.
Authorization code	Jika Anda mengatur parameter ini, permintaan dari pemutar atau CDN untuk origin fetch harus menyertakan header permintaan. Atur nama parameter ke Authorization dan nilai parameter ke kode otorisasi. Untuk informasi lebih lanjut tentang cara mengatur header permintaan origin untuk Alibaba Cloud CDN, lihat Ubah header permintaan keluar.
IP whitelist	Alamat IPv4 dan IPv6 serta subnet mask didukung.
IP blacklist	Alamat IPv4 dan IPv6 serta subnet mask didukung.
Time shift period	Jika Anda mengatur parameter ini ke nilai lebih besar dari 0, time shifting diaktifkan. Time shifting memungkinkan penonton menonton konten langsung secara on demand selama siaran langsung berlangsung. Misalnya, selama acara olahraga langsung, penonton dapat menggunakan time shifting untuk memutar ulang dan menonton bagian-bagian acara tersebut seperti aset VOD. Untuk informasi lebih lanjut, lihat Pemutaran time-shifted. Anda hanya dapat menggunakan fitur Live to VOD (tugas koleksi) untuk node ini jika time shifting diaktifkan. Fitur ini menyimpan konten time-shifted di OSS. Jika time shifting tidak diaktifkan, Anda tidak dapat menggunakan fitur Live to VOD untuk node ini.
Segment length	Durasi satu segmen dalam aliran yang dikemas.
Audio separation	Menentukan apakah aliran video dan audio dipisahkan.
Number of segments	Jumlah segmen dalam aliran yang dikemas.
Insert timestamp interval	Interval penyisipan timestamp (tag EXT-X-PROGRAM-DATE-TIME) ke dalam file M3U8.
Stream sorting	Opsional. Original order: Mengurutkan aliran output sesuai urutan aliran sumber. Video bitrate ascending: Mengurutkan aliran output dari bitrate terendah ke tertinggi. Video bitrate descending: Mengurutkan aliran output dari bitrate tertinggi ke terendah.
Minimum video bitrate	Ambang batas bitrate minimum dalam bit/s. Track video harus memiliki bitrate lebih besar dari atau sama dengan nilai ini agar dapat diputar dari endpoint ini. Hal ini memastikan track memenuhi bitrate minimum.
Maximum video bitrate	Ambang batas bitrate maksimum dalam bit/s. Track video harus memiliki bitrate kurang dari atau sama dengan nilai ini agar dapat diputar dari endpoint ini. Hal ini memastikan track tidak melebihi bitrate tertentu.

Setelah endpoint dibuat, URL streaming untuk aliran yang dikemas akan dihasilkan. Ini menyelesaikan konfigurasi live packaging.

Gunakan fitur

Stream ingest

Setelah membuat saluran, sistem menghasilkan URL ingest dan kunci, yang dapat dilihat di tab Input pada halaman detail saluran.

ingest1: URL ingest primary.

ingest2: URL ingest backup.

Klik Authentication untuk mendapatkan username dan password.

Saluran pengemasan real-time menyediakan URL ingest primary dan backup untuk menerima aliran output HLS dari layanan transkoding hulu. Jika salah satu endpoint ingest tidak tersedia, layanan pengemasan akan menggunakan endpoint lain sebagai input. Desain ini meningkatkan ketersediaan saluran. Contoh URL:

http://xxxxxx-1.packagepush-9eji12.ap-southeast-1.ice.aliyundoc.com/v1/dfjtest/1/test01/manifest

Konfigurasikan tool transkoding hulu untuk output ke alamat tersebut. Gunakan metode PUT dengan Basic Authentication untuk mengunggah file M3U8 dan TS. URL permintaan untuk file-file ini harus diawali dengan URL ingest. Contohnya:

http://xxxxx-1.packagepush-9eji12.ap-southeast-1.ice.aliyundoc.com/v1/dfjtest/1/test01/manifest.m3u8
http://xthcfa-1.packagepush-9ejigb.ap-southeast-1.ice.aliyundoc.com/v1/dfjtest/1/test01/manifest-hd-1001.ts

Catatan:

Untuk Basic Auth, tambahkan header Authorization:Basic BASE64_ENCODE(username:password) ke permintaan.
Unggah file master M3U8, child M3U8, dan segmen TS yang valid. Konten HLS terenkripsi tidak didukung sebagai input.
Jika Anda mendorong aliran HLS ke URL ingest primary dan backup, pastikan aliran tersebut memiliki konten yang sama dan timestamp segmennya selaras. Jika tidak, pemutaran lancar tidak dapat dijamin selama switchover.

Anda juga dapat menggunakan fitur MediaLive untuk ingest stream.

Playback

Gunakan URL streaming yang dihasilkan oleh endpoint untuk pemutaran.

Untuk pengujian, Anda dapat menambahkan alamat IP internal ke daftar putih (IP whitelist) endpoint. Anda juga dapat mengatur header permintaan di pemutar dengan menetapkan nama parameter ke Authorization dan nilai parameter ke kode otorisasi yang dikonfigurasi untuk endpoint tersebut.

Untuk menyediakan pemutaran kepada pengguna eksternal, gunakan CDN untuk akselerasi origin-fetch. Saat mengonfigurasi CDN, atur header permintaan dengan nama parameter Authorization dan nilai parameter sesuai kode otorisasi yang dikonfigurasi untuk endpoint tersebut. Untuk informasi lebih lanjut, hubungi penyedia CDN Anda.

Pemutaran time-shifted

Saat time shifting diaktifkan, layanan pengemasan menyimpan file segmen langsung, sehingga memungkinkan penonton mengirim permintaan pemutaran time-shifted untuk menonton konten yang telah disiarkan sebelumnya.

Contoh permintaan pemutaran time-shifted:

https://xxxxx-1.packagepush-9eji12.ap-southeast-1.ice.aliyundoc.com/v1/group01/ch01/endpoint01/index.m3u8?start=2024-11-06T00:00:00Z&vodend=2024-11-06T02:00:00Z

Dalam contoh ini, konten langsung dari 2024-11-06T00:00:00Z hingga 2024-11-06T02:00:00Z diputar ulang. URL permintaan time-shift mencakup parameter tambahan dibandingkan URL pemutaran m3u8 standar. Parameter start menentukan waktu mulai pemutaran time-shifted, sedangkan parameter vodend menentukan waktu berakhir. Basis URL permintaan adalah URL pemutaran endpoint.

Parameter berikut didukung untuk pemutaran time-shifted:

Nama Parameter	Deskripsi
start	Waktu mulai untuk pemutaran time-shifted, dalam format UTC (GMT). Contoh: 2024-11-06T00:00:00Z
end	Waktu berakhir untuk pemutaran time-shifted, dalam format UTC (GMT). Contoh: 2024-11-06T02:00:00Z
vodend	Menentukan waktu berakhir untuk pemutaran time-shifted dalam mode VOD, dalam format UTC (GMT). Contoh: 2024-11-06T02:00:00Z Catatan Mengatur vodend berarti menggunakan mode VOD untuk pemutaran. Mode VOD mengembalikan semua segmen sekaligus. Anda dapat menggunakan bilah progres pemutar untuk maju cepat dan putar ulang.
offset	Memutar konten time-shifted berdasarkan offset waktu, dalam seconds. Permintaan dengan offset menggeser titik pemutaran mundur dari waktu saat ini. Contoh pemutaran: `https://xxxxx-1.packagepush-9eji12.ap-southeast-1.ice.aliyundoc.com/v1/group01/ch01/endpoint01/index.m3u8?offset=300`

Catatan penggunaan:

Anda harus menentukan salah satu dari start atau offset.
Jika Anda menentukan end, pemutaran dimulai pada waktu yang diminta dan berlanjut sebagai aliran langsung hingga mencapai waktu end yang ditentukan.
Jika Anda menentukan vodend, aliran dikirimkan sebagai aset VOD yang berakhir pada waktu vodend yang ditentukan. Manifes berisi semua segmen dalam rentang waktu tersebut, sehingga memungkinkan penonton menggunakan bilah progres pemutar untuk mencari, maju cepat, atau putar ulang.
Jika Anda menentukan kedua parameter end dan vodend, parameter vodend memiliki prioritas lebih tinggi.

Buat tugas koleksi

Anda dapat membuat tugas koleksi untuk menyimpan konten langsung di OSS. Setelah siaran langsung berakhir, konten tersebut dapat diputar ulang dari OSS.

Prasyarat:

Anda harus mengaktifkan layanan OSS dan memiliki setidaknya satu bucket untuk menyimpan file tersebut. Untuk informasi lebih lanjut, lihat Aktifkan OSS dan Buat bucket. Bucket harus berada di wilayah yang sama dengan kelompok saluran.
Penting
Penyimpanan file di OSS dikenai biaya penyimpanan. Untuk informasi lebih lanjut tentang penagihan OSS, lihat Biaya Penyimpanan OSS.
Fitur time shifting harus diaktifkan untuk endpoint saluran, yaitu jendela startover diatur ke nilai lebih besar dari 0.

Pada channel details page, klik tab Collection Task, lalu buat tugas koleksi.

Deskripsi parameter:

Nama Parameter	Deskripsi
Endpoint	Pilih endpoint dalam saluran. Fitur time shifting harus diaktifkan untuk endpoint tersebut (jendela startover diatur ke nilai lebih besar dari 0).
Collection Time	Jika time shifting diaktifkan selama periode ini, konten langsung akan disimpan di OSS.
Storage Path	Pilih bucket OSS. Hasil koleksi (file M3U8) disimpan di lokasi yang sesuai.

Catatan

Setelah tugas koleksi dibuat, tugas tersebut akan dimulai secara otomatis. Anda dapat melihat file yang dikumpulkan di bucket OSS Anda.
Jika Anda membuat beberapa tugas koleksi untuk satu endpoint, setiap tugas menghasilkan file terpisah.

FAQ

How do I ingest streams for live packaging?

Anda dapat menggunakan tool transkoding langsung pihak ketiga yang mendukung output HLS untuk mengingest stream. Layanan live packaging menerima output HLS dari layanan transkoding hulu. Anda juga dapat menggunakan fitur MediaLive untuk mengingest stream.

How do I play a packaged stream?

Gunakan URL streaming yang dihasilkan oleh endpoint untuk pemutaran.

No files are collected after a collection task is created

Hal ini dapat terjadi jika fitur time shifting tidak diaktifkan untuk endpoint saluran. Pastikan jendela startover diatur ke nilai lebih besar dari 0.

What is the difference between creating a collection task for Live to VOD and for live packaging?

Kedua metode dapat digunakan untuk fitur Live to VOD. Perbedaannya terletak pada tempat tugas-tugas tersebut ditampilkan di Konsol. Halaman utama Live to VOD menampilkan semua tugas koleksi, sedangkan tab Collection Task dalam konfigurasi live packaging hanya menampilkan tugas untuk konfigurasi tersebut.

Parameter	Deskripsi
Channel Group Name	Input kustom
Description	Menerima input kustom.