All Products
Search

This Product

    ApsaraVideo VOD:Animasi frame

    Document Center

    ApsaraVideo VOD:Animasi frame

    Last Updated:Jul 11, 2026

    Animasi frame menangkap segmen video dan mengonversinya menjadi file gambar dinamis, yang umum digunakan untuk ringkasan video dan sampul di media sosial, pemberitaan berita, serta pemasaran. ApsaraVideo VOD mendukung pembuatan gambar dinamis dalam format GIF dan WebP.

    Pendahuluan

    Gambar dinamis menciptakan efek gerakan dengan menampilkan serangkaian gambar statis secara cepat. Format yang paling umum di web adalah GIF dan, dalam skala lebih kecil, WebP. Membuat animasi frame melibatkan ekstraksi segmen tertentu dari video dan menghasilkan file gambar dinamis.

    ApsaraVideo VOD mendukung format GIF dan WebP untuk animasi frame. Tabel berikut membandingkan kedua format tersebut.

    Format

    Fitur

    GIF

    Menawarkan kompatibilitas tinggi dan sering digunakan untuk dekorasi halaman web.

    WebP

    Ukuran file-nya jauh lebih kecil daripada GIF, tetapi tidak didukung oleh beberapa browser, termasuk Internet Explorer, iOS Safari 3.2 hingga 13.7, dan KaiOS Browser.

    Kasus penggunaan

    • Berbagi di media sosial: Buat GIF dari sorotan video untuk berbagi cepat, atau gunakan animasi frame sebagai ringkasan yang menarik perhatian guna mendorong pengguna menonton video lengkapnya.

    • Promosi pemasaran: Gunakan gambar dinamis dari sorotan video dalam iklan untuk memicu minat pengguna, meningkatkan rasio klik-tayang (click-through rate), dan meningkatkan konversi. Di situs e-commerce, gambar dinamis dapat menampilkan fitur produk atau mendemonstrasikan fungsionalitasnya.

    • Pemberitaan berita dan hiburan: Dalam pemberitaan berita, editor sering menangkap momen kunci dari peristiwa berita sebagai gambar dinamis untuk menyajikan informasi penting secara ringkas. Cuplikan film atau sorotan acara dapat dirilis sebagai gambar dinamis untuk penelusuran cepat.

    • Demonstrasi edukasi: Dalam kursus daring, pengajar dapat menggunakan gambar dinamis untuk menjelaskan konsep atau langkah-langkah kompleks, membantu siswa memahami dan mengingat informasi secara lebih efektif.

    Penagihan

    Animasi frame ditagih sebagai Transkoding media, dengan biaya berdasarkan resolusi dan durasi. Untuk informasi selengkapnya, lihat Penagihan Transkoding media.

    Catatan penggunaan

    • Animasi frame mungkin gagal dibuat jika file media hanya berisi audio tanpa aliran video, file sumber rusak, atau metadata kontainer tidak valid.

    • Proses pembuatan animasi frame bersifat asinkron. Anda dapat memeriksa status pekerjaan dengan menggunakan callback DynamicImageComplete.

    • Waktu yang diperlukan untuk membuat animasi frame bergantung pada ukuran file, durasi file, dan durasi animasi.

    Prasyarat

    • ApsaraVideo VOD telah diaktifkan. Untuk informasi selengkapnya, lihat Aktifkan ApsaraVideo VOD.

    • Pengguna RAM atau Peran RAM yang Anda gunakan memiliki izin yang sesuai untuk mengakses ApsaraVideo VOD. Kami menyarankan Anda menggunakan Pengguna RAM atau Peran RAM untuk melakukan operasi guna meningkatkan keamanan akun dan sumber daya Anda. Untuk informasi selengkapnya, lihat Buat dan berikan izin kepada Pengguna RAM.

    Langkah 1: Buat templat animasi frame

    Templat animasi frame menyederhanakan pengiriman tugas dengan memungkinkan Anda mengonfigurasi parameter terlebih dahulu dan mereferensikan ID templat alih-alih meneruskan parameter tersebut untuk setiap tugas.

    Konsol

    1. Masuk ke Konsol ApsaraVideo VOD.

    2. Di panel navigasi kiri, pilih Configuration Management > Media Processing > Frame Animation Templates.

    3. Klik Create Frame Animation Template. Pada halaman Add Frame Animation Template, konfigurasikan parameter untuk templat.

      Parameter

      Deskripsi

      Template name

      Nama templat animasi frame. Nama harus terdiri dari 4 hingga 64 karakter dan dapat berisi huruf kapital, huruf kecil, angka, tanda hubung (-), dan garis bawah (_).

      Output format

      Format output gambar dinamis. Nilai yang valid: gif dan webp.

      Frame rate

      Laju frame gambar dinamis. Bilangan bulat dalam rentang (0, 60].

      Size (width × height)

      Lebar dan tinggi gambar dinamis, dalam piksel.

      Catatan

      • Jika Anda tidak menentukan lebar dan tinggi, gambar dinamis akan memiliki dimensi yang sama dengan video sumber.

      • Jika Anda hanya menentukan lebar atau tinggi, ApsaraVideo VOD secara otomatis menskalakan dimensi lainnya agar mempertahankan rasio aspek asli video.

      Trim mode

      Metode yang digunakan untuk menentukan rentang waktu video yang akan ditangkap. Opsi yang didukung: By Duration atau Trim from Beginning and End.

      Start time

      Waktu mulai untuk menangkap animasi. Nilainya harus antara 0,000 hingga 86399,999, inklusif. Satuan: detik.

      Duration

      Durasi animasi yang akan ditangkap, dimulai dari Start Time. Nilainya harus antara 0,000 hingga 86399,999, inklusif. Satuan: detik.

      Catatan

      Parameter ini wajib diisi ketika By Duration diatur ke By Duration.

      Trim from end

      Durasi yang dipangkas dari akhir video. Nilainya harus antara 0,000 hingga 86399,999, inklusif. Satuan: detik.

      Catatan

      Parameter ini wajib diisi ketika Trim from Beginning and End diatur ke Trim from Beginning and End.

      Set as default cover

      Jika Anda mengaktifkan fitur ini, animasi frame yang dihasilkan akan secara otomatis diatur sebagai gambar sampul video.

    4. Klik Save untuk menyelesaikan konfigurasi templat.

      Setelah templat dibuat, templat tersebut akan muncul dalam daftar Frame animation templates. Daftar tersebut menampilkan informasi seperti Template name, ID, Output format, frame rate, size (width × height), trim mode, dan Set as default cover. Di kolom Actions, Anda dapat Edit atau Delete templat. Klik Add frame animation template untuk membuat yang baru.

    API

    Panggil operasi AddVodTemplate, atur parameter TemplateType ke DynamicImage, dan sesuaikan parameter lainnya untuk membuat templat animasi frame.

    Setelah templat dibuat, sistem mengembalikan ID templat dalam bidang VodTemplateId.

    Langkah 2: (Opsional) Konfigurasikan notifikasi event

    Sebelum memulai tugas animasi frame, konfigurasikan notifikasi event untuk DynamicImageComplete agar menerima status tugas dan URL animasi frame yang dihasilkan setelah tugas selesai.

    Untuk informasi selengkapnya, lihat Konfigurasikan callback.

    Langkah 3: Mulai tugas animasi frame

    Konsol

    1. Buat alur kerja yang mencakup node Frame Animation Template.

      Anda harus menggunakan alur kerja untuk memulai tugas animasi frame di Konsol ApsaraVideo VOD. Buat alur kerja yang mencakup tugas animasi frame dengan menambahkan node Frame Animation Template dan mengatur templat animasi frame ke templat yang Anda buat di Langkah 1. Untuk informasi selengkapnya tentang cara membuat alur kerja, lihat Kelola alur kerja.

    2. Mulai tugas animasi frame.

      • Skenario 1: Buat animasi frame saat mengunggah video

        1. Di Konsol ApsaraVideo VOD, pilih Media Files > Audio/Video di panel navigasi kiri.

        2. Klik Upload Media.

        3. Konfigurasikan metode unggah dan lokasi penyimpanan, tambahkan video Anda, pilih Use Workflow, lalu pilih alur kerja yang berisi tugas animasi frame.

        4. Klik Upload.

      • Skenario 2: Buat animasi frame setelah video diunggah

        1. Di Konsol ApsaraVideo VOD, pilih Media Files > Audio/Video di panel navigasi kiri.

        2. Di halaman Audio/Video, temukan video target dan klik Processing di kolom Actions.

        3. Atur Processing Type ke Use Workflow dan pilih alur kerja yang berisi tugas animasi frame dari daftar drop-down Workflow.

        4. Klik OK.

    API

    • Skenario 1: Buat animasi frame saat mengunggah video

      1. Buat alur kerja yang berisi node Frame Animation Template.

        Tambahkan node Frame Animation Template ke alur kerja dan atur templat animasi frame ke templat yang Anda buat di Langkah 1. Untuk informasi selengkapnya tentang cara membuat alur kerja, lihat Kelola alur kerja.

      2. Saat memanggil operasi API unggah media, atur parameter WorkflowId ke ID alur kerja yang baru saja Anda buat. Konfigurasikan parameter lainnya sesuai kebutuhan untuk menyelesaikan unggahan. Operasi API terkait meliputi:

    • Skenario 2: Buat animasi frame setelah video diunggah

      Panggil operasi SubmitDynamicImageJob. Atur parameter DynamicImageTemplateId ke ID templat yang Anda buat di Langkah 1, dan konfigurasikan parameter lainnya sesuai kebutuhan untuk memulai tugas animasi frame untuk video tertentu.

    Langkah 4: Dapatkan informasi animasi frame

    • (Direkomendasikan) Jika Anda telah mengonfigurasi notifikasi event, Anda akan menerima callback DynamicImageComplete yang berisi informasi animasi.

    • Setelah tugas animasi frame selesai, Anda dapat memanggil operasi ListDynamicImage untuk mengambil detail animasi yang dihasilkan.

    Catatan

    Jika Anda telah mengatur animasi frame sebagai sampul, Anda dapat memanggil operasi GetVideoInfo untuk mendapatkan URL animasi sampul.