Tambahkan watermark gambar dan teks ke video - ApsaraVideo VOD

Watermark video menambahkan informasi identifikasi—seperti logo perusahaan, ikon stasiun TV, nama panggilan pengguna, atau ID pengguna—ke dalam video untuk mempromosikan merek, melindungi hak cipta, dan meningkatkan pengenalan merek. ApsaraVideo VOD mendukung tiga jenis watermark: gambar statis, gambar animasi, dan teks. Anda dapat memilih jenis yang paling sesuai dengan kebutuhan Anda.

Cara kerja

Fitur watermark video di ApsaraVideo VOD bekerja melalui proses transkoding. Selama proses ini, gambar atau teks "dibakar" ke dalam aliran video untuk menghasilkan file video baru yang telah diberi watermark.

Kasus penggunaan

Video pendek
Video pendek yang diunduh atau dibagikan biasanya menyertakan watermark gambar (logo produk) dan watermark teks (ID pengguna) untuk perlindungan hak cipta.
Situs web audio dan video
Situs web audio dan video sering menambahkan logo merek ke video untuk menegaskan kepemilikan hak cipta. Dalam acara varietas, stiker juga digunakan untuk menambah unsur hiburan atau meningkatkan eksposur iklan.

Jenis watermark

Jenis	Format yang didukung	Deskripsi
Image	Gambar statis: PNG Gambar animasi: GIF, APNG, MOV	Di Konsol ApsaraVideo VOD, Anda dapat membuat templat watermark untuk watermark dalam format PNG dan GIF. Dengan menggunakan API, Anda dapat membuat templat watermark untuk watermark dalam format PNG, GIF, APNG, dan MOV. Untuk watermark gambar animasi, ekstensi file `gif`, `apng`, dan `mov` harus ditulis dalam huruf kecil. Batasan ini tidak berlaku untuk gambar statis. File gambar watermark harus disimpan di bucket penyimpanan yang sama dengan video yang ingin diberi watermark. Misalnya, jika video disimpan di bucket penyimpanan ApsaraVideo VOD di wilayah China (Shanghai), file watermark juga harus disimpan di bucket yang sama. Watermark tidak dapat digunakan lintas wilayah atau lintas bucket penyimpanan. Untuk informasi lebih lanjut, lihat Manajemen penyimpanan. Anda dapat mengatur durasi tampilan watermark gambar agar muncul sepanjang video atau hanya selama periode tertentu.
Text	-	Anda dapat mengonfigurasi properti teks seperti font, ukuran font, warna, transparansi, dan efek stroke.

Penagihan

Watermarking video menggunakan transkoding, sehingga dikenai biaya transkoding. Untuk informasi lebih lanjut, lihat Penagihan transkoding media.

Cara menggunakan

Langkah 1: Buat templat watermark

Untuk menyederhanakan proses watermarking, ApsaraVideo VOD menyediakan templat watermark. Templat ini memungkinkan Anda mengonfigurasi parameter seperti posisi watermark, ukuran, serta font dan warna teks. Setiap templat watermark diidentifikasi oleh ID unik.

Konsol

Masuk ke Konsol ApsaraVideo VOD.
Di panel navigasi kiri, pilih Configuration Management > Media Processing > Watermarks.

Klik Create Watermark. Anda dapat mengonfigurasi watermark gambar atau teks sesuai kebutuhan.

Watermark gambar

Parameter	Deskripsi
Watermark Type	Pilih Image.
Image	Unggah gambar watermark. Catatan Konsol hanya mendukung format PNG dan GIF. Ukuran gambar tidak boleh melebihi 20 MB.
Watermark Name	Masukkan nama untuk templat watermark. Catatan Nama dapat berisi karakter Tionghoa dan Inggris, angka, `#`, dan `-`.
Size (Width × Height)	Ukuran gambar watermark. Untuk informasi lebih lanjut, lihat Detail parameter posisi dan ukuran watermark. Bilangan bulat positif dalam piksel. Nilai valid: [8, 4096]. Persentase dari dimensi video. Satuan: %. Nilai valid: (0, 100). Nilai dapat akurat hingga dua tempat desimal. Catatan Jika Anda hanya menentukan lebar atau tinggi gambar watermark, dimensi lainnya akan diskalakan secara proporsional berdasarkan rasio aspek asli gambar.
Position	Posisi titik referensi watermark relatif terhadap video output. Nilai default: Upper-right. Untuk informasi lebih lanjut, lihat Detail parameter posisi dan ukuran watermark. Nilai valid: Upper-left Lower-left Upper-right Lower-right
Horizontal Shift	Offset horizontal watermark pada video output. Untuk informasi lebih lanjut, lihat Detail parameter posisi dan ukuran watermark. Bilangan bulat positif dalam piksel. Nilai valid: [8, 4096]. Persentase dari dimensi video. Satuan: %. Nilai valid: (0, 100). Nilai dapat akurat hingga dua tempat desimal.
Vertical Shift	Offset vertikal watermark pada video output. Untuk informasi lebih lanjut, lihat Detail parameter posisi dan ukuran watermark. Bilangan bulat positif dalam piksel. Nilai valid: [8, 4096]. Persentase dari dimensi video. Satuan: %. Nilai valid: (0, 100). Nilai dapat akurat hingga dua tempat desimal.
Timeline	Pengaturan timeline mengontrol waktu mulai dan durasi watermark gambar. Anda dapat menggunakan beberapa konfigurasi watermark untuk menciptakan efek dinamis. Catatan Parameter ini tidak didukung untuk watermark teks.
Preview Screen Size (Width × Height)	Masukkan dimensi video aktual Anda untuk melihat pratinjau posisi dan efek watermark. Satuan: piksel.

Watermark teks

Parameter	Deskripsi
Watermark Type	Pilih Text.
Watermark Content	Masukkan teks yang ingin Anda gunakan sebagai watermark.
Watermark Name	Masukkan nama untuk templat watermark. Catatan Nama dapat berisi huruf, angka, `#`, dan `-`.
Font	Font teks watermark. Nilai valid: SimSun WenQuanYi Zen Hei WenQuanYi Zen Hei Mono WenQuanYi Zen Hei Sharp Yuanti SC
Font Size	Ukuran font teks watermark, dalam piksel.
Transparency	Transparansi teks watermark. Nilai yang lebih kecil menunjukkan transparansi yang lebih besar. Nilai dapat akurat hingga dua tempat desimal. Nilai valid: (0, 1].
Font Color	Tentukan warna teks watermark.
Stroke Width	Lebar stroke font, dalam piksel. Nilai valid: (0, 4096].
Stroke Color	Tentukan warna stroke font.
Vertical Shift	Offset vertikal teks watermark pada video output. Untuk informasi lebih lanjut, lihat Detail parameter posisi dan ukuran watermark. Bilangan bulat positif dalam piksel. Nilai valid: [8, 4096].
Horizontal Shift	Offset horizontal teks watermark pada video output. Untuk informasi lebih lanjut, lihat Detail parameter posisi dan ukuran watermark. Bilangan bulat positif dalam piksel. Nilai valid: [8, 4096].
Preview Screen Size	Masukkan dimensi video aktual Anda untuk melihat pratinjau posisi dan efek teks watermark. Satuan: piksel.

Klik Save.
Setelah dibuat, templat watermark beserta ID-nya akan terlihat di halaman Watermarks.

API

Panggil operasi AddWatermark untuk membuat templat watermark. ID templat watermark akan dikembalikan setelah templat berhasil dibuat.

Catatan

Saat menggunakan API untuk membuat templat watermark gambar, Anda harus terlebih dahulu memanggil operasi CreateUploadAttachedMedia untuk mengunggah gambar watermark ke ApsaraVideo VOD. Untuk informasi lebih lanjut tentang cara mengunggah file, lihat Unggah file media menggunakan API ApsaraVideo VOD.

Posisi dan ukuran

Watermark gambar

Anda dapat menggunakan parameter ReferPos, Dx, Dy, Width, dan Height untuk mengontrol posisi dan ukuran gambar pada video output.

Parameter API	Parameter Konsol	Deskripsi
ReferPos	Position	Titik referensi watermark relatif terhadap video output. Sudut kiri atas: TopLeft Sudut kiri bawah: BottomLeft Sudut kanan atas: TopRight Sudut kanan bawah: BottomRight
Dx	Horizontal Shift	Offset horizontal watermark pada video output. Nilai valid: Bilangan bulat positif dalam piksel. Nilai valid: [8, 4096]. Desimal yang merepresentasikan persentase dari lebar video. Nilai valid: (0, 1).
Dy	Vertical Shift	Offset vertikal watermark pada video output. Nilai valid: Bilangan bulat positif dalam piksel. Nilai valid: [8, 4096]. Desimal yang merepresentasikan persentase dari tinggi video. Nilai valid: (0, 1).
Width	Size (Width)	Lebar watermark pada video output. Nilai valid: Bilangan bulat positif dalam piksel. Nilai valid: [8, 4096]. Desimal yang merepresentasikan persentase dari lebar video. Nilai valid: (0, 1).
Height	Size (Height)	Tinggi watermark pada video output. Nilai valid: Bilangan bulat positif dalam piksel. Nilai valid: [8, 4096]. Desimal yang merepresentasikan persentase dari tinggi video. Nilai valid: (0, 1).
Timeline	Timeline	Pengaturan timeline mengontrol waktu mulai dan durasi watermark gambar. Anda dapat menggunakan beberapa konfigurasi watermark untuk menciptakan efek dinamis. Untuk informasi lebih lanjut, lihat Timeline watermark. Penting Parameter ini tidak didukung untuk watermark teks.

Diagram

Untuk memposisikan watermark di tengah, atur parameter Dx dan Dy menjadi 0,5. Hal ini mengatur offset menjadi 50% dari lebar dan tinggi video output. 图片水印位置

Watermark teks

Posisi watermark teks relatif terhadap sudut kiri atas video output. Offset ditentukan oleh parameter Top dan Left. Parameter ini hanya menerima nilai piksel dan tidak mendukung nilai berbasis persentase.

Parameter API	Parameter Konsol	Deskripsi
Top	Vertical Shift	Jarak dari tepi atas video output ke watermark teks. Satuan: piksel. Nilai valid: [8, 4096].
Left	Horizontal Shift	Jarak dari tepi kiri video output ke watermark teks. Satuan: piksel. Nilai valid: [8, 4096].

Diagram 文字水印

Metode perhitungan
Untuk watermark gambar, parameter Dx, Dy, Width, dan Height dapat ditentukan sebagai bilangan bulat positif (piksel) atau desimal (persentase). Untuk watermark teks, parameter Top dan Left hanya menerima bilangan bulat positif.
- Bilangan bulat positif: Nilai dalam piksel. Nilai valid: [8, 4096].
  Penting
  Jika nilai parameter yang ditentukan melebihi dimensi video output, watermark mungkin sebagian atau seluruhnya tidak terlihat.
  Contohnya, jika resolusi video output adalah 640×360, posisi referensi adalah TopLeft, Dx adalah 4000, dan Dy adalah 4000, maka watermark tidak akan terlihat pada video output. Hal ini juga berlaku untuk watermark teks.
- Persentase: Nilai relatif terhadap lebar atau tinggi resolusi video output. Nilai harus berupa desimal dalam rentang (0, 1) dengan maksimal empat tempat desimal.
  Penting
  Jika rasio aspek video output bersifat variabel atau tidak dapat diprediksi, kami menyarankan Anda mengatur parameter posisi dan ukuran watermark menggunakan persentase.
  Contoh: 0,9999. Contoh perhitungan: Width / Lebar Video = 0,1, Height / Tinggi Video = 0,06, Dx / Lebar Video = 0,02, dan Dy / Tinggi Video = 0,03.
Nilai default
- Jika Anda menghilangkan lebar dan tinggi, lebar watermark secara default menjadi 12% dari lebar video output, dan tinggi diskalakan secara proporsional berdasarkan rasio aspek gambar watermark asli.
- Jika Anda hanya menentukan lebar atau tinggi: Dimensi yang ditentukan digunakan, dan dimensi lainnya diskalakan secara proporsional berdasarkan rasio aspek gambar watermark asli. Misalnya, jika Anda mengatur Width menjadi 44 dan rasio aspek asli adalah 2:1, maka Height akan menjadi 22.
- Jika Anda menentukan kedua dimensi (lebar dan tinggi): Dimensi watermark diatur sesuai nilai yang ditentukan.
- Jika Anda tidak menentukan Dx dan Dy, nilai default-nya adalah 0.

Langkah 2: Buat dan kaitkan kelompok template transkoding

Watermarking video diimplementasikan melalui transkoding. Tugas transkoding diinisiasi berdasarkan kelompok template transkoding. Anda dapat mengaitkan beberapa templat watermark ke satu template transkoding.

Konsol

Masuk ke Konsol ApsaraVideo VOD.
Di panel navigasi kiri, pilih Configuration Management > Media Processing > Transcoding Template Groups.
Klik Create Transcoding Template Group.
Tentukan nama untuk kelompok template transkoding.
Di bagian Regular Transcoding Template atau Packaging Template, klik Add Template, konfigurasi parameter transkoding, dan aktifkan watermarking.
- Watermark Template: Pilih satu atau beberapa templat watermark yang telah Anda buat di Langkah 1.
- Biarkan parameter lain pada nilai default atau ubah sesuai kebutuhan bisnis Anda. Untuk informasi lebih lanjut tentang parameter dan saran konfigurasi, lihat Template transkoding.
Klik Save untuk membuat kelompok template transkoding.
Setelah kelompok template transkoding dibuat, Anda dapat melihat kelompok tersebut beserta ID-nya di halaman Kelompok Template Transkoding.

API

Panggil API CreateTranscodeTemplateGroup untuk membuat kelompok template transkoding. Di parameter TranscodeTemplateList, masukkan ID templat watermark di parameter WatermarkIds untuk mengaitkan templat watermark.

Langkah 3 (Opsional): Buat dan kaitkan alur kerja

Anda dapat mengatur berbagai tugas pemrosesan media—seperti transkoding, peninjauan konten, dan pembuatan snapshot—ke dalam sebuah alur kerja. Saat Anda memicu alur kerja selama pengunggahan atau pemrosesan media, file media akan diproses secara otomatis sesuai tugas yang telah ditentukan. Anda hanya dapat membuat alur kerja di konsol. Untuk informasi lebih lanjut, lihat Alur kerja.

Konsol

Masuk ke Konsol ApsaraVideo VOD.
Di panel navigasi kiri, pilih Configuration Management > Media Processing > Workflows.
Klik Add Workflow.
Masukkan nama untuk alur kerja.
Tambahkan atau edit node dalam topologi alur kerja.
Sebagai contoh, untuk menambahkan node Transcode , pada node Start, klik + lalu pilih Transcode . Klik tombol edit pada node Transcode , sesuaikan Node Name sesuai kebutuhan, dan atur Transcoding Template Groups ke kelompok template transkoding yang telah Anda buat di Langkah 2 dan telah dikaitkan dengan templat watermark.
Klik OK untuk membuat alur kerja.
Setelah alur kerja dibuat, Anda dapat melihat alur kerja tersebut beserta ID-nya di halaman Alur Kerja.

Langkah 4 (Opsional): Konfigurasi notifikasi event

Kami menyarankan Anda mengonfigurasi notifikasi event untuk ApsaraVideo VOD sebelum memulai tugas transkoding. Hal ini memungkinkan Anda menerima pesan callback yang berisi status dan hasil tugas tersebut. Untuk informasi tentang cara mengonfigurasi notifikasi event, lihat Notifikasi event.

Berikut adalah jenis notifikasi event yang terkait dengan transkoding:

Langkah 5: Mulai tugas watermarking

Anda dapat memicu transkoding di ApsaraVideo VOD selama pengunggahan atau pemrosesan media. Anda dapat memulai transkoding menggunakan kelompok template transkoding atau alur kerja yang berisi node transkoding media.

Konsol

Skenario 1: Secara otomatis memicu tugas watermarking selama pengunggahan

Masuk ke Konsol ApsaraVideo VOD.
Di panel navigasi sebelah kiri, pilih Media Files > Audio/Video.
Klik Upload Audio/Video, klik Add Audio/Video, pilih parameter seperti metode pengunggahan dan alamat penyimpanan, lalu pilih Use Transcoding Template Group dan tentukan kelompok template transkoding dengan watermarking yang telah Anda buat di Langkah 2. Atau, pilih Use Workflow dan tentukan alur kerja dengan node transkoding yang telah diaktifkan watermarking-nya yang telah Anda buat di Langkah 3.
Untuk informasi lebih lanjut tentang format yang didukung dan deskripsi parameter pengunggahan, lihat Unggah file menggunakan Konsol ApsaraVideo VOD.
Tambahkan video yang akan diunggah lalu klik Upload.
Setelah video diunggah, video tersebut akan secara otomatis ditranskode berdasarkan kelompok template transkoding atau alur kerja yang telah Anda tentukan.

Skenario 2: Secara manual memicu tugas watermarking untuk video yang telah diunggah

Masuk ke Konsol ApsaraVideo VOD.
Di panel navigasi kiri, pilih File Media > Audio/Video.
Di halaman Audio/Video, temukan video yang ingin Anda transkode lalu klik Processing di kolom Actions.
Pilih Use Transcoding Template Group dan tentukan kelompok template transkoding dengan watermarking yang telah Anda buat di Langkah 2. Atau, pilih Use Workflow dan tentukan alur kerja dengan node transkoding yang telah diaktifkan watermarking-nya yang telah Anda buat di Langkah 3.
Klik OK.

API

Skenario 1: Secara otomatis memicu tugas watermarking selama pengunggahan

Catatan

Operasi CreateUploadVideo hanya mendapatkan URL pengunggahan, kredensial, dan informasi dasar aset media. Operasi ini tidak mengunggah file itu sendiri; Anda harus mengimplementasikan logika pengunggahan. Untuk contoh lengkap cara mengunggah file menggunakan API, lihat Unggah file media menggunakan API ApsaraVideo VOD.

Saat Anda memanggil API Dapatkan alamat dan kredensial pengunggahan audio/video atau API tarik dan unggah batch dari URL untuk mengunggah file audio/video, atur parameter TemplateGroupId ke ID kelompok template transkoding dengan watermark gambar dan teks yang telah Anda buat di Langkah 2, atau atur parameter WorkflowId ke ID alur kerja yang berisi node transkoding media dengan watermark gambar dan teks yang telah Anda buat di Langkah 3. Setelah file audio/video diunggah, sistem VOD akan secara otomatis mentranskode file tersebut berdasarkan kelompok template transkoding atau alur kerja yang telah ditentukan.

Skenario 2: Secara manual memicu tugas watermarking untuk video yang telah diunggah

Memulai transkoding menggunakan kelompok template transkoding: Panggil API Kirim pekerjaan transkoding media dan atur parameter TemplateGroupId ke ID kelompok template transkoding yang telah dibuat di Langkah 2 dan telah diaktifkan watermarking gambar-teks-nya.
Untuk memulai pekerjaan transkoding menggunakan alur kerja, panggil API Kirim pekerjaan alur kerja VOD dan atur parameter WorkflowId ke ID alur kerja dari Langkah 3 yang berisi node transkoding media dengan watermark gambar dan teks yang telah diaktifkan.

Langkah 6: Lihat hasilnya

Terima notifikasi asinkron

Jika Anda telah mengonfigurasi notifikasi event, Anda dapat memperoleh informasi tentang tugas watermarking dan transkoding dengan menerima pesan callback untuk StreamTranscodeComplete atau TranscodeComplete.

Lakukan kueri sinkron

Gunakan konsol

Masuk ke Konsol ApsaraVideo VOD.
Di panel navigasi kiri, pilih File Media > Audio/Video.
Di halaman Audio/Video, lihat Status video target.
Jika Status video adalah Normal, tugas watermarking dan transkoding telah berhasil diselesaikan.
Klik Manage pada baris tempat video berada untuk membuka halaman informasi dasar.
Klik tab Video URL. Di tab ini, Anda dapat melihat aliran yang telah dikodekan ulang dari video dan mendapatkan URL pemutarnya.

Gunakan API

Anda dapat memeriksa status eksekusi dan hasil tugas transkoding dengan polling menggunakan ID tugas. Gunakan operasi berikut untuk tujuan ini:

Contoh penggunaan

Bagian ini menjelaskan cara mengonfigurasi watermark untuk kasus penggunaan umum dengan memanfaatkan kemampuan ApsaraVideo VOD untuk mengatur beberapa watermark dan mengganti konten watermark secara dinamis menggunakan API.

Watermark teks dinamis

Skenario

Dalam aplikasi video pendek, saat pengguna mengunduh atau membagikan video milik pengguna lain, video tersebut biasanya menyertakan logo platform video pendek dan ID atau nama panggilan kreator asli.

Hasil yang diharapkan

Watermark gambar dan watermark teks ditambahkan. Konten watermark teks berbeda untuk setiap pengguna.

文字水印特效

Prosedur

Buat dua templat watermark: satu templat watermark gambar dengan logo platform video pendek sebagai gambar watermark, dan satu templat watermark teks dengan ID atau nama panggilan kreator asli sebagai teks watermark. Untuk informasi lebih lanjut, lihat Langkah 1: Buat templat watermark.
Buat kelompok template transkoding dan kaitkan kedua templat watermark yang dibuat pada langkah sebelumnya. Untuk informasi lebih lanjut, lihat Langkah 2: Buat dan kaitkan kelompok template transkoding.
Anda dapat mengganti konten teks dari templat watermark tertentu dengan memanggil API Kirim Pekerjaan Transkoding Media dan meneruskan WatermarkId dan Content di parameter OverrideParams.
- Contoh penerusan parameter untuk OverrideParams: {"Watermarks":[{"WatermarkId":"ID templat watermark gambar"},{"WatermarkId":"ID templat watermark teks","Content":"Konten teks watermark"}]}
- Anda perlu merancang logika pemicu tugas transkoding berdasarkan kebutuhan bisnis Anda. Misalnya, Anda dapat memicu transkoding saat pengguna mengunggah video dan secara otomatis mengganti konten watermark teks dengan ID atau nama panggilan kreator asli.

Watermark gambar dinamis

Skenario

Situs web video memperoleh hak cipta utama untuk film atau acara TV, lalu memberikan sublisensi kepada situs web video lain. Dalam skenario ini, video yang didistribusikan di setiap situs web harus menampilkan logo merek situs web tersebut.

Hasil yang diharapkan

Watermark gambar digunakan, dan berbeda untuk setiap situs web video.

Prosedur

Panggil operasi CreateUploadAttachedMedia untuk mengunggah gambar watermark (logo merek masing-masing situs web video) ke ApsaraVideo VOD. Untuk informasi lebih lanjut tentang cara mengunggah file, lihat Unggah file media menggunakan API ApsaraVideo VOD.
Buat templat watermark gambar dan atur logo merek situs web video sebagai gambar watermark. Untuk informasi lebih lanjut, lihat Langkah 1: Buat templat watermark.
Buat kelompok template transkoding dan kaitkan templat watermark gambar yang dibuat pada langkah sebelumnya. Untuk informasi lebih lanjut, lihat Langkah 2: Buat dan kaitkan kelompok template transkoding.
Dengan memanggil API Kirim Pekerjaan Transkoding Media dan meneruskan WatermarkId dan FileUrl di parameter OverrideParams, Anda dapat mengganti gambar watermark dari templat watermark tertentu.
- Contoh parameter OverrideParams: {"Watermarks":{"WatermarkId":"Ganti dengan ID templat watermark gambar","FileUrl":"Ganti dengan URL gambar watermark pengganti"}}
- Anda perlu merancang logika pemicu tugas transkoding berdasarkan kebutuhan bisnis Anda. Misalnya, Anda dapat memicu transkoding saat video diunggah.

FAQ

Galat "Invalid image URL" saat menambahkan watermark

Jika Anda telah mengonfigurasi nama domain yang dipercepat di ApsaraVideo VOD, Anda harus mengonfigurasi sertifikat SSL untuk nama domain tersebut. Untuk informasi lebih lanjut, lihat Aktifkan Percepatan aman HTTPS.

Dokumen terkait

Untuk menampilkan nama panggilan atau ID pengguna secara real-time selama pemutaran sebagai pencegah pelanggaran, gunakan fitur teks berjalan dari SDK Pemutar Video Apsara. Untuk informasi lebih lanjut, lihat Komponen resmi.