Halaman ini berisi ringkasan praktik terbaik untuk Video Stitcher API. Jika Anda baru mulai menggunakan Video Stitcher API, lihat panduan memulai untuk live stream atau panduan memulai untuk aset VOD.
Mengondisikan aset VOD
Konfigurasikan encoder dan transcoder sumber untuk menghasilkan manifes yang mendukung jeda iklan antara periode DASH dan segmen HLS. Video Stitcher API tidak akan membagi periode atau segmen untuk menggabungkan jeda iklan, sehingga jeda iklan hanya digabungkan pada batas periode dan segmen.
Untuk tag iklan yang menampilkan respons VMAP, setiap jeda iklan yang ditentukan dalam VMAP harus cocok dengan batas periode atau segmen. Jika tidak, jeda iklan akan digabungkan di batas terdekat.
Menghindari ketidakcocokan jeda iklan untuk HLS
Untuk penyambungan VOD, Anda harus melakukan prakondisi manifes video sumber untuk jeda iklan midroll dan mengonfigurasi tag iklan Playlist Multi-Iklan Video (VMAP) untuk menampilkan jeda iklan midroll di posisi offset yang telah dikondisikan sebelumnya. Video Stitcher API mengambil hasil output yang ditranscoding dan menyisipkan iklan sedekat mungkin dengan tempat yang Anda tentukan. Gunakan input yang telah dikondisikan sebelumnya untuk jeda iklan midroll agar perilaku penyambungan iklan konsisten dan akurat.
Misalnya, playlist video berikut menampilkan peluang penempatan iklan pada tanda tujuh detik:
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-TARGETDURATION:4
#EXTINF:2.0
../video/180_250000/hls/segment_0.ts
#EXTINF:2.0
../video/180_250000/hls/segment_1.ts
#EXTINF:2.0
../video/180_250000/hls/segment_2.ts
#EXTINF:1.0
../video/180_250000/hls/segment_3.ts
#EXT-X-PLACEMENT-OPPORTUNITY
#EXTINF:2.0
../video/180_250000/hls/segment_4.ts
Playlist audio berikut menunjukkan peluang penempatan iklan pada tanda tujuh detik:
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-TARGETDURATION:4
#EXTINF:1.99
../audio/1_stereo_128000/hls/segment_0.ts
#EXTINF:1.99
../audio/1_stereo_128000/hls/segment_1.ts
#EXTINF:1.99
../audio/1_stereo_128000/hls/segment_2.ts
#EXTINF:1.03
../audio/1_stereo_128000/hls/segment_3.ts
#EXT-X-PLACEMENT-OPPORTUNITY
#EXTINF:1.99
../audio/1_stereo_128000/hls/segment_4.ts
Konfigurasi VMAP berikut menentukan jeda iklan yang akan terjadi pada tanda tujuh detik. Playlist video dan audio akan berisi jeda iklan tepat pada tanda tujuh detik:
<vmap:VMAP xmlns:vmap="http://www.iab.net/videosuite/vmap" version="1.0">
<vmap:AdBreak timeOffset="00:00:07.000" breakType="linear" breakId="midroll‑1">
<vmap:AdSource id="midroll-1‑ad‑1" allowMultipleAds="false" followRedirects="true">
<vmap:AdTagURI templateType="vast3">
<![CDATA[
https://securepubads.g.doubleclick.net/gampad/ads?...
]]>
</vmap:AdTagURI>
</vmap:AdSource>
</vmap:AdBreak>
</vmap:VMAP>
Menetapkan EXT-X-PROGRAM-DATE-TIME untuk HLS
Untuk memastikan pengaturan waktu segmen disinkronkan di seluruh render HLS, sebaiknya
tetapkan EXT-X-PROGRAM-DATE-TIME untuk setiap render HLS.
Hal ini membantu pemain melakukan transisi dengan lancar saat mengubah render selama
pemutaran.
Menggunakan manifes DASH multi-periode untuk aset live dan VOD
Konfigurasikan encoder dan transcoder sumber untuk menghasilkan manifes DASH dengan beberapa periode, bukan satu periode. Karena alasan yang mirip dengan kondisional VOD, Video Stitcher API tidak akan membagi periode untuk menggabungkan jeda iklan, sehingga manifes DASH dengan beberapa periode akan memiliki lebih banyak peluang untuk menggabungkan jeda iklan pada durasi yang diharapkan.
mengenkapsulasi subtitel dalam ISOBMFF
Subtitel untuk manifes DASH harus dienkapsulasi dalam format file media dasar ISO (ISOBMFF), seperti MP4, untuk kompatibilitas dengan sebagian besar pemutar media.
Menggunakan kecepatan bit konstan
Untuk memastikan pengalaman pemutaran yang stabil untuk live stream, konfigurasikan encoder atau transcoder sumber untuk menggunakan kecepatan bit konstan saat menghasilkan manifes streaming. Hal ini memungkinkan Video Stitcher API menggabungkan iklan secara lebih konsisten agar cocok dengan profil encoding yang ditentukan dalam manifes.
Menggunakan penanda iklan yang didukung
Lihat dokumentasi penanda iklan untuk memahami penanda iklan yang didukung dan cara encoder atau transcoder sumber harus menghasilkan penanda iklan untuk memastikan jeda iklan berhasil digabungkan.
Memverifikasi pemutaran sumber
Untuk memastikan pengalaman pemutaran yang stabil untuk streaming live dan VOD, sebaiknya gunakan pemutar klien yang tersedia secara luas untuk memverifikasi bahwa streaming sumber dapat diputar sebelum menggabungkan dengan Video Stitcher API.
HLS:
DASH:
Mengelola kunci CDN
Jika media sumber dilindungi oleh penandatanganan URL, Anda harus mendaftarkan kunci CDN dengan Video Stitcher API. Hal ini memungkinkan API untuk:
- Mengambil manifes video sumber untuk penyambungan
- Menandatangani segmen video sumber, sehingga pemutar dapat mengambil segmen video untuk diputar
Lihat informasi tentang cara mengelola kunci CDN.
Menyiapkan Media CDN
Jika Anda ingin menyiapkan Media CDN untuk mendistribusikan aset media, ikuti panduan memulai Media CDN.
Konfigurasikan rute terpisah dengan TTL yang sesuai untuk manifes dan segmen media Anda. Untuk mengetahui detail dan contohnya, lihat panduan Perutean Lanjutan Media CDN.
Jika ada rute yang menggunakan origin Cloud Storage pribadi, lihat Menggunakan bucket Cloud Storage pribadi.
Secara khusus, tetapkan mode cache untuk rute ini ke FORCE_CACHE_ALL.
Untuk mengetahui petunjuk cara menyiapkan HTTPS, lihat Mengonfigurasi sertifikat SSL (TLS).
Permintaan yang ditandatangani Media CDN
Untuk menggunakan Media CDN dengan permintaan yang ditandatangani diaktifkan, lihat Menggunakan permintaan yang ditandatangani, lalu lakukan hal berikut:
Buat pasangan kunci asimetris. Untuk informasi tentang cara membuat kunci pribadi yang kompatibel dengan Video Stitcher API, lihat Membuat kunci pribadi untuk Media CDN .
Daftarkan kunci Media CDN pribadi dengan Video Stitcher API.
Batas durasi untuk sesi live yang berjalan lama
Resource LiveSession tidak akan berakhir masa berlakunya kecuali jika 5 menit telah berlalu tanpa permintaan playlist. Namun, masa aktif maksimum 180 hari diterapkan untuk semua URI pemutaran. Untuk melanjutkan pemutaran setelah 180 hari berlalu, Anda harus membuat sesi live baru. Untuk keandalan, Anda harus membuat sesi live baru setidaknya setiap 30 hari.