Buat dan gunakan template reguler - Intelligent Media Services

Template reguler dibuat berdasarkan timeline dari proyek pengeditan video dan mencakup beberapa materi yang digabungkan dalam mode multi-layer. Template ini dapat digunakan untuk menerapkan efek seperti mengonversi gambar dan teks menjadi video, membuat album foto, mendesain intro dan outro video, serta menambahkan watermark default. Topik ini menjelaskan cara membuat dan menggunakan template reguler.

Buat template reguler

Gunakan konsol IMS

Masuk ke Konsol Intelligent Media Services (IMS).
Di panel navigasi sebelah kiri, pilih Intelligent Production > Online Editing.
Pada tab Proyek Pengeditan Video, temukan proyek yang ingin Anda edit, lalu klik Edit di kolom Actions. Di halaman yang muncul, edit dan simpan proyek tersebut. Setelah itu, klik Generate Template untuk membuat template reguler. Anda juga dapat mengklik Export Template di kolom Actions pada tab Proyek Pengeditan Video untuk membuat template reguler.
Untuk informasi lebih lanjut tentang cara mengedit template reguler, lihat Panduan untuk Mengedit Template Reguler.

Panggil operasi API

Kustomisasi objek Config dari template reguler.
Objek Config dari template reguler dienkapsulasi berdasarkan objek Timeline dari proyek pengeditan online. Objek Config memberikan fleksibilitas tambahan. Jika memiliki persyaratan khusus, disarankan untuk memahami struktur objek Config dan mengonfigurasi template kustom. Untuk informasi lebih lanjut, lihat Objek Config dari Template Reguler.
Kode sampel berikut menunjukkan objek Config dari template penggabungan video. Untuk detail lebih lanjut tentang contoh objek Config, lihat Konfigurasi Dasar Template.
```
{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "Sys_Type" : "ArrayItems",
                    "Sys_ArrayObject" : "$VideoArray",
                    "Sys_Template" : {
                        "MediaId" : "$MediaId"
                    }
                }
            ]
        }
    ]
}
```

Buat template reguler.

Panggil operasi AddTemplate untuk membuat template dan tentukan objek Config dari template tersebut.

AddTemplateRequest request = new AddTemplateRequest();
request.setType("Timeline"); // Jika Anda ingin membuat template reguler, atur parameter Type ke Timeline.
request.setName("Tes template reguler");
request.setConfig("{\"VideoTracks\":[{\"VideoTrackClips\":[{\"Sys_Type\":\"ArrayItems\",\"Sys_ArrayObject\":\"$VideoArray\",\"Sys_Template\":{\"MediaId\":\"$MediaId\"}}]}]}");
AddTemplateResponse response = iceClient.addTemplate(request);
System.out.println("templateId : " + response.getBody().getTemplate().getTemplateId());

Setelah template dibuat, ID template akan dikembalikan. ID ini dapat digunakan untuk tugas produksi.

Gunakan template reguler

Gunakan konsol IMS

Masuk ke Konsol IMS.
Di panel navigasi sebelah kiri, pilih Intelligent Production > Template Factory.
Gunakan template reguler untuk melakukan pengeditan online.
1. Klik tab Common Templates.
2. Temukan template yang ingin digunakan dan klik Use Template di kolom Actions.
3. Di kotak dialog yang muncul, masukkan nama proyek dan klik OK. Di pesan yang muncul, klik OK atau Cancel untuk menentukan apakah ingin mengedit proyek saat ini. Untuk informasi lebih lanjut tentang cara mengedit proyek, lihat bagian "Pengeditan Video" dari topik Pengeditan Online.

Panggil operasi API

Peroleh informasi template.
- Melalui Konsol IMS
  Jika template dibuat di Konsol IMS, temukan template pada tab Common Templates halaman Template Factory dan klik Edit Template di kolom Actions. Di halaman yang muncul, gunakan tab Dynamic material management untuk menghasilkan parameter ClipsParam.
  Nilai parameter ClipsParam terdiri dari kunci dan nilai yang sesuai. Parameter Named the ID adalah kunci, sedangkan teks atau ID aset media yang akan diganti adalah nilai. Kode sampel berikut menunjukkan nilai parameter ClipsParam:
```
{
 "1": "Teks pengganti.",
 "2": "****20b48fb04483915d4f2cd8ac****",
 "3": "****20b48fb04483915d4f2cd8ac****",
 "4": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video1.mp4",
 "5": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video2.mp4"
}
```
- Melalui API
  Panggil operasi GetTemplate untuk memperoleh informasi template dan tentukan ID template yang diperoleh di Langkah 2 bagian "Panggil Operasi API" dalam topik ini.
  Kode sampel berikut menunjukkan nilai parameter ClipsParam dalam respons:
```
{"1":"text","2":"mediaId","3":"mediaId","4":"mediaId","5":"mediaId"}
```
  Catatan
  Anda juga dapat menggunakan template preset. Metode penggunaannya serupa dengan metode sebelumnya untuk menggunakan template buatan pengguna dan tidak dijelaskan dalam topik ini. Untuk informasi lebih lanjut tentang template preset, lihat Template Reguler di Perpustakaan Template Publik.
Konfigurasikan bidang text dan mediaId dalam parameter ClipsParam berdasarkan kebutuhan bisnis Anda.
```
{
 "1": "Teks pengganti.",
 "2": "****20b48fb04483915d4f2cd8ac****",
 "3": "****20b48fb04483915d4f2cd8ac****",
 "4": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video1.mp4",
 "5": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video2.mp4"
}
```
Catatan
ClipsParam adalah parameter layanan produksi. Anda dapat mengganti bidang teks dengan teks tertentu dan bidang mediaId dengan ID aset media tertentu atau alamat penyimpanan Object Storage Service (OSS) dari video atau gambar sesuai kebutuhan bisnis. Dengan mengonfigurasi kedua bidang ini dalam permintaan layanan produksi, Anda dapat membuat video yang berisi teks dan elemen multimedia.

Panggil layanan produksi.

Panggil operasi SubmitMediaProducingJob untuk mengirimkan tugas pengeditan dan produksi, serta tentukan parameter TemplateId dan ClipsParam.

SubmitMediaProducingJobRequest request = new SubmitMediaProducingJobRequest();
request.setTemplateId("Your TemplateId");
request.setClipsParam("{\"1\":\"Teks pengganti.\",\"2\":\"****20b48fb04483915d4f2cd8ac****\",\"3\":\"****20b48fb04483915d4f2cd8ac****\",\"4\":\"****20b48fb04483915d4f2cd8ac****\",\"5\":\"****20b48fb04483915d4f2cd8ac****\"}");
request.setOutputMediaConfig("{\"MediaURL\":\"http://your-bucket.oss-cn-shanghai.aliyuncs.com/object.mp4\"}");
SubmitMediaProducingJobResponse response = iceClient.submitMediaProducingJob(request);
System.out.println("jobid : " + response.getBody().getJobId());