Watermarking video menambahkan informasi identifikasi ke dalam video, seperti logo perusahaan, ikon stasiun TV, nickname pengguna, atau ID pengguna. Watermarking membantu memperkuat branding, melindungi hak cipta, serta meningkatkan pengenalan produk. ApsaraVideo VOD mendukung tiga jenis watermark: gambar statis, gambar animasi, dan teks. Anda dapat memilih jenis yang paling sesuai dengan kebutuhan Anda.
Cara kerja
Watermarking di ApsaraVideo VOD dilakukan selama proses transcoding. Informasi seperti gambar dan teks disematkan ke dalam aliran video, menghasilkan file video baru yang berisi watermark.
Skenario penggunaan
Video pendek
Pada aplikasi video pendek, video yang diunduh dan dibagikan biasanya memiliki watermark gambar, seperti logo produk, dan watermark teks, seperti ID pengguna, untuk melindungi hak cipta.
Situs web audio dan video
Situs web audio dan video sering menambahkan logo merek ke video sebagai penanda kepemilikan hak cipta. Pada acara varietas, stiker juga ditambahkan untuk meningkatkan keterlibatan penonton atau menampilkan iklan.
Jenis watermark
Jenis | Format yang didukung | Petunjuk |
Image | | Buat templat watermark untuk file PNG dan GIF di Konsol. Buat templat watermark untuk file PNG, GIF, APNG, dan MOV dengan memanggil OpenAPI. Watermark animasi dibatasi oleh ekstensi nama file. Ekstensi gif, apng, dan mov harus menggunakan huruf kecil. Gambar statis tidak dibatasi oleh ekstensi nama file. File watermark harus disimpan di bucket yang sama dengan video yang akan diberi watermark. Misalnya, jika video disimpan di bucket ApsaraVideo VOD di wilayah China (Shanghai), file watermark juga harus disimpan di bucket ApsaraVideo VOD di wilayah China (Shanghai). Penyimpanan cross-region dan cross-bucket tidak didukung. Untuk informasi lebih lanjut tentang bucket penyimpanan, lihat Manajemen penyimpanan. Tentukan durasi tampilan watermark gambar. Hal ini memungkinkan Anda menampilkan watermark dari awal hingga akhir video, atau hanya selama periode tertentu.
|
Text | - | Tentukan font, ukuran font, warna, opasitas, dan efek outline untuk teks. |
Penagihan
Watermarking didasarkan pada transcoding, dan proses transcoding dikenai biaya. Untuk informasi lebih lanjut tentang penagihan, lihat Penagihan transcoding media.
Cara menggunakan
Langkah 1: Buat templat watermark
Untuk menyederhanakan proses watermarking, ApsaraVideo VOD menggunakan templat untuk menyimpan parameter watermark yang kompleks, seperti posisi, ukuran, font, dan warna. Setiap templat memiliki ID unik.
Menggunakan Konsol
Masuk ke Konsol ApsaraVideo VOD.
Pada panel navigasi sebelah kiri, pilih Configuration Management > Media Processing > Watermarks.
Klik Create Watermark. Atur parameter untuk watermark gambar atau teks.
Parameter watermark gambar
Parameter | Deskripsi |
Watermark Type | Pilih Image. |
Watermark Material | Unggah gambar watermark.
Catatan Konsol hanya mendukung file PNG dan GIF dengan ukuran maksimal 20 MB. |
Watermark Name | Masukkan nama untuk templat watermark.
Catatan Nama dapat berisi karakter Tionghoa, huruf Inggris, angka, tanda pagar (#), dan tanda hubung (-). |
Size (Width × Height) | Tentukan ukuran gambar watermark. Untuk informasi lebih lanjut, lihat Detail parameter posisi dan ukuran watermark. Bilangan bulat positif: Satuan dalam piksel. Nilai harus berupa bilangan bulat antara 8 hingga 4096. Persentase video: Satuan dalam %. Nilai dapat berupa angka dari 0 hingga 100, akurat hingga dua tempat desimal.
Catatan Jika Anda hanya mengatur lebar atau tinggi gambar watermark, dimensi lainnya akan diskalakan berdasarkan rasio aspek gambar sumber. |
Position | Posisi perkiraan gambar watermark relatif terhadap video output. Nilai default adalah TopRight. Parameter ini menentukan posisi awal watermark. Untuk informasi lebih lanjut, lihat Detail parameter posisi dan ukuran watermark. Nilai yang valid: TopLeft BottomLeft TopRight BottomRight
|
Horizontal offset | Offset horizontal gambar watermark dalam video output. Untuk informasi lebih lanjut, lihat Detail parameter posisi dan ukuran watermark. Bilangan bulat positif: Satuan dalam piksel. Nilai harus berupa bilangan bulat antara 8 hingga 4096. Persentase video: Satuan dalam %. Nilai dapat berupa angka dari 0 hingga 100, akurat hingga dua tempat desimal.
|
Vertical offset | Offset vertikal gambar watermark dalam video output. Untuk informasi lebih lanjut, lihat Detail parameter posisi dan ukuran watermark. Bilangan bulat positif: Satuan dalam piksel. Nilai harus berupa bilangan bulat antara 8 hingga 4096. Persentase video: Satuan dalam %. Nilai dapat berupa angka dari 0 hingga 100, akurat hingga dua tempat desimal.
|
Timeline | Timeline watermark mengontrol waktu mulai dan durasi tampilan watermark gambar dalam video. Anda dapat mengonfigurasi beberapa watermark untuk menciptakan efek tampilan dinamis.
Catatan Parameter ini tidak didukung untuk watermark teks. |
Preview video size (Width × Height) | Masukkan dimensi video aktual Anda untuk melihat pratinjau posisi dan efek watermark. Satuan dalam piksel. |
Parameter watermark teks
Parameter | Deskripsi |
Watermark Type | Pilih Text. |
Watermark Content | Masukkan teks yang akan digunakan sebagai watermark. |
Watermark Name | Masukkan nama untuk templat watermark.
Catatan Nama dapat berisi karakter Tionghoa, huruf Inggris, angka, tanda pagar (#), dan tanda hubung (-). |
Font | Font teks watermark. Nilai yang valid: |
Font size | Ukuran font teks watermark. Satuan dalam piksel. |
Transparency | Opasitas teks watermark. Nilai yang lebih kecil menunjukkan transparansi yang lebih tinggi. Nilai harus berupa angka dari 0 hingga 1, tidak termasuk 0, akurat hingga dua tempat desimal. |
Font color | Tentukan warna font teks watermark. |
Outline width | Lebar outline font. Satuan dalam piksel. Nilai harus berupa angka dari 0 hingga 4096, tidak termasuk 0. |
Outline color | Tentukan warna outline font. |
Vertical offset | Offset vertikal teks watermark dalam video output. Untuk informasi lebih lanjut, lihat Detail parameter posisi dan ukuran watermark. Bilangan bulat positif: Satuan dalam piksel. Nilai harus berupa bilangan bulat antara 8 hingga 4096. |
Horizontal offset | Offset horizontal teks watermark dalam video output. Untuk informasi lebih lanjut, lihat Detail parameter posisi dan ukuran watermark. Bilangan bulat positif: Satuan dalam piksel. Nilai harus berupa bilangan bulat antara 8 hingga 4096. |
Preview video size | Masukkan dimensi video aktual Anda untuk melihat pratinjau posisi dan efek teks watermark. Satuan dalam piksel. |
Klik Save untuk menyelesaikan konfigurasi.
Setelah templat watermark dibuat, Anda dapat melihat templat dan ID-nya di halaman Watermark Templates.
Menggunakan OpenAPI
Panggil operasi AddWatermarkTemplate untuk membuat templat watermark. Setelah templat dibuat, operasi tersebut akan mengembalikan ID templat.
Detail parameter posisi dan ukuran watermark
Watermark Gambar
Gunakan parameter ReferPos, Dx, Dy, Width, dan Height untuk mengontrol posisi tampilan dan ukuran gambar dalam video output.
Parameter API | Parameter Konsol | Deskripsi |
ReferPos | Position | Posisi perkiraan watermark relatif terhadap video output. Sudut kiri atas: TopLeft Sudut kiri bawah: BottomLeft Sudut kanan atas: TopRight Sudut kanan bawah: BottomRight
|
Dx | Horizontal offset | Offset horizontal watermark dalam video output. Nilai yang valid: Bilangan bulat positif. Satuan dalam piksel. Nilai harus berupa bilangan bulat antara 8 hingga 4096. Persentase video. Satuan dalam %. Nilai harus berupa angka dari 0 hingga 1, tidak termasuk 0.
|
Dy | Vertical offset | Offset vertikal watermark dalam video output. Nilai yang valid: Bilangan bulat positif. Satuan dalam piksel. Nilai harus berupa bilangan bulat antara 8 hingga 4096. Persentase video. Satuan dalam %. Nilai harus berupa angka dari 0 hingga 1, tidak termasuk 0.
|
Width | Size (Width) | Lebar watermark dalam video output. Nilai yang valid: Bilangan bulat positif. Satuan dalam piksel. Nilai harus berupa bilangan bulat antara 8 hingga 4096. Persentase video. Satuan dalam %. Nilai harus berupa angka dari 0 hingga 1, tidak termasuk 0.
|
Height | Size (Height) | Tinggi watermark dalam video output. Nilai yang valid: Bilangan bulat positif. Satuan dalam piksel. Nilai harus berupa bilangan bulat antara 8 hingga 4096. Persentase video. Satuan dalam %. Nilai harus berupa angka dari 0 hingga 1, tidak termasuk 0.
|
Timeline | Timeline | Timeline watermark. Parameter ini menentukan waktu mulai dan durasi tampilan watermark gambar dalam video. Anda dapat mengonfigurasi beberapa watermark untuk menciptakan efek tampilan dinamis pada watermark gambar. Untuk informasi lebih lanjut, lihat Timeline watermark.
Penting Parameter ini tidak didukung untuk watermark teks. |
Diagram
Untuk menempatkan watermark di tengah, atur parameter Dx dan Dy menjadi 0,5. Hal ini mengatur offset watermark menjadi 50% dari lebar dan tinggi video output.
Watermark teks
Watermark teks hanya dapat di-offset dari sudut kiri atas video output. Parameter Top dan Left digunakan untuk offset tersebut. Hanya nilai piksel yang didukung; nilai persentase tidak didukung.
Parameter API | Parameter Konsol | Deskripsi |
Top | Vertical offset | Jarak antara watermark teks dan bagian atas video output. Satuan dalam piksel. Nilai harus berupa bilangan bulat antara 8 hingga 4096. |
Left | Horizontal offset | Jarak antara watermark teks dan sisi kiri video output. Satuan dalam piksel. Nilai harus berupa bilangan bulat antara 8 hingga 4096. |
Diagram
Metode perhitungan
Parameter Dx, Dy, Width, dan Height untuk watermark gambar mendukung nilai piksel dan persentase. Parameter Top dan Left untuk watermark teks hanya mendukung nilai piksel. Detailnya sebagai berikut:
Nilai piksel: Bilangan bulat antara 8 hingga 4096. Satuan dalam piksel.
Penting Jika nilai yang ditentukan melebihi ukuran video output, watermark mungkin hanya sebagian yang ditampilkan atau tidak ditampilkan sama sekali.
Sebagai contoh, jika video output berukuran 640 × 360 piksel, posisi referensi adalah TopLeft, dan Anda mengatur Dx dan Dy menjadi 4000, maka watermark tidak akan terlihat dalam video output. Hal ini juga berlaku untuk watermark teks.
Nilai persentase: Nilai merupakan persentase dari lebar dan tinggi video output. Nilai harus berupa angka lebih besar dari 0 hingga maksimal 1, akurat hingga empat tempat desimal.
Penting Jika rasio aspek video output bersifat variabel dan tidak dapat dikontrol, atur parameter posisi dan ukuran watermark sebagai persentase.
Sebagai contoh, 0,9999. Contoh perhitungan: Lebar/Lebar video = 0,1. Tinggi/Tinggi video = 0,06. Dx/Lebar video = 0,02. Dy/Tinggi video = 0,03.
Nilai default
Jika Anda tidak mengatur lebar dan tinggi watermark: Lebar watermark diatur menjadi 12% dari lebar video output. Tinggi watermark diskalakan untuk mempertahankan rasio aspek gambar watermark sumber.
Jika Anda hanya mengatur lebar atau tinggi: Dimensi yang ditentukan digunakan. Dimensi lainnya diskalakan untuk mempertahankan rasio aspek gambar watermark sumber. Sebagai contoh, jika Anda mengatur Width menjadi 44 dan rasio aspek gambar sumber adalah 2:1, maka tinggi diatur menjadi 22.
Jika Anda mengatur lebar dan tinggi: Dimensi yang ditentukan digunakan untuk watermark.
Jika Anda tidak mengatur Dx dan Dy: Nilai default 0 digunakan.
Langkah 2: Buat kelompok template transkoding dan kaitkan templat watermark
Watermarking video didasarkan pada transcoding. Pekerjaan transcoding diinisiasi berdasarkan kelompok template transkoding. Anda dapat mengaitkan beberapa templat watermark ke satu template transcoding.
Menggunakan Konsol
Masuk ke Konsol ApsaraVideo VOD.
Pada panel navigasi sebelah kiri, pilih Configuration Management > Media Processing > Transcoding Template Groups.
Klik Create Transcoding Template Group. Halaman Add Transcoding Template Group akan muncul.
Tentukan nama untuk kelompok template transkoding.
Pada area Audio and Video Transcoding Template atau Audio and Video Packaging Template di sebelah kiri, klik Add Template. Anda kemudian dapat mengonfigurasi parameter transcoding dan mengaktifkan watermark gambar dan teks.
Watermark Template: Pilih satu atau beberapa templat watermark yang telah Anda buat di Langkah 1.
Pertahankan nilai default untuk parameter lain atau ubah sesuai kebutuhan. Untuk informasi lebih lanjut tentang parameter dan saran konfigurasi, lihat Template transkoding.
Anda dapat mengklik Save untuk membuat kelompok template transkoding.
Setelah kelompok template transkoding dibuat, Anda dapat melihat kelompok tersebut dan ID-nya di halaman Transcoding Template Groups.
Menggunakan OpenAPI
Panggil operasi AddTranscodeTemplateGroup untuk membuat kelompok template transkoding. Dalam parameter TranscodeTemplateList, tentukan parameter WatermarkIds untuk mengaitkan ID templat watermark.
Langkah 3 (Opsional): Buat alur kerja dan kaitkan kelompok template transkoding
Alur kerja memungkinkan Anda mengatur tugas pemrosesan media, seperti transcoding, moderasi konten, dan snapshot, dalam urutan tertentu. Saat Anda mengunggah file media atau memicu alur kerja, file media tersebut secara otomatis diproses berdasarkan alur tugas yang telah ditentukan. Anda hanya dapat membuat alur kerja di Konsol ApsaraVideo VOD. Untuk informasi lebih lanjut, lihat Alur kerja.
Menggunakan Konsol
Masuk ke Konsol ApsaraVideo VOD.
Pada panel navigasi sebelah kiri, pilih Configuration Management > Media Processing > Workflows.
Klik Add Workflow Template. Halaman Add Workflow akan ditampilkan.
Masukkan nama untuk alur kerja.
Tambahkan atau edit node alur kerja dalam topologi alur kerja.
Sebagai contoh, untuk menambahkan node Transcode
, klik + di sebelah node Start dan pilih Transcode
. Klik ikon edit pada node Transcode
. Sesuaikan Node Name. Dari daftar Transcoding Template Groups, pilih kelompok template transkoding yang telah Anda buat di Langkah 2.
Klik OK untuk membuat alur kerja.
Setelah alur kerja dibuat, Anda dapat melihat alur kerja tersebut dan ID-nya di halaman Workflow Management.
Langkah 4 (Opsional): Konfigurasi notifikasi event transcoding
Sebelum memulai pekerjaan transcoding, Anda dapat mengonfigurasi notifikasi event untuk ApsaraVideo VOD. Hal ini memungkinkan Anda menerima pesan callback yang berisi status dan hasil pekerjaan transcoding setelah selesai. Untuk informasi lebih lanjut tentang cara mengonfigurasi notifikasi event, lihat Notifikasi event.
Jenis notifikasi event berikut terkait dengan transcoding:
Langkah 5: Mulai pekerjaan transcoding watermarking
ApsaraVideo VOD memungkinkan Anda memicu transcoding saat mengunggah media atau memproses media. Anda dapat memulai transcoding berdasarkan kelompok template transkoding atau alur kerja yang berisi node transcoding media.
Menggunakan Konsol
Skenario 1: Secara otomatis memicu pekerjaan watermarking saat mengunggah
Masuk ke Konsol ApsaraVideo VOD.
Pada panel navigasi sebelah kiri, pilih Media Files > Audio/Video.
Klik Upload Audio/Video, klik Add Audio/Video, dan pilih parameter seperti metode unggah dan alamat penyimpanan. Kemudian, untuk pemrosesan media, pilih Use Transcoding Template Group dan tentukan kelompok template transkoding yang telah Anda buat di Langkah 2, atau pilih Use Workflow dan tentukan alur kerja yang telah Anda buat di Langkah 3.
Untuk informasi lebih lanjut tentang format yang didukung dan deskripsi parameter unggahan, lihat Unggah file di Konsol ApsaraVideo VOD.
Setelah menambahkan video, klik Upload.
Setelah video diunggah, video tersebut secara otomatis ditranskode berdasarkan kelompok template transkoding atau alur kerja yang ditentukan.
Skenario 2: Secara manual memicu pekerjaan watermarking setelah unggah
Masuk ke Konsol ApsaraVideo VOD.
Pada panel navigasi sebelah kiri, pilih Media Files > Audio/Video.
Di halaman Audio/Video, klik Processing di kolom Actions untuk video yang diinginkan.
Berdasarkan kebutuhan Anda, pilih Use Transcoding Template Group dan tentukan kelompok template transkoding yang telah Anda buat di Langkah 2, atau pilih Use Workflow dan tentukan alur kerja yang telah Anda buat di Langkah 3.
Klik OK.
Menggunakan OpenAPI
Skenario 1: Secara otomatis memicu pekerjaan watermarking saat mengunggah
Saat Anda memanggil operasi Get upload URL and credentials for audio/video atau UploadMediaByURL untuk mengunggah file audio atau video, Anda dapat menentukan metode pemrosesan. Untuk menggunakan kelompok template transkoding, atur parameter TemplateGroupId ke ID kelompok yang telah Anda buat di Langkah 2. Untuk menggunakan alur kerja, atur parameter WorkflowId ke ID alur kerja yang telah Anda buat di Langkah 3. Setelah file diunggah, ApsaraVideo VOD secara otomatis mentranskode berdasarkan pilihan Anda.
Skenario 2: Secara manual memicu pekerjaan watermarking setelah unggah
Untuk memulai transcoding berdasarkan kelompok template transkoding, panggil operasi SubmitTranscodeJobs dan atur parameter TemplateGroupId ke ID kelompok template transkoding yang telah Anda buat di Langkah 2.
Untuk memulai transcoding berdasarkan alur kerja, panggil operasi SubmitWorkflowJob dan atur parameter WorkflowId ke ID alur kerja yang telah Anda buat di Langkah 3.
Langkah 6: Dapatkan hasilnya
Notifikasi hasil asinkron
Jika Anda telah mengonfigurasi notifikasi event, Anda dapat menerima pesan callback untuk Single Transcoding Job Complete atau All Transcoding Jobs Complete untuk mendapatkan informasi tentang pekerjaan transcoding watermarking.
Kueri sinkron
Menggunakan Konsol
Masuk ke Konsol ApsaraVideo VOD.
Pada panel navigasi sebelah kiri, pilih Media Files > Audio/Video.
Di halaman Audio/Video, Anda dapat memeriksa Status video target.
Video dengan Status bernilai Normal menunjukkan bahwa pekerjaan transkoding telah berhasil.
Klik Manage pada baris video untuk membuka halaman Basic Information.
Klik tab Video URL untuk melihat aliran video yang telah ditranskode dan mendapatkan URL pemutaran.
Menggunakan OpenAPI
Anda dapat melakukan polling secara berkala terhadap status eksekusi dan hasil pekerjaan transcoding menggunakan ID-nya. Operasi berikut terkait dengan pekerjaan transcoding:
Contoh penerapan
Bagian ini memberikan contoh cara menggunakan ApsaraVideo VOD untuk skenario watermarking umum, seperti menetapkan beberapa watermark dan mengganti konten watermark secara dinamis menggunakan API.
Pernyataan hak cipta video pendek: Penggantian watermark teks dinamis
Deskripsi skenario
Pada aplikasi video pendek, ketika video yang diunggah pengguna ke platform video pendek diunduh atau dibagikan oleh pengguna lain, video tersebut biasanya membawa logo platform video pendek dan ID atau nickname pembuat aslinya.
Hasil yang diharapkan
Watermark yang menggabungkan gambar dengan konten teks yang unik untuk setiap pengguna.

Prosedur
Buat dua templat watermark: templat watermark gambar untuk logo platform dan templat watermark teks untuk ID atau nickname pembuat. Untuk informasi lebih lanjut, lihat Langkah 1: Buat templat watermark.
Buat kelompok template transkoding dan kaitkan kedua templat watermark yang telah Anda buat pada langkah sebelumnya. Untuk informasi lebih lanjut, lihat Langkah 2: Buat kelompok template transkoding dan kaitkan templat watermark.
Panggil operasi SubmitTranscodeJobs untuk memulai pekerjaan transcoding. Saat memulai pekerjaan, gunakan parameter OverrideParams dengan parameter WatermarkId dan Content untuk menimpa konten teks dari templat watermark yang ditentukan.
Contoh parameter OverrideParams: {"Watermarks":[{"WatermarkId":"ID templat watermark gambar"},{"WatermarkId":"ID templat watermark teks","Content":"Teks untuk menggantikan konten watermark asli"}]}
Rancang logika pemicu untuk pekerjaan transcoding sesuai kebutuhan. Sebagai contoh, Anda dapat memicu transcoding saat pengguna mengunggah video. Selama transcoding, ID atau nickname pembuat video asli secara otomatis diambil dan digunakan untuk menggantikan konten watermark teks.
Promosi merek situs web video: Penggantian watermark gambar dinamis
Deskripsi skenario
Situs web video memperoleh hak cipta film atau serial TV, lalu mensublisensikannya ke beberapa situs web video lain. Video yang didistribusikan di setiap situs web video harus menampilkan logo merek situs web tersebut.
Hasil yang diharapkan
Watermark gambar berbeda-beda di antara situs web video.

Prosedur
Panggil operasi GetAuxiliaryUploadAddressAndAuth untuk mengunggah gambar watermark (logo merek setiap 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 gambar watermark ke logo merek. Untuk informasi lebih lanjut, lihat Langkah 1: Buat templat watermark.
Buat kelompok template transkoding dan kaitkan templat watermark gambar yang telah Anda buat pada langkah sebelumnya. Untuk informasi lebih lanjut, lihat Langkah 2: Buat kelompok template transkoding dan kaitkan templat watermark.
Panggil operasi SubmitTranscodeJobs untuk memulai pekerjaan transcoding. Saat memulai pekerjaan, gunakan parameter OverrideParams dengan parameter WatermarkId dan FileUrl untuk menimpa gambar watermark dari templat watermark yang ditentukan.
Contoh parameter OverrideParams: {"Watermarks":{"WatermarkId":"ID templat watermark gambar","FileUrl":"URL gambar untuk menggantikan gambar watermark asli"}}
Rancang logika pemicu untuk pekerjaan transcoding sesuai kebutuhan. Sebagai contoh, Anda dapat memicu transcoding saat video diunggah.
FAQ
Gagal menambahkan gambar watermark di Konsol ApsaraVideo VOD dengan error 'unavailable image URL'
Jika Anda telah mengonfigurasi nama domain yang dipercepat di ApsaraVideo VOD, Anda harus mengonfigurasi sertifikat HTTPS untuk nama domain tersebut. Untuk informasi lebih lanjut, lihat Percepatan aman HTTPS.
Dokumen terkait
Untuk mencegah pelanggaran, Anda dapat menampilkan nickname atau ID penonton secara real time selama pemutaran. Anda dapat menggunakan fitur marquee dari SDK ApsaraVideo Player untuk tujuan ini. Untuk informasi lebih lanjut, lihat Komponen resmi.