ApsaraVideo VOD：Mengatur gambar mini video

1. Buat templat snapshot untuk mengambil frame pertama video.

   1. Masuk ke konsol ApsaraVideo VOD.

   2. Pada panel navigasi sebelah kiri, pilih Configuration Management > Media Processing > Snapshot Templates.

   3. Klik Create Snapshot Template dan konfigurasikan parameter templat snapshot frame pertama.

      Atur Template Name ke nama kustom dan Snapshot Type ke Normal Snapshot. Atur Start Time ke 00:00:00 dan Snapshot Count: ke 1. Anda dapat mengonfigurasi parameter lain sesuai kebutuhan. Untuk informasi selengkapnya tentang parameter templat snapshot, lihat Templat snapshot.

   4. Klik Save untuk membuat templat snapshot.

2. Jalankan pekerjaan snapshot untuk mengambil frame pertama video.

   Catatan

   • Menjalankan pekerjaan snapshot di console memerlukan alur kerja. Pertama, buat alur kerja yang mencakup node Snapshots. Lalu, atur templat snapshot ke templat snapshot frame pertama. Untuk informasi selengkapnya tentang cara membuat alur kerja, lihat Manajemen alur kerja.

   • Sebelum menjalankan pekerjaan snapshot, konfigurasikan notifikasi event untuk ApsaraVideo VOD. Atur notifikasi untuk event SnapshotComplete. Hal ini memungkinkan Anda mengambil status pekerjaan dan URL snapshot setelah pekerjaan selesai. Untuk informasi selengkapnya tentang cara mengonfigurasi notifikasi event, lihat Pengaturan callback.

   • Skenario 1: Mengambil snapshot saat pengunggahan video

     1. Di konsol ApsaraVideo VOD, pada panel navigasi sebelah kiri, pilih Media Files > Audio/Video.

     2. Klik Upload Audio/Video, lalu klik Add Audio/Video.

     3. Atur metode pengunggahan dan alamat penyimpanan, lalu tambahkan video. Kemudian, pilih Use Workflow dan pilih alur kerja yang telah dibuat sebelumnya yang mencakup pekerjaan snapshot frame pertama.

     4. Klik Upload.

   • Skenario 2: Mengambil snapshot setelah video diunggah

     1. Di konsol ApsaraVideo VOD, pada panel navigasi sebelah kiri, pilih Media Files > Audio/Video.

     2. Pada halaman Audio dan Video, klik Media Processing pada baris video target.

     3. Atur Processing Type ke Use Workflow. Untuk parameter Workflows, pilih alur kerja yang telah dibuat sebelumnya yang mencakup pekerjaan snapshot frame pertama.

     4. Klik OK.

   • Ambil hasil snapshot

     • Jika Anda telah mengonfigurasi notifikasi event untuk event SnapshotComplete di ApsaraVideo VOD, Anda dapat mengambil status pekerjaan dan URL snapshot dari event callback.

     • Jika belum mengonfigurasi notifikasi event, Anda dapat menggunakan polling untuk memanggil operasi ListSnapshots guna menanyakan status pekerjaan dan URL snapshot.

3. Ubah gambar mini video menjadi tangkapan frame pertama.

   Catatan

   Anda hanya dapat menggunakan console untuk mengubah gambar mini video setelah video diunggah. Simpan terlebih dahulu tangkapan frame pertama yang diperoleh pada langkah sebelumnya ke komputer lokal sebagai persiapan untuk diunggah.

   1. Pada panel navigasi kiri konsol ApsaraVideo VOD, pilih Media Files > Audio/Video.

   2. Pada halaman Daftar Audio dan Video, klik Manage pada baris video target.

   3. Pada tab Basic information, klik Editing Video Information .

   4. Klik Upload, pilih tangkapan frame pertama dari komputer Anda, lalu klik Open.

   5. Klik Save untuk mengatur gambar mini video.

      Setelah konfigurasi selesai, Anda dapat memverifikasi bahwa gambar mini telah diperbarui di halaman daftar audio dan video.

Prosedur

1. Buat templat snapshot untuk mengambil frame pertama video.

   Panggil operasi AddVodTemplate untuk membuat templat snapshot pengambilan frame pertama. Kode contoh berikut menunjukkan cara memanggil operasi tersebut:

   import com.aliyuncs.DefaultAcsClient;
   import com.aliyuncs.exceptions.ClientException;
   import com.aliyuncs.profile.DefaultProfile;
   import com.aliyuncs.vod.model.v20170321.AddVodTemplateRequest;
   import com.aliyuncs.vod.model.v20170321.AddVodTemplateResponse;
   
   
   /**
    * Deskripsi:
    * 1. Demo ini menunjukkan cara membuat templat snapshot frame pertama. Outputnya adalah satu gambar.
    * 2. Membuat templat snapshot di konsol ApsaraVideo VOD lebih mudah.
    */
   public class AddSnapshotTemplate {
   
       // Pasangan Kunci Akses Akun Alibaba Cloud memiliki izin atas semua operasi API. Gunakan Pengguna RAM untuk memanggil operasi API atau melakukan O&M rutin.
       // Jangan simpan ID AccessKey dan Rahasia AccessKey di kode proyek Anda. Jika tidak, pasangan Kunci Akses dapat bocor, yang mengancam keamanan semua sumber daya dalam akun Anda.
       // Contoh ini menunjukkan cara membaca pasangan Kunci Akses dari variabel lingkungan untuk verifikasi identitas. Sebelum menjalankan kode contoh, konfigurasikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET.
       public static String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
       public static String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
   
       public static void main(String[] args) {
   
           try{
               DefaultAcsClient vodClient = initVodClient(accessKeyId, accessKeySecret);
               AddVodTemplateResponse response = addSnapshotTemplate(vodClient);
               System.out.println("RequestId is:" + response.getRequestId());
               System.out.println("TemplateId is:" + response.getVodTemplateId());
           }catch (Exception e){
   
           }
       }
   
       public static AddVodTemplateResponse addSnapshotTemplate(DefaultAcsClient vodClient) throws ClientException {
           AddVodTemplateRequest request = new AddVodTemplateRequest();
           request.setName("FirstFrameSnapshotTemplate");
           request.setTemplateType("Snapshot");
           request.setTemplateConfig("{\"SnapshotType\":\"NormalSnapshot\",\"SnapshotConfig\":{\"FrameType\":\"normal\",\"Count\":1,\"Interval\":1,\"SpecifiedOffsetTime\":0}}");
   
           return vodClient.getAcsResponse(request);
       }
   
       public static DefaultAcsClient initVodClient(String accessKeyId, String accessKeySecret) throws ClientException {
           // Wilayah tempat ApsaraVideo VOD diaktifkan.
           String regionId = "cn-shanghai";  
           DefaultProfile profile = DefaultProfile.getProfile(regionId, accessKeyId, accessKeySecret);
           DefaultAcsClient client = new DefaultAcsClient(profile);
   
           return client;
       }
   }
   

2. Jalankan pekerjaan snapshot untuk mengambil frame pertama video.

   Panggil operasi SubmitSnapshotJob untuk menjalankan pekerjaan snapshot. Kode contoh berikut menunjukkan cara memanggil operasi tersebut:

   import com.aliyuncs.DefaultAcsClient;
   import com.aliyuncs.exceptions.ClientException;
   import com.aliyuncs.profile.DefaultProfile;
   import com.aliyuncs.vod.model.v20170321.*;
   
   /**
    * Deskripsi:
    * 1. Demo ini menunjukkan cara mengirim pekerjaan snapshot frame pertama setelah membuat templat snapshot frame pertama.
    * 2. Untuk video yang baru diunggah, lakukan langkah ini setelah event MediaProcessFinished berhasil. Untuk video yang sudah ada dalam status Normal, rancang proses Anda sendiri.
    * 3. Proses snapshot merupakan tugas asinkron. Tunggu hingga event SnapshotComplete berhasil untuk mendapatkan URL snapshot.
    * 4. Anda dapat menginferensi URL output snapshot dari parameter SnapshotRegular dalam event callback. Untuk informasi selengkapnya, lihat aturan pembuatan URL snapshot dalam topik SnapshotComplete.
    * 5. Jika Anda tidak memiliki layanan callback, Anda juga dapat memanggil operasi ListSnapshots untuk menanyakan hasilnya. Secara default, operasi ini hanya mengembalikan hasil snapshot terbaru. Untuk informasi selengkapnya, lihat topik ListSnapshots.
    */
   public class SubmitSnapshotJob {
   
       // Pasangan Kunci Akses Akun Alibaba Cloud memiliki izin atas semua operasi API. Gunakan Pengguna RAM untuk memanggil operasi API atau melakukan O&M rutin.
       // Jangan simpan ID AccessKey dan Rahasia AccessKey di kode proyek Anda. Jika tidak, pasangan Kunci Akses dapat bocor, yang mengancam keamanan semua sumber daya dalam akun Anda.
       // Contoh ini menunjukkan cara membaca pasangan Kunci Akses dari variabel lingkungan untuk verifikasi identitas. Sebelum menjalankan kode contoh, konfigurasikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET.
       public static String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
       public static String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
   
       public static void main(String[] args) {
   
           try{
               DefaultAcsClient vodClient = initVodClient(accessKeyId, accessKeySecret);
               SubmitSnapshotJobResponse response = submitSnapshotJob(vodClient);
               System.out.println("RequestId is:" + response.getRequestId());
               System.out.println("JobId is:" + response.getSnapshotJob().getJobId());
           }catch (Exception e){
   
           }
       }
   
       public static SubmitSnapshotJobResponse submitSnapshotJob(DefaultAcsClient vodClient) throws ClientException {
           SubmitSnapshotJobRequest request = new SubmitSnapshotJobRequest();
           request.setVideoId("a42b**********633b79f0102");
           request.setSnapshotTemplateId("1f27a7**********eba2756");
           // Parameter pass-through kustom. Tersedia dalam callback dan bersifat opsional. Digunakan untuk membedakan snapshot frame pertama untuk gambar mini.
           request.setUserData("{\"Extend\":{\"SnapshotType\":\"FirstFrame\",\"VideoId\":\"a42bf540********33b79f0102\"}}");
           return vodClient.getAcsResponse(request);
       }
   
       public static DefaultAcsClient initVodClient(String accessKeyId, String accessKeySecret) throws ClientException {
           // Wilayah tempat ApsaraVideo VOD diaktifkan.
           String regionId = "cn-shanghai";  
           DefaultProfile profile = DefaultProfile.getProfile(regionId, accessKeyId, accessKeySecret);
           DefaultAcsClient client = new DefaultAcsClient(profile);
   
           return client;
       }
   
       // ListSnapshots: Menanyakan snapshot
       public static ListSnapshotsResponse listSnapshots(DefaultAcsClient vodClient) throws ClientException {
           ListSnapshotsRequest request = new ListSnapshotsRequest();
           request.setVideoId("a42bf540b1b371ed804a6633b79****");
           request.setSnapshotType("NormalSnapshot");
   
           ListSnapshotsResponse response = vodClient.getAcsResponse(request);
           System.out.println("RequestId is:" + response.getRequestId());
           System.out.println("SnapshotUrl is:" + response.getMediaSnapshot().getSnapshots().get(0).getUrl());
           return vodClient.getAcsResponse(request);
       }
   
   }
   

3. Ubah gambar mini video menjadi tangkapan frame pertama.

   Bagian ini memberikan contoh cara memodifikasi gambar mini video tunggal setelah diunggah. Untuk informasi selengkapnya tentang skenario lain, lihat Mengatur gambar mini saat pengunggahan video dan Memperbarui gambar mini setelah video diunggah.

   Panggil operasi UpdateVideoInfo dan teruskan parameter CoverURL untuk menentukan gambar mini video. Kode contoh berikut menunjukkan cara memanggil operasi tersebut:

   package com.alibaba.cloud.test.transcode;
   
   import com.aliyuncs.DefaultAcsClient;
   import com.aliyuncs.exceptions.ClientException;
   import com.aliyuncs.profile.DefaultProfile;
   import com.aliyuncs.vod.model.v20170321.UpdateVideoInfoRequest;
   import com.aliyuncs.vod.model.v20170321.UpdateVideoInfoResponse;
   
   /**
    * Deskripsi:
    * 1. Demo ini menunjukkan cara memodifikasi gambar mini video tunggal. Untuk memodifikasi parameter video lainnya, lihat topik UpdateVideoInfo.
    * 2. Saat memodifikasi gambar mini, pastikan URL gambar yang Anda gunakan valid.
    */
   public class UpdateVideoInfo {
   
       // Pasangan Kunci Akses Akun Alibaba Cloud memiliki izin atas semua operasi API. Gunakan Pengguna RAM untuk memanggil operasi API atau melakukan O&M rutin.
       // Jangan simpan ID AccessKey dan Rahasia AccessKey di kode proyek Anda. Jika tidak, pasangan Kunci Akses dapat bocor, yang mengancam keamanan semua sumber daya dalam akun Anda.
       // Contoh ini menunjukkan cara membaca pasangan Kunci Akses dari variabel lingkungan untuk verifikasi identitas. Sebelum menjalankan kode contoh, konfigurasikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET.
       public static String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
       public static String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
   
       public static void main(String[] args) {
   
           try{
               DefaultAcsClient vodClient = initVodClient(accessKeyId, accessKeySecret);
               UpdateVideoInfoResponse response = updateVideoInfo(vodClient);
               System.out.println("RequestId is:" + response.getRequestId());
           }catch (Exception e){
   
           }
       }
   
       public static UpdateVideoInfoResponse updateVideoInfo(DefaultAcsClient vodClient) throws ClientException {
           UpdateVideoInfoRequest request = new UpdateVideoInfoRequest();
           request.setVideoId("a42b***********33b79f0102");
           // Saat mengatur gambar mini frame pertama, CoverURL adalah URL gambar yang dikembalikan setelah pekerjaan snapshot frame pertama berhasil.
           request.setCoverURL("http://demo.aliyuncdn.com/a42bf5******40b1b37/snapshots/normal/41B7AF54-18672BB301D-1748-0984-309-112420****.jpg");
   
           return vodClient.getAcsResponse(request);
       }
   
       public static DefaultAcsClient initVodClient(String accessKeyId, String accessKeySecret) throws ClientException {
           // Wilayah tempat ApsaraVideo VOD diaktifkan.
           String regionId = "cn-shanghai";  
           DefaultProfile profile = DefaultProfile.getProfile(regionId, accessKeyId, accessKeySecret);
           DefaultAcsClient client = new DefaultAcsClient(profile);
           return client;
       }
   }
   

Contoh lengkap

package com.alibaba.cloud.test.transcode;


import com.alibaba.fastjson.JSONObject;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.vod.model.v20170321.*;
import org.apache.commons.lang3.StringUtils;

/**
 * Deskripsi:
 * 1. Demo ini menunjukkan logika lengkap untuk mengambil snapshot dan memodifikasi gambar mini. Anda perlu memodifikasi sebagian kode berdasarkan logika bisnis Anda.
 * 2. Demo ini tidak dapat digunakan langsung. Anda perlu menambahkan beberapa logika sendiri.
 * 3. Demo ini hanya sebagai referensi dan bukan satu-satunya metode implementasi.
 */
public class SnapshotAndUpdateCover {

    // Pasangan Kunci Akses Akun Alibaba Cloud memiliki izin atas semua operasi API. Gunakan Pengguna RAM untuk memanggil operasi API atau melakukan O&M rutin.
    // Jangan simpan ID AccessKey dan Rahasia AccessKey di kode proyek Anda. Jika tidak, pasangan Kunci Akses dapat bocor, yang mengancam keamanan semua sumber daya dalam akun Anda.
    // Contoh ini menunjukkan cara membaca pasangan Kunci Akses dari variabel lingkungan untuk verifikasi identitas. Sebelum menjalankan kode contoh, konfigurasikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET.
    public static String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
    public static String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");

    public static void main(String[] args) {


        try{
            DefaultAcsClient vodClient = initVodClient(accessKeyId, accessKeySecret);
            // ID Video
            String videoId = "a42bf540b1b37*******b79f0102";

            // Skenario 1: Anda memiliki layanan callback atau MNS.
            // Jika Anda mengatur gambar mini untuk video yang baru diunggah, Anda harus terlebih dahulu mendapatkan event keberhasilan analisis media.
            // Jika Anda mengatur gambar mini untuk video yang sudah ada, Anda dapat langsung mengirim pekerjaan snapshot dari langkah ini.
            submitSnapshotJob(vodClient,videoId);

            // Dapatkan event keberhasilan snapshot video, tentukan jenis snapshot, dan ambil URL gambar yang diperlukan.
            JSONObject callBackMessage = new JSONObject();  // Ganti ini dengan pesan yang diterima oleh layanan callback.
            String snapshotType = callBackMessage.getJSONObject("UserData").getJSONObject("Extend").getString("SnapshotType");
            if("FirstFrame".equals(snapshotType)){

                // Logika jalur snapshot di sini perlu diganti dengan logika jalur snapshot kustom Anda.
                String coverUrl = callBackMessage.getJSONArray("SnapshotInfos").getJSONObject(0).getString("SnapshotRegular").replace("{SnapshotCount}","00001");
                // Modifikasi gambar mini video.
                updateVideoInfo(vodClient,videoId,coverUrl);
            }

            // Skenario 2: Anda tidak memiliki layanan callback atau MNS.
            // Jika Anda mengatur gambar mini untuk video yang baru diunggah, polling status video setelah pengunggahan.
            String videoStatus = "";
            while(!"Normal".equals(videoStatus)){
                videoStatus = getVideoInfo(vodClient,videoId);
                Thread.sleep(1000);
            }

            // Jika Anda mengatur gambar mini untuk video yang sudah ada, Anda dapat langsung mengirim pekerjaan snapshot dari langkah ini.
            submitSnapshotJob(vodClient,videoId);

            // Polling hasil snapshot.
            String coverUrl = "";
            while(StringUtils.isBlank(coverUrl)){
                coverUrl = listSnapshots(vodClient,videoId);
                Thread.sleep(1000);
            }

            // Modifikasi gambar mini video.
            updateVideoInfo(vodClient,videoId,coverUrl);
        }catch (Exception e){

        }
    }

    /**
     * Mengirim pekerjaan snapshot.
     */
    public static SubmitSnapshotJobResponse submitSnapshotJob(DefaultAcsClient vodClient, String vid) throws ClientException {
        SubmitSnapshotJobRequest request = new SubmitSnapshotJobRequest();
        request.setVideoId(vid);
        request.setSnapshotTemplateId("1f27a7f*********70eba2756");
        // Parameter pass-through kustom. Tersedia dalam callback dan bersifat opsional. Digunakan untuk membedakan snapshot frame pertama untuk gambar mini.
        request.setUserData("{\"Extend\":{\"SnapshotType\":\"FirstFrame\",\"VideoId\":\"a42bf540********33b79f0102\"}}");

        return vodClient.getAcsResponse(request);
    }

    /**
     * Memodifikasi gambar mini video.
     */
    public static UpdateVideoInfoResponse updateVideoInfo(DefaultAcsClient vodClient, String vid, String coverUrl) throws ClientException {
        UpdateVideoInfoRequest request = new UpdateVideoInfoRequest();
        request.setVideoId(vid);
        // Saat mengatur gambar mini frame pertama, CoverURL adalah URL gambar yang dikembalikan setelah pekerjaan snapshot frame pertama berhasil.
        request.setCoverURL(coverUrl);

        return vodClient.getAcsResponse(request);
    }

    /**
     * Menginisialisasi instans SDK.
     */
    public static DefaultAcsClient initVodClient(String accessKeyId, String accessKeySecret) throws ClientException {
        // Wilayah tempat ApsaraVideo VOD diaktifkan.
        String regionId = "cn-shanghai";  
        DefaultProfile profile = DefaultProfile.getProfile(regionId, accessKeyId, accessKeySecret);
        DefaultAcsClient client = new DefaultAcsClient(profile);

        return client;
    }

    /**
     * Menanyakan snapshot.
     */
    public static String listSnapshots(DefaultAcsClient vodClient, String vid) throws ClientException {
        ListSnapshotsRequest request = new ListSnapshotsRequest();
        request.setVideoId(vid);
        request.setSnapshotType("NormalSnapshot");

        ListSnapshotsResponse response = vodClient.getAcsResponse(request);
        String coverUrl = "";
        System.out.println("RequestId is:" + response.getRequestId());
        try{
            coverUrl = response.getMediaSnapshot().getSnapshots().get(0).getUrl();
            System.out.println("SnapshotUrl is:" + response.getMediaSnapshot().getSnapshots().get(0).getUrl());
        }catch (NullPointerException e){

        }
        return coverUrl;
    }

    /**
     * Menanyakan video tunggal.
     */
    public static String getVideoInfo(DefaultAcsClient vodClient, String vid) throws ClientException {
        GetVideoInfoRequest request = new GetVideoInfoRequest();
        request.setVideoId(vid);

        GetVideoInfoResponse response = vodClient.getAcsResponse(request);
        System.out.println("RequestId is:" + response.getRequestId());
        String videoStatus = "";
        try{
            videoStatus = response.getVideo().getStatus();
            System.out.println("Video Status is:" + response.getVideo().getStatus());
        }catch (NullPointerException e){

        }

        return videoStatus;
    }
}