全部产品
Search

搜索本产品

    CDN：Tambahkan watermark

    文档中心

    CDN：Tambahkan watermark

    更新时间：Jun 27, 2025

    Anda dapat menambahkan watermark untuk branding dan publisitas. Fitur ini membantu melindungi hak cipta gambar serta mencegah penggunaan tanpa izin. Alibaba Cloud CDN mendukung watermark gambar dan teks. Anda dapat menempatkan watermark pada gambar serta mengatur transparansinya agar tidak mengganggu konten utama.

    Catatan

    • Fitur pengeditan gambar dari Alibaba Cloud CDN, fitur pengeditan gambar dari DCDN, dan fitur Image Processing (IMG) dari Object Storage Service (OSS) merupakan tiga fitur yang berbeda.

    • Pengeditan gambar gratis hingga pemberitahuan lebih lanjut.

    • Saat menggunakan fitur pengeditan gambar, konversi antara format gambar seperti JPEG ke WebP, JPEG ke PNG, atau PNG ke WebP dapat meningkatkan ukuran file karena perbedaan algoritma kompresi. Untuk mengurangi ukuran gambar, kami sarankan Anda mengonfigurasi parameter quality guna menurunkan kualitas gambar.

    Catatan Penggunaan

    • Anda dapat menambahkan maksimal lima watermark pada sebuah gambar. Watermark gambar dan teks didukung.

    • Ukuran watermark gambar tidak dapat diubah. Ukuran gambar dasar yang digunakan sebagai watermark tidak boleh melebihi 1 MB.

    Parameter

    Aksi: watermark

    • Parameter Dasar

      Parameter

      Deskripsi

      Rentang Nilai

      t

      Opasitas teks atau watermark gambar.

      [0,100]

      Nilai default: 100. Nilai 100 menunjukkan bahwa watermark tidak transparan.

      g

      Posisi watermark pada gambar.

      • nw: kiri atas.

      • north: tengah atas.

      • ne: kanan atas.

      • west: tengah kiri.

      • center: tengah.

      • east: tengah kanan.

      • sw: kiri bawah.

      • south: tengah bawah.

      • se: kanan bawah.

      Untuk informasi lebih lanjut tentang posisi, lihat gambar berikut.

      x

      Margin horizontal, yaitu jarak horizontal antara watermark dan tepi gambar. Parameter ini hanya berlaku saat watermark berada di kiri atas, tengah kiri, kiri bawah, kanan atas, tengah kanan, atau kanan bawah gambar.

      [0,4096]

      Nilai default: 10. Satuan: piksel.

      y

      Margin vertikal, yaitu jarak vertikal antara watermark dan tepi bawah gambar. Parameter ini hanya berlaku saat watermark berada di kiri atas, tengah atas, kanan atas, tengah bawah, atau kanan bawah gambar.

      [0,4096]

      Nilai default: 10. Satuan: piksel.

    Anda dapat menggunakan x, y, dan offset untuk menyesuaikan posisi watermark pada gambar. Anda juga dapat menggunakan parameter ini untuk menyesuaikan tata letak watermark saat gambar memiliki beberapa watermark.

    Posisi Watermark

    • Parameter watermark gambar

      Parameter

      Deskripsi

      Rentang nilai

      image

      URL watermark yang dapat diakses melalui Internet. Jika autentikasi atau izin diperlukan untuk mengakses URL yang ditentukan, Alibaba Cloud CDN mungkin gagal mengambil URL watermark.

      URL watermark harus dikodekan dalam Base64. Untuk informasi lebih lanjut, lihat Kodekan watermark.

      String yang dikodekan dalam Base64

    • Parameter watermark teks

      Parameter

      Deskripsi

      Rentang Nilai

      text

      Konten watermark teks. Konten teks harus dikodekan dalam Base64. Untuk informasi lebih lanjut, lihat Kodekan Watermark.

      String yang dikodekan dalam Base64 dengan panjang maksimum 60 karakter.

      type

      Jenis font watermark teks. Nama font harus dikodekan dalam Base64. Untuk informasi lebih lanjut, lihat Kodekan Watermark.

      Mendukung hingga 10 jenis font. Untuk informasi lebih lanjut, lihat tabel berikut.

      Catatan

      Jika Anda menggunakan font yang tidak termasuk dalam 10 font tersebut, font tersebut akan dikenali sebagai font default alihyaihei.

      color

      Warna watermark teks. Nilai valid untuk parameter ini adalah nilai warna RGB.

      Sebagai contoh, 000000 menentukan hitam, dan FFFFFF menentukan putih.

      Nilai default: 000000.

      rotate

      Derajat watermark teks diputar searah jarum jam.

      [0,360]

      Nilai default: 0. Nilai 0 menentukan bahwa watermark teks tidak diputar.

      fill

      Menentukan apakah akan mengisi gambar dasar dengan watermark teks.

      Nilai valid: 0 dan 1. Nilai default: 0.

      • 0: tidak mengisi gambar dasar dengan watermark teks.

      • 1: mengisi gambar dasar dengan watermark teks.

      size

      Ukuran watermark teks.

      (0,1000]

      Nilai default: 40.

      Satuan: piksel.

      Tabel berikut menjelaskan nilai valid dari parameter type dan string terkode dari nilai-nilai tersebut.

      Font teks

      Deskripsi

      Nilai terkode

      alihyaihei

      Font tebal. Ini adalah font default.

      YWxpaHlhaWhlaQ

      hysong

      Variasi font Songti.

      aHlzb25n

      hyhei

      Variasi font Heiti.

      aHloZWk

      hyshuangxian

      Font garis ganda.

      aHlzaHVhbmd4aWFu

      comfortaa

      Comfortaa

      Y29tZm9ydGFh

      notosans

      NotoSans

      bm90b3NhbnM

    Kodekan watermark

    Saat menambahkan watermark, konten dan font watermark teks serta URL watermark gambar harus dikodekan dalam Base64 yang aman untuk URL. Untuk mengkodekan watermark, ikuti langkah-langkah berikut:

    1. Kodekan konten watermark dalam Base64.

      Kami merekomendasikan Anda menggunakan alat pengkodean Base64 yang aman untuk URL untuk mengkodekan konten dan font watermark teks serta URL watermark gambar. String terkode dari watermark hanya dapat digunakan dalam parameter yang digunakan untuk menambahkan watermark. Jangan sertakan string terkode dari watermark dalam string tanda tangan.

    2. Ganti karakter dalam konten watermark yang dikodekan dalam Base64 berdasarkan aturan berikut:

      • Ganti tanda tambah (+) dengan tanda hubung (-).

      • Ganti garis miring (/) dengan garis bawah (_).

      • Hilangkan tanda sama dengan (=) di akhir konten watermark yang dikodekan dalam Base64.

    Contoh

    • Tambahkan watermark teks "Hello World":

      Kodekan string "Hello World" dalam Base64 menjadi string yang aman untuk URL. Untuk informasi lebih lanjut, lihat Kodekan Watermark. Hasil pengkodean dari watermark teks adalah SGVsbG8gV29ybGQ. Hasil pengkodean dari font hysong adalah aHlzb25n. URL pemrosesan gambar adalah http(s)://example.com/image01.png?image_process=watermark,text_SGVsbG8gV29ybGQ,type_aHlzb25n.

    • Tambahkan watermark teks dan gambar:

      • Tambahkan watermark teks: Hello World. String yang aman untuk URL yang dikodekan dalam Base64 adalah SGVsbG8gV29ybGQ.

      • Atur posisi watermark teks ke kanan bawah, margin horizontal ke 10 piksel, dan offset vertikal dari garis tengah ke 10 piksel dengan menggunakan g_se,x_10,y_10.

      • Kodekan URL watermark gambar http://example-test.oss-ap-southeast-1.aliyuncs.com/image/shuiyin.png dalam Base64 menjadi string aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n.

      • Atur posisi watermark gambar ke kiri atas, margin horizontal ke 10 piksel, dan offset vertikal dari garis tengah ke 10 piksel dengan menggunakan g_nw,x_10,y_10.

      • URL pemrosesan gambar adalah http(s)://example.com/image01.png?image_process=watermark,text_SGVsbG8gV29ybGQ,g_se,x_10,y_10/watermark,image_aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n,g_nw,x_10,y_10.