ApsaraVideo VOD：Atur gambar mini video

1. Buat template snapshot untuk menangkap frame pertama video.

   1. Masuk ke Konsol ApsaraVideo VOD.

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

   3. Di halaman Template Snapshot, klik Add Template. Di halaman yang muncul, konfigurasikan parameter untuk menangkap frame pertama video.

      Tentukan nama template kustom untuk Template Name, atur Snapshot Type ke Normal Snapshot, Start Time ke 00:00:00, dan Snapshot Count ke 1. Tentukan parameter lainnya berdasarkan kebutuhan bisnis Anda. Untuk informasi lebih lanjut tentang parameter, lihat Kelola Template Snapshot.

   4. Klik Save.

2. Buat tugas snapshot untuk menangkap frame pertama video.

   Catatan

   • Untuk membuat tugas snapshot di Konsol ApsaraVideo VOD, Anda harus membuat alur kerja, tambahkan node Snapshots di alur kerja, lalu tentukan template snapshot yang Anda buat untuk menangkap frame pertama video. Untuk informasi lebih lanjut tentang cara membuat alur kerja, lihat Kelola Alur Kerja.

   • Kami sarankan Anda mengonfigurasi notifikasi peristiwa SnapshotComplete sebelum membuat tugas snapshot. Dengan cara ini, Anda dapat memperoleh informasi seperti status tugas dan URL snapshot dari callback setelah tugas selesai. Untuk informasi lebih lanjut tentang cara mengonfigurasi notifikasi peristiwa, lihat Konfigurasikan Callback.

   • Skenario 1: Tangkap Snapshot Selama Pengunggahan

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

     2. Di halaman Video dan Audio, klik Upload. Di halaman Unggah Media, klik Add Media.

     3. Di kotak dialog Tambah Media, tentukan metode pengunggahan, alamat penyimpanan, dan file yang ingin diunggah. Lalu, pilih Use Workflow dari daftar drop-down dan alur kerja yang Anda buat untuk menangkap frame pertama video.

     4. Klik Upload.

   • Skenario 2: Tangkap Snapshot Setelah Pengunggahan

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

     2. Di halaman Video dan Audio, temukan file yang ingin ditangkap snapshothnya dan klik Media Processing di kolom Tindakan.

     3. Di kotak dialog Pemrosesan Media, atur Processing Type ke Use Workflow dan Workflow ke alur kerja yang Anda buat untuk menangkap frame pertama video.

     4. Klik OK.

   • Peroleh Hasil Tugas Snapshot

     • Jika Anda mengonfigurasi notifikasi peristiwa SnapshotComplete sebelum membuat tugas snapshot, Anda dapat memperoleh informasi seperti status tugas dan URL snapshot dari callback setelah tugas selesai.

     • Jika Anda tidak mengonfigurasi notifikasi peristiwa SnapshotComplete sebelum membuat tugas snapshot, Anda dapat menggunakan metode round-robin untuk memanggil operasi ListSnapshots untuk memperoleh informasi seperti status tugas dan URL snapshot.

3. Ubah gambar mini video menjadi frame pertama video.

   Catatan

   Anda hanya dapat mengubah gambar mini video di Konsol ApsaraVideo VOD setelah video diunggah. Untuk menggunakan frame pertama video sebagai gambar mini, Anda harus menyimpan snapshot yang ditangkap di Langkah 2 ke perangkat lokal Anda.

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

   2. Di halaman Video dan Audio, temukan video yang ingin diubah gambarnya mini dan klik Manage di kolom Tindakan.

   3. Di tab Basic Information, klik Editing Video Information.

   4. Di halaman yang muncul, klik Upload, pilih snapshot yang ditangkap di Langkah 2 dari perangkat lokal Anda, lalu klik Open.

   5. Klik Save.

      Anda dapat memeriksa apakah gambar mini video telah diubah di halaman Video dan Audio.

Prosedur

1. Buat template snapshot untuk menangkap frame pertama video.

   Panggil operasi AddVodTemplate untuk membuat template snapshot untuk menangkap frame pertama video. Contoh kode:

   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;
   
   
   /**
    * Catatan:
    * 1. Kode sampel berikut digunakan untuk membuat template snapshot untuk menangkap frame pertama video dan mengekspor gambar. 
    * 2. Kami sarankan Anda membuat template snapshot di konsol ApsaraVideo VOD. 
    */
   public class AddSnapshotTemplate {
   
       // Pasangan AccessKey dari akun Alibaba Cloud memiliki izin pada semua operasi API. Kami sarankan Anda menggunakan pengguna RAM untuk memanggil operasi API atau melakukan pemeliharaan rutin. 
       // Kami sarankan Anda tidak menyertakan pasangan AccessKey (AccessKey ID dan Rahasia AccessKey) dalam kode proyek Anda. Jika tidak, pasangan AccessKey mungkin bocor dan keamanan semua sumber daya dalam akun Anda mungkin terganggu. 
       // Dalam contoh ini, ApsaraVideo VOD membaca pasangan AccessKey dari variabel lingkungan untuk menerapkan verifikasi identitas untuk akses API. Sebelum Anda menjalankan kode sampel, 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("Template snapshot frame pertama");
           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. Buat tugas snapshot untuk menangkap frame pertama video.

   Panggil operasi SubmitSnapshotJob untuk mengirimkan tugas snapshot. Contoh kode:

   import com.aliyuncs.DefaultAcsClient;
   import com.aliyuncs.exceptions.ClientException;
   import com.aliyuncs.profile.DefaultProfile;
   import com.aliyuncs.vod.model.v20170321.*;
   
   /**
    * Catatan:
    * 1. Kode sampel berikut digunakan untuk membuat tugas snapshot setelah Anda membuat template snapshot untuk menangkap frame pertama video. 
    * 2. Setelah Anda mengunggah video ke ApsaraVideo VOD, Anda dapat membuat tugas snapshot untuk video tersebut hanya setelah callback peristiwa VideoAnalysisComplete dikembalikan. Ini tidak diperlukan untuk video yang sudah ada dalam status normal. 
    * 3. Tugas snapshot diproses secara asinkron. Kami sarankan Anda memeriksa URL snapshot setelah callback peristiwa SnapshotComplete dikembalikan. 
    * 4. Anda dapat memperoleh URL keluaran snapshot dari parameter SnapshotRegular di callback. Untuk informasi lebih lanjut, lihat bagian "Pembuatan URL snapshot" dari topik SnapshotComplete. 
    * 5. Jika Anda tidak mengaktifkan fitur callback, Anda dapat memanggil operasi ListSnapshots untuk memeriksa informasi snapshot terbaru. Untuk informasi lebih lanjut, lihat ListSnapshots. 
    */
   public class SubmitSnapshotJob {
   
       // Pasangan AccessKey dari akun Alibaba Cloud memiliki izin pada semua operasi API. Kami sarankan Anda menggunakan pengguna RAM untuk memanggil operasi API atau melakukan pemeliharaan rutin. 
       // Kami sarankan Anda tidak menyertakan pasangan AccessKey (AccessKey ID dan Rahasia AccessKey) dalam kode proyek Anda. Jika tidak, pasangan AccessKey mungkin bocor dan keamanan semua sumber daya dalam akun Anda mungkin terganggu. 
       // Dalam contoh ini, ApsaraVideo VOD membaca pasangan AccessKey dari variabel lingkungan untuk menerapkan verifikasi identitas untuk akses API. Sebelum Anda menjalankan kode sampel, 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");
           // Opsional. Parameter pass-through kustom. Parameter ini digunakan untuk mengidentifikasi snapshot frame pertama. Anda dapat menggunakan parameter ini dalam callback peristiwa.
           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;
       }
   
       // Panggil operasi ListSnapshots untuk memeriksa 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 frame pertama video.

   Berikut ini menjelaskan cara mengubah gambar mini setelah video diunggah. Untuk informasi lebih lanjut tentang cara mengatur gambar mini video dalam skenario lainnya, lihat Atur Gambar Mini Selama Pengunggahan dan Ubah Gambar Mini Setelah Video Diunggah.

   Untuk mengubah gambar mini video yang telah diunggah, panggil operasi UpdateVideoInfo dan konfigurasikan parameter CoverURL. Contoh kode:

   package com.alibaba.bltest.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;
   
   /**
    * Catatan:
    * 1. Kode sampel berikut digunakan untuk mengubah gambar mini video. Untuk informasi lebih lanjut tentang cara memodifikasi parameter video lainnya, lihat dokumentasi operasi UpdateVideoInfo. 
    * 2. Pastikan bahwa URL gambar mini yang Anda tentukan dapat diakses. 
    */
   public class UpdateVideoInfo {
   
       // Pasangan AccessKey dari akun Alibaba Cloud memiliki izin pada semua operasi API. Kami sarankan Anda menggunakan pengguna RAM untuk memanggil operasi API atau melakukan pemeliharaan rutin. 
       // Kami sarankan Anda tidak menyertakan pasangan AccessKey (AccessKey ID dan Rahasia AccessKey) dalam kode proyek Anda. Jika tidak, pasangan AccessKey mungkin bocor dan keamanan semua sumber daya dalam akun Anda mungkin terganggu. 
       // Dalam contoh ini, ApsaraVideo VOD membaca pasangan AccessKey dari variabel lingkungan untuk menerapkan verifikasi identitas untuk akses API. Sebelum Anda menjalankan kode sampel, 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");
           // Atur CoverURL ke URL gambar yang dihasilkan oleh tugas snapshot untuk menangkap frame pertama video.
           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 {
           // Tentukan wilayah tempat ApsaraVideo VOD diaktifkan.
           String regionId = "cn-shanghai";  
           DefaultProfile profile = DefaultProfile.getProfile(regionId, accessKeyId, accessKeySecret);
           DefaultAcsClient client = new DefaultAcsClient(profile);
           return client;
       }
   }
   

Kode Sampel Lengkap

package com.alibaba.bltest.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;

/**
 * Catatan:
 * 1. Kode sampel berikut digunakan untuk menangkap snapshot video dan mengubah gambar mini video. Anda dapat memodifikasi kode berdasarkan kebutuhan bisnis Anda. 
 * 2. Anda harus menambahkan logika spesifik ke kode sampel berikut sebelum Anda dapat menggunakan kode tersebut. 
 * 3. Kode sampel berikut hanya untuk referensi. Anda dapat menggunakan metode lain untuk menangkap snapshot video dan memodifikasi gambar mini video. 
 */
public class SnapshotAndUpdateCover {

    // Pasangan AccessKey dari akun Alibaba Cloud memiliki izin pada semua operasi API. Kami sarankan Anda menggunakan pengguna RAM untuk memanggil operasi API atau melakukan pemeliharaan rutin. 
    // Kami sarankan Anda tidak menyertakan pasangan AccessKey (AccessKey ID dan Rahasia AccessKey) dalam kode proyek Anda. Jika tidak, pasangan AccessKey mungkin bocor dan keamanan semua sumber daya dalam akun Anda mungkin terganggu. 
    // Dalam contoh ini, ApsaraVideo VOD membaca pasangan AccessKey dari variabel lingkungan untuk menerapkan verifikasi identitas untuk akses API. Sebelum Anda menjalankan kode sampel, 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: Fitur callback diaktifkan atau Message Service (MNS) diaktifkan
            // Anda dapat mengatur gambar mini video yang baru diunggah hanya setelah callback VideoAnalysisComplete dikembalikan.
            // Untuk mengatur gambar mini video yang sudah ada, panggil operasi submitSnapshotJob.
            submitSnapshotJob(vodClient,videoId);

            // Setelah callback SnapshotComplete dikembalikan, peroleh tipe snapshot dan URL snapshot.
            JSONObject callBackMessage = new JSONObject();  // Tentukan pesan callback.
            String snapshotType = callBackMessage.getJSONObject("UserData").getJSONObject("Extend").getString("SnapshotType");
            if("FirstFrame".equals(snapshotType)){

                // Tentukan jalur penyimpanan snapshot berdasarkan kebutuhan bisnis Anda.
                String coverUrl = callBackMessage.getJSONArray("SnapshotInfos").getJSONObject(0).getString("SnapshotRegular").replace("{SnapshotCount}","00001");
                // Ubah gambar mini video.
                updateVideoInfo(vodClient,videoId,coverUrl);
            }

            // Skenario 2: Fitur callback tidak diaktifkan dan MNS tidak diaktifkan
            // Untuk mengatur gambar mini video yang baru diunggah, gunakan metode round-robin untuk memperoleh status video.
            String videoStatus = "";
            while(!"Normal".equals(videoStatus)){
                videoStatus = getVideoInfo(vodClient,videoId);
                Thread.sleep(1000);
            }

            // Untuk mengatur gambar mini video yang sudah ada, panggil operasi submitSnapshotJob.
            submitSnapshotJob(vodClient,videoId);

            // Gunakan metode round-robin untuk memperoleh hasil tugas snapshot.
            String coverUrl = "";
            while(StringUtils.isBlank(coverUrl)){
                coverUrl = listSnapshots(vodClient,videoId);
                Thread.sleep(1000);
            }

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

        }
    }

    /**
     * Kirim tugas snapshot
     */
    public static SubmitSnapshotJobResponse submitSnapshotJob(DefaultAcsClient vodClient, String vid) throws ClientException {
        SubmitSnapshotJobRequest request = new SubmitSnapshotJobRequest();
        request.setVideoId(vid);
        request.setSnapshotTemplateId("1f27a7f*********70eba2756");
        // Opsional. Parameter pass-through kustom. Parameter ini digunakan untuk mengidentifikasi snapshot frame pertama. Anda dapat menggunakan parameter ini dalam callback peristiwa.
        request.setUserData("{\"Extend\":{\"SnapshotType\":\"FirstFrame\",\"VideoId\":\"a42bf540********33b79f0102\"}}");

        return vodClient.getAcsResponse(request);
    }

    /**
     * Ubah gambar mini video
     */
    public static UpdateVideoInfoResponse updateVideoInfo(DefaultAcsClient vodClient, String vid, String coverUrl) throws ClientException {
        UpdateVideoInfoRequest request = new UpdateVideoInfoRequest();
        request.setVideoId(vid);
        // Atur CoverURL ke URL gambar yang dihasilkan oleh tugas snapshot untuk menangkap frame pertama video.
        request.setCoverURL(coverUrl);

        return vodClient.getAcsResponse(request);
    }

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

        return client;
    }

    /**
     * Periksa snapshot yang ditangkap.
     */
    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;
    }

    /**
     * Periksa informasi video.
     */
    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;
    }
}