All Products
Search
Document Center

ApsaraVideo Media Processing:Watermark video (watermark terlihat)

Last Updated:Jun 21, 2026

Menambahkan watermark yang terlihat, seperti logo perusahaan atau ikon stasiun TV, ke video Anda membantu memperkuat keberadaan merek, melindungi hak cipta, dan meningkatkan pengenalan produk. ApsaraVideo Media Processing (MPS) mendukung tiga jenis watermark: image watermark, animated watermark, dan text watermark. Anda dapat memilih jenis yang sesuai dengan kebutuhan bisnis Anda. Topik ini menjelaskan fitur dan penggunaan watermark terlihat.

Ikhtisar

Kasus penggunaan

  • Platform video pendek: Untuk melindungi hak cipta, video yang diunduh dan dibagikan sering kali menyertakan image watermark (logo produk) dan text watermark (ID pengguna).

  • Layanan video online: Logo merek biasanya ditambahkan ke video selama pemutaran untuk menegaskan kepemilikan hak cipta. Dalam acara hiburan, stiker juga digunakan sebagai watermark agar konten lebih menarik atau untuk menampilkan iklan.

Fitur

Jenis

Deskripsi

Parameter API

Dukungan Konsol

Image watermark dan animated watermark

  • Anda dapat menambahkan maksimal empat watermark ke satu video. Anda dapat mengatur waktu mulai, durasi, posisi tetap, dan ukuran untuk setiap watermark.

  • Format yang didukung mencakup gambar PNG statis (.png), gambar PNG animasi (APNG) (.apng), file MOV (.mov), dan file GIF (.gif).

  • Anda dapat menggunakan template watermark untuk menyederhanakan proses.

WaterMarks

Didukung

Text watermark

  • Anda dapat menambahkan maksimal empat watermark ke satu video. Anda dapat mengatur waktu mulai, durasi, posisi tetap, dan ukuran untuk setiap watermark.

  • Untuk text watermark, Anda dapat menyesuaikan konten, ukuran font, family font, warna, transparansi, dan efek border. Untuk informasi selengkapnya, lihat Fonts dan Color.

  • Template watermark tidak didukung.

WaterMarks

Tidak didukung

Tambahkan Watermark gambar di konsol

Catatan

Konsol MPS mendukung penambahan image watermark, termasuk format statis dan animasi. Untuk menambahkan text watermark, gunakan API.

Tambahkan image watermark saat pengiriman pekerjaan

  1. Buat template watermark di Konsol. Untuk informasi selengkapnya, lihat Template watermark.

  2. Buat pekerjaan transkoding di Konsol. Untuk informasi selengkapnya, lihat Buat pekerjaan transkoding reguler. Untuk mengonfigurasi pengaturan watermark, ikuti langkah-langkah berikut:

    1. Aktifkan sakelar Watermark template.

    2. Dari daftar drop-down Watermark template, pilih template watermark yang telah Anda buat pada langkah 1.

    3. Di samping Watermark Image, klik Select. Dari daftar drop-down Bucket, pilih bucket. Folder dalam bucket akan ditampilkan di bawah Path. Pilih file gambar yang akan digunakan sebagai watermark.

      Catatan

      Format yang didukung untuk image watermark mencakup gambar PNG statis (.png), gambar APNG (.apng), file MOV (.mov), dan file GIF (.gif).

Tambahkan image watermark melalui alur kerja

  1. Buat template watermark di Konsol. Untuk informasi selengkapnya, lihat Template watermark.

  2. Buat alur kerja di Konsol. Untuk informasi selengkapnya, lihat Buat alur kerja. Untuk mengonfigurasi pengaturan watermark, ikuti langkah-langkah berikut:

    Catatan

    Baik alur kerja transkoding maupun alur kerja pengemasan mendukung penambahan image watermark. Bagian ini menggunakan alur kerja pengemasan sebagai contoh. Prosedurnya sama untuk alur kerja transkoding.

    1. Pada topologi alur kerja, klik ikon image.png pada node Video Extraction.

    2. Konfigurasikan parameter Name dan Transcoding Template sesuai kebutuhan.

    3. Aktifkan sakelar Watermark template.

    4. Dari daftar drop-down Watermark template, pilih template watermark yang telah Anda buat pada langkah 1.

    5. Di samping Watermark Image, klik Select. Dari daftar drop-down Bucket, pilih bucket. Folder dalam bucket akan ditampilkan di bawah Path. Pilih file gambar yang akan digunakan sebagai watermark.

      Catatan

      Image watermark mendukung gambar PNG, gambar APNG, file MOV, dan file GIF.

Tambahkan watermark melalui API

Tambahkan image watermark saat pengiriman pekerjaan

Saat Anda mengirim pekerjaan transkoding, tentukan parameter WaterMark untuk menambahkan watermark. Anda dapat menggunakan template watermark untuk watermark gambar.

  • Type

    Atur parameter ini ke Image untuk menambahkan image watermark atau animated watermark.

  • InputFile

    Tentukan URL objek OSS dari gambar atau watermark animasi. Format yang didukung mencakup PNG statis (.png), APNG (.apng), MOV (.mov), dan GIF (.gif).

  • WaterMarkTemplateId

    • Template watermark berisi semua parameter watermark tetapi tidak mencakup file aset.

    • Anda dapat membuat template watermark di Konsol atau dengan memanggil operasi API. Untuk informasi selengkapnya, lihat Template watermark.

    Catatan

    Jika Anda tidak menentukan template, parameter default akan digunakan. Parameter yang ditentukan dalam objek WaterMark akan menggantikan parameter yang sesuai dalam template watermark.

  • ReferPos, Dx, dan Dy

    Gunakan ReferPos untuk mengatur posisi referensi watermark, seperti TopLeft, BottomLeft, TopRight, atau BottomRight.

    Kemudian, gunakan Dx dan Dy untuk menentukan offset horizontal dan vertikal dari posisi referensi. Anda dapat mengatur nilainya dalam pixel absolut atau sebagai rasio dari resolusi video output.

  • Lebar dan Tinggi

    Anda dapat mengatur nilainya dalam pixel absolut atau sebagai rasio dari resolusi video output.image.png

  • Timeline

    Atur waktu mulai dan durasi untuk watermark.

Tambahkan text watermark saat pengiriman pekerjaan

Saat Anda mengirim pekerjaan transkoding, tentukan parameter WaterMark untuk menambahkan watermark. Anda tidak dapat menggunakan template watermark untuk menambahkan watermark teks. Anda harus menentukan parameter watermark secara langsung:

  • Type

    Atur parameter ini ke Text untuk menambahkan text watermark.

  • TextWaterMark

    • Content: Gunakan parameter Content. Emoji dan jeda baris tidak didukung. Teks yang terlalu panjang akan dipotong.

    • Font style: Gunakan parameter FontName, FontSize, FontColor, FontAlpha, BorderWidth, dan BorderColor untuk mengatur font, ukuran, warna, dan gaya lainnya.

    • Position: Gunakan parameter Top dan Left untuk mengatur offset dalam pixel absolut dari pojok kiri atas video output.image.png

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

Kode contoh

Contoh ini menunjukkan cara menambahkan tiga watermark saat melakukan transkoding video menjadi file MP4 720P (1280×720). Parameter untuk setiap watermark ditentukan secara eksplisit, menggantikan pengaturan template apa pun:

  • Image watermark

    Image watermark muncul di pojok kanan atas. Lebarnya 5% dari lebar video output, dan tingginya diskalakan secara otomatis untuk mempertahankan rasio aspek.

  • Text watermark

    Text watermark dengan konten Test text watermark muncul di pojok kiri atas. Font-nya SimSun, ukurannya 16, warnanya merah, dan opasitasnya 50%.

  • Animated watermark

    Animated watermark dari file MOV muncul di pojok kiri bawah. Tingginya 240 pixel, dan lebarnya diskalakan secara otomatis untuk mempertahankan rasio aspek.

Kode contoh tersedia untuk SDK berikut: