全部产品
Search
文档中心

ApsaraVideo Media Processing:Tambahkan watermark terlihat pada video

更新时间:Jul 06, 2025

Anda dapat menambahkan watermark terlihat seperti logo perusahaan atau stasiun TV ke video untuk meningkatkan visibilitas merek, melindungi hak cipta, dan meningkatkan pengenalan produk. ApsaraVideo Media Processing (MPS) mendukung jenis-jenis watermark berikut: image watermark, animated watermark, dan text watermark. Pilih tipe watermark sesuai dengan kebutuhan bisnis Anda. Bagian ini menjelaskan fitur dari berbagai jenis watermark dan cara menambahkannya ke video.

Ikhtisar

Skenario

  • Video pendek: Lindungi hak cipta video pendek Anda dengan menambahkan watermark sebelum diunduh atau dibagikan. Biasanya, Anda dapat menambahkan logo produk sebagai watermark gambar atau ID pengguna sebagai watermark teks.

  • Video online: Tambahkan logo merek pada video online untuk mengklaim kepemilikan hak cipta. Anda juga dapat menambahkan stiker pada program hiburan untuk membuatnya lebih menarik atau meningkatkan visibilitas iklan.

Fitur

Tipe Watermark

Deskripsi

Parameter permintaan API terkait

Didukung di konsol MPS

Watermark gambar

  • Anda dapat menambahkan hingga empat watermark pada video dan menyesuaikan waktu mulai, durasi, posisi, dan ukuran setiap watermark.

  • MPS memungkinkan Anda menambahkan gambar PNG, gambar APNG (Animated Portable Network Graphics), file MOV, dan file GIF sebagai watermark gambar.

  • Anda dapat menggunakan template watermark untuk dengan mudah menambahkan watermark gambar.

WaterMarks

Ya

Watermark teks

  • Anda dapat menambahkan hingga empat watermark pada video dan menyesuaikan waktu mulai, durasi, posisi, dan ukuran setiap watermark.

  • Anda dapat menyesuaikan konten teks dan efek font seperti ukuran font, jenis, warna, transparansi, dan border. Untuk informasi lebih lanjut tentang font dan warna yang didukung, lihat Font dan Warna.

  • Anda tidak dapat menggunakan template watermark untuk menambahkan watermark teks.

WaterMarks

Tidak

Tambahkan watermark gambar di konsol MPS

Catatan

Konsol MPS hanya memungkinkan penambahan watermark gambar. Untuk menambahkan watermark teks, gunakan operasi API SubmitJobs.

Tambahkan watermark gambar saat Anda mengirimkan pekerjaan transkoding

  1. Buat template watermark di konsol MPS. Untuk detail lebih lanjut, lihat Kelola Template Watermark.

  2. Buat pekerjaan transkoding di konsol MPS. Untuk informasi lebih lanjut, lihat Buat Pekerjaan Transkoding Reguler atau Alur Kerja. Lakukan langkah-langkah berikut untuk menggunakan template watermark:

    1. Aktifkan Template Watermark.

    2. Pilih template watermark yang telah dibuat pada Langkah 1 dari daftar drop-down Watermark Templates.

    3. Klik Select di sebelah bidang Watermark Image. Di kotak dialog Pilih File, pilih bucket dari daftar drop-down Bucket. Folder dalam bucket akan otomatis ditampilkan di bagian Path. Pilih file sebagai watermark.

      Catatan

      MPS mendukung penambahan gambar PNG, gambar APNG, file MOV, dan file GIF sebagai watermark gambar.

Tambahkan watermark gambar saat Anda menggunakan alur kerja untuk mengirimkan pekerjaan transkoding

  1. Buat template watermark di konsol MPS. Untuk informasi lebih lanjut, lihat Kelola Template Watermark.

  2. Buat alur kerja di konsol MPS. Untuk informasi lebih lanjut, lihat Buat Alur Kerja. Lakukan langkah-langkah berikut untuk menggunakan template watermark:

    Catatan

    Anda dapat menambahkan watermark gambar saat menggunakan alur kerja transkoding atau pengepakan. Dalam contoh ini, digunakan alur kerja pengepakan. Prosedur untuk kedua alur kerja tersebut sama.

    1. Di bagian Topologi, klik tombol image.png pada node Extract Video.image.png

    2. Konfigurasikan parameter Name dan Transcoding Templates sesuai kebutuhan bisnis Anda.

    3. Aktifkan Watermark.

    4. Pilih template watermark yang telah dibuat pada Langkah 1 dari daftar drop-down Watermark Templates.

    5. Klik Select di sebelah bidang Watermark Image. Di kotak dialog Pilih File, pilih bucket dari daftar drop-down Bucket. Folder dalam bucket akan otomatis ditampilkan di bagian Path. Pilih file sebagai watermark.

      Catatan

      MPS mendukung penambahan gambar PNG, gambar APNG, file MOV, dan file GIF sebagai watermark gambar.

Tambahkan watermark dengan memanggil operasi API SubmitJobs

Tambahkan watermark gambar saat Anda mengirimkan pekerjaan transkoding

Saat memanggil operasi SubmitJobs untuk mengirimkan pekerjaan transkoding, konfigurasikan parameter dalam objek WaterMark untuk menambahkan watermark. Anda dapat menggunakan template watermark untuk menambahkan watermark gambar.

  • Type

    Tipe watermark. Untuk menambahkan watermark gambar atau animasi, atur parameter Type ke Image.

  • InputFile

    Path Object Storage Service (OSS) yang akan ditambahkan sebagai watermark gambar atau animasi. MPS mendukung penambahan gambar PNG, gambar APNG, file MOV, dan file GIF sebagai watermark gambar.

  • WaterMarkTemplateId

    • ID template watermark yang digunakan untuk menambahkan watermark gambar. Template berisi semua pengaturan watermark tetapi tidak menyediakan gambar aktual yang akan digunakan sebagai watermark.

    • Anda dapat membuat template watermark di konsol MPS atau dengan memanggil operasi API AddWaterMarkTemplate. Untuk informasi lebih lanjut, lihat Kelola Template Watermark.

    Catatan

    Jika parameter WaterMarkTemplateId dikosongkan, pengaturan watermark default akan berlaku. Pengaturan parameter yang dikonfigurasikan dalam objek WaterMark akan menimpa yang ada di template watermark.

  • ReferPos, Dx, dan Dy

    Parameter ReferPos menentukan posisi referensi watermark pada video output. Nilai valid: TopLeft, TopRight, BottomLeft, dan BottomRight.

    Parameter Dx dan Dy menentukan offset horizontal dan vertikal watermark relatif terhadap nilai parameter ReferPos. Offset dapat diatur ke nilai piksel absolut atau sebagai persentase resolusi video output.

  • Width dan Height

    Lebar dan tinggi watermark. Anda dapat mengatur lebar dan tinggi ke nilai piksel absolut atau sebagai persentase resolusi video output.image.png

  • Timeline

    Waktu mulai dan durasi watermark.

Tambahkan watermark teks saat Anda mengirimkan pekerjaan transkoding

Saat memanggil operasi SubmitJobs untuk mengirimkan pekerjaan transkoding, konfigurasikan parameter dalam objek WaterMark untuk menambahkan watermark. Anda tidak dapat menggunakan template watermark untuk menambahkan watermark teks. Konfigurasikan parameter watermark berikut dalam permintaan API:

  • Type

    Tipe watermark. Untuk menambahkan watermark teks, atur parameter Type ke Text.

  • TextWaterMark

    • Konfigurasikan parameter Content untuk menentukan konten watermark teks. Emoji dan jeda baris tidak didukung dalam watermark teks. Jika teks terlalu panjang, teks akan dipotong agar sesuai dengan batas tampilan gambar video.

    • Konfigurasikan parameter FontName, FontSize, FontColor, FontAlpha, BorderWidth, dan BorderColor dari watermark teks.

    • Atur parameter Top dan Left ke nilai piksel absolut untuk menentukan posisi watermark teks relatif terhadap sudut kiri atas video output.image.png

    • Contoh: {"Content":"5rWL6K+V5paH5a2X5******","FontName":"SimSun","FontSize":"16","Top":2,"Left":10}.

Contoh kode

Saat video ditranskode menjadi video MP4 720P (1280×720), tiga watermark ditambahkan ke video output. Beberapa parameter watermark secara eksplisit ditentukan dan menimpa yang ada di template watermark.

  • Watermark gambar

    Sudut kanan atas video output ditentukan sebagai posisi referensi. Lebar watermark diatur menjadi 0,05 kali lebar video output. Tinggi watermark diskalakan secara proporsional berdasarkan rasio aspek gambar watermark asli.

  • Watermark teks

    Konten watermark teks adalah Test text watermark. Watermark teks ditampilkan pada posisi relatif terhadap sudut kiri atas video output. Font diatur ke SimSun, ukuran font ke 16, warna ke merah, dan transparansi ke 50.

  • Watermark animasi

    Sudut kiri bawah video output ditentukan sebagai posisi referensi. Video MOV ditentukan sebagai watermark. Tinggi watermark diatur menjadi 240 piksel. Lebar watermark diskalakan secara proporsional berdasarkan rasio aspek video watermark.

Untuk informasi lebih lanjut tentang contoh kode dalam SDK MPS untuk berbagai bahasa pemrograman, lihat topik-topik berikut: