Ketika seorang pengguna mencari posisi tertentu dalam file video atau audio sesuai permintaan setelah Anda mengaktifkan pencarian video, klien mengirimkan permintaan yang berisi URL file video atau audio ke server. -

Dalam skenario streaming audio dan video sesuai permintaan, fitur pemrosesan video ESA mengidentifikasi keyframe terdekat sebelum posisi pemutaran untuk memuat klip video yang ingin dimainkan oleh pengguna, memberikan pengalaman pemutaran tanpa gangguan.

Sebelum Anda mulai

Server asal harus mendukung permintaan HTTP Range.
String query harus diatur ke Retain All.

Tambahkan aturan pemrosesan video

Di konsol ESA, pilih Situs Web dan klik nama situs web yang ingin Anda kelola.
Di panel navigasi sisi kiri, pilih Rules > Content Optimization Rules.
Klik tab Video Processing . Klik Create Rule, lalu isi Rule Name.
Di area If Requests Match..., tentukan kondisi untuk mencocokkan permintaan masuk. Untuk informasi lebih lanjut tentang cara mengonfigurasi aturan, lihat Aturan.
Di bagian Video Seeking, klik Configure, nyalakan sakelar Status, dan konfigurasikan parameter.
Berikut adalah format file yang didukung untuk pencarian video beserta contoh URL:
File MP4
- Metadata: Metadata file video di server asal harus disertakan di header file alih-alih di akhir file.
- Parameter: Parameter start menentukan waktu dalam detik dan nilainya dapat dibulatkan hingga tiga tempat desimal. Sebagai contoh, start=1.01 menunjukkan bahwa video diputar dari detik ke-1.01.
  - Jika posisi yang ditentukan oleh parameter start bukan keyframe, ESA secara otomatis menemukan keyframe terakhir sebelum posisi tersebut.
  - Jika posisi yang ditentukan oleh parameter start bukan keyframe, ESA secara otomatis menemukan keyframe.
- Parameter MP4 Kustom:
  - Nilai default parameter start adalah start, dan nilai default parameter end adalah end.
  - Nilai parameter kustom hanya boleh berisi huruf, angka, dan garis bawah (_).
- Contoh:
  domain/video.mp4?start=10: menunjukkan bahwa video diputar dari detik ke-10.
File FLV
- Metadata: File video di server asal harus berisi metadata.
- Parameter: Parameter start menentukan posisi. Parameter start hanya mendukung nilai dalam byte. Desimal tidak didukung, dan nilai dibulatkan ke bawah menjadi bilangan bulat positif terdekat.
  - FLV Seeking
    - Seek by Time: Unit parameter start dan end adalah detik. Metode ini membawa Anda ke gambar video pada titik waktu yang ditentukan, memberikan pengalaman yang ramah pengguna.
    - Seek by Byte: Metode ini cocok untuk pemrosesan data presisi atau data video mentah.
      - Jika posisi yang ditentukan oleh parameter start bukan keyframe, ESA secara otomatis menemukan keyframe terakhir sebelum posisi tersebut.
      - Jika posisi yang ditentukan oleh parameter start bukan keyframe, ESA secara otomatis menemukan keyframe.
- Parameter Pencarian Video Kustom:
  - Nilai default parameter start adalah start, dan nilai default parameter end adalah end.
  - Nilai parameter kustom hanya boleh berisi huruf, angka, dan garis bawah (_).
- Contoh:
  domain/video.flv?start=10: menunjukkan bahwa video diputar dari byte ke-10.

Logika pemrosesan parameter pencarian video

Pencarian berdasarkan waktu digunakan sebagai contoh. Nilai default start dan end digunakan. Tabel berikut menjelaskan logika pemrosesan nilai parameter dalam berbagai skenario:

Permintaan untuk file MP4

nilai start/end	Contoh	Logika pemrosesan
Nilai tidak valid dari parameter `start` dan `end`	`start=foo&end=bar`	Mengabaikan parameter pencarian video dan merespons dengan video lengkap.
Nilai valid dari parameter `start` dan nilai tidak valid dari parameter `end`	`start=10`	Memproses pencarian video dari `10` hingga akhir file.
Nilai tidak valid dari parameter `start` dan nilai valid dari parameter `end`	`end=10`	Memproses pencarian video dari `0-10`.
Nilai valid dari parameter `start` dan `end`	`start=0&end=10`	Memproses pencarian video dari `0-10`.
Kedua parameter `start` dan `end` diatur ke `0`	`start=0&end=0`	Mengabaikan parameter pencarian video dan merespons dengan video lengkap.
Nilai parameter `start` lebih besar dari nilai parameter `end`	`start=10&end=0`	Memproses pencarian video dari `10` hingga akhir file.
Nilai parameter `start` sama dengan nilai parameter `end`	`start=10&end=10`	Memproses pencarian video dari `10` hingga akhir file.
Nilai parameter `start` lebih besar dari durasi video	Nilai parameter `start` lebih besar dari durasi video	Mengembalikan respons dengan kode status HTTP `400`.

Permintaan untuk file FLV

nilai start/end	Contoh	Logika pemrosesan
Nilai tidak valid dari parameter `start` dan `end`	`start=foo&end=bar`	Mengabaikan parameter pencarian video dan merespons dengan video lengkap.
Nilai valid dari parameter `start` dan nilai tidak valid dari parameter `end`	`start=10`	Memproses pencarian video dari `10` hingga akhir file.
Nilai tidak valid dari parameter `start` dan nilai valid dari parameter `end`	`end=10`	Memproses pencarian video dari `0-10`.
Nilai valid dari parameter `start` dan `end`	`start=0&end=10`	Memproses pencarian video dari `0-10`.
Kedua parameter `start` dan `end` diatur ke `0`	`start=0&end=0`	Mengabaikan parameter pencarian video dan merespons dengan video lengkap.
Nilai parameter `start` lebih besar dari nilai parameter `end`	`start=10&end=0`	Memproses pencarian video dari `10` hingga akhir file.
Nilai parameter `start` sama dengan nilai parameter `end`	`start=10&end=10`	Memproses pencarian video dari `10` hingga akhir file.
Nilai parameter `start` lebih besar dari durasi video	Nilai parameter `start` lebih besar dari durasi video	Mengembalikan video lengkap.