Panggil AddWaterMarkTemplate untuk membuat template watermark - ApsaraVideo Media Processing

Membuat template watermark.

Deskripsi operasi

Setelah membuat template watermark melalui operasi ini, Anda dapat menentukan template watermark dan aset watermark saat mengirimkan pekerjaan transkoding untuk menambahkan informasi watermark ke video output.

Batas QPS

Operasi ini dapat dipanggil hingga 100 kali per detik per akun. Permintaan yang melebihi batas tersebut akan dibuang dan dapat menyebabkan gangguan layanan. Pastikan Anda mematuhi batas ini saat memanggil operasi ini. Untuk informasi selengkapnya, lihat Batas QPS.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

mts:AddWaterMarkTemplate

create

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Name	string	Yes	Nama Template watermark. Nilainya dapat berisi huruf dan angka, serta ukurannya maksimal 128 byte.	example-watermark-****
Config	string	Yes	Konfigurasi Template watermark. Nilainya berupa objek JSON. Untuk informasi selengkapnya, lihat bagian "WaterMarks" pada topik Detail Parameter. Catatan Jika Anda tidak memerlukan korelasi positif antara ukuran teks dalam watermark dan resolusi, Anda dapat mengaktifkan adaptasi untuk watermark tersebut. Untuk melakukannya, tambahkan `['adaptive']=true` ke parameter TextWaterMark.	{"Width":"10","Height":"30","Dx":"10","Dy":"5","ReferPos":"TopRight","Type":"Image","Timeline":{"Start":"0","Duration":"10"}}

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
WaterMarkTemplate	object	Detail Template watermark.
Type	string	Jenis watermark. Nilai yang valid: Image: watermark berupa gambar. Text: watermark berupa teks.	Image
RatioRefer	object	Nilai parameter Height, Width, Dx, dan Dy relatif terhadap tepi referensi. Jika nilai parameter Height, Width, Dx, dan Dy berupa desimal antara 0 dan 1, nilai-nilai tersebut dihitung dengan mengacu pada tepi-tepi berikut secara berurutan: Width: tepi lebar. Height: tepi tinggi. Long: tepi panjang. Short: tepi pendek.
Dx	string	Offset horizontal watermark relatif terhadap gambar video output. Nilai default: 0. Nilai default menunjukkan tidak ada offset. Nilainya dapat berupa bilangan bulat atau desimal. Bilangan bulat: offset vertikal. Ini menunjukkan posisi absolut. Satuan: piksel. Desimal: rasio offset horizontal terhadap lebar video output. Rasio ini bervariasi tergantung ukuran video. Mendukung hingga empat tempat desimal, misalnya 0,9999. Desimal tambahan akan dibuang.	0.51
Width	string	Lebar gambar watermark dalam video output. Nilainya dapat berupa bilangan bulat atau desimal. Bilangan bulat: lebar gambar watermark. Ini menunjukkan posisi absolut. Satuan: piksel. Desimal: rasio lebar gambar watermark terhadap lebar video output. Rasio ini bervariasi tergantung ukuran video. Mendukung hingga empat tempat desimal, misalnya 0,9999. Desimal tambahan akan dibuang.	0.36
Height	string	Tinggi gambar watermark dalam video output. Nilainya dapat berupa bilangan bulat atau desimal. Bilangan bulat: tinggi gambar watermark. Ini menunjukkan posisi absolut. Satuan: piksel. Desimal: rasio tinggi gambar watermark terhadap tinggi video output. Rasio ini bervariasi tergantung ukuran video. Mendukung hingga empat tempat desimal, misalnya 0,9999. Desimal tambahan akan dibuang.	0.33
Dy	string	Offset vertikal watermark relatif terhadap gambar video output. Nilai default: 0. Nilai default menunjukkan tidak ada offset. Nilainya dapat berupa bilangan bulat atau desimal. Bilangan bulat: offset vertikal. Ini menunjukkan posisi absolut. Satuan: piksel. Desimal: rasio offset vertikal terhadap tinggi video output. Rasio ini bervariasi tergantung ukuran video. Mendukung hingga empat tempat desimal, misalnya 0,9999. Desimal tambahan akan dibuang.	0.28
ReferPos	string	Posisi watermark. Nilai yang valid: TopRight: pojok kanan atas. TopLeft: pojok kiri atas. BottomRight: pojok kanan bawah. BottomLeft: pojok kiri bawah.	TopRight
State	string	Status Template watermark. Normal: Template watermark dalam kondisi normal. Deleted: Template watermark telah dihapus.	Normal
Dx	string	Offset horizontal. Satuan: piksel.	10
Width	string	Lebar gambar watermark. Satuan: piksel.	10
Height	string	Tinggi gambar watermark. Satuan: piksel.	30
Timeline	object	Timeline watermark.
Start	string	Awal rentang waktu tampilan watermark. Satuan: detik. Nilai default: 0.	0
Duration	string	Durasi tampilan watermark. Nilai default: ToEND. Nilai default menunjukkan bahwa watermark ditampilkan hingga video berakhir.	ToEND
Name	string	Nama Template watermark.	example-watermark-****
Dy	string	Offset vertikal. Satuan: piksel.	5
Id	string	ID Template watermark. Kami menyarankan agar Anda menyimpan ID ini untuk panggilan operasi selanjutnya.	3780bd69b2b74540bc7b1096f564****
RequestId	string	ID permintaan.	54BB917F-DD35-4F32-BABA-E60E31B21W63

Contoh

Respons sukses

JSONformat

{
  "WaterMarkTemplate": {
    "Type": "Image",
    "RatioRefer": {
      "Dx": "0.51",
      "Width": "0.36",
      "Height": "0.33",
      "Dy": "0.28"
    },
    "ReferPos": "TopRight",
    "State": "Normal",
    "Dx": "10",
    "Width": "10",
    "Height": "30",
    "Timeline": {
      "Start": "0",
      "Duration": "ToEND"
    },
    "Name": "example-watermark-****",
    "Dy": "5",
    "Id": "3780bd69b2b74540bc7b1096f564****"
  },
  "RequestId": "54BB917F-DD35-4F32-BABA-E60E31B21W63"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.