Membuat template watermark gambar atau teks. Untuk menyederhanakan pemrosesan watermark, ApsaraVideo VOD mengemas parameter watermark kompleks seperti posisi, ukuran, font, dan warna ke dalam template, yang direferensikan oleh ID template watermark yang unik.
Deskripsi operasi
Anda dapat memanggil operasi ini untuk menambahkan template watermark gambar (
Image) atau teks (Text). Template watermark gambar mendukung format berikut: gambar statis (PNG) dan gambar animasi (GIF, APNG, dan MOV).Setelah Anda menambahkan template watermark gambar atau teks, Anda harus memanggil operasi AddTranscodeTemplateGroup atau UpdateTranscodeTemplateGroup untuk mengaitkan template watermark dengan kelompok template transkoding. Ini memungkinkan Anda menggunakan template watermark untuk tugas transkoding watermark berikutnya.
Untuk informasi selengkapnya tentang penambahan watermark gambar atau teks ke video, lihat Watermark gambar dan teks.
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
vod:AddWatermark |
create |
*Semua resource.
|
None | None |
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| Type |
string |
Yes |
Tipe template watermark. Nilai valid:
|
Image |
| Name |
string |
Yes |
Nama template watermark.
|
Image watermark template |
| WatermarkConfig |
string |
Yes |
Informasi konfigurasi watermark gambar atau teks dalam format JSON. Konfigurasi mencakup posisi tampilan dan efek watermark. Parameter konfigurasi untuk watermark gambar dan watermark teks berbeda. Untuk informasi selengkapnya tentang struktur parameter, lihat WatermarkConfig. |
{ "Width": "55", "Height": "55", "Dx": "9", "Dy": "9", "ReferPos": "BottomLeft" } |
| FileUrl |
string |
No |
URL OSS dari file gambar watermark. URL tidak berisi informasi otentikasi. Catatan
|
http://outin-326268*****63e1403e7.oss-cn-shanghai.aliyuncs.com/image/cover/C99345*****E7FDEC-6-2.png |
| AppId |
string |
No |
ID aplikasi. Nilai default: app-1000000. Jika sistem multi-aplikasi diaktifkan, Anda dapat menentukan ID aplikasi untuk menambahkan template watermark ke aplikasi tertentu. Untuk informasi selengkapnya, lihat Sistem multi-aplikasi. |
app-**** |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
|||
| RequestId |
string |
ID permintaan. |
25818875-5F78-4A*****F6-D7393642CA58 |
| WatermarkInfo |
object |
Informasi template watermark. |
|
| CreationTime |
string |
Waktu pembuatan template watermark. Waktu mengikuti format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC. |
2018-11-07T09:05:52Z |
| Type |
string |
Tipe template watermark. Nilai valid:
|
Image |
| IsDefault |
string |
Apakah template watermark merupakan template watermark gambar atau teks default. Nilai valid:
|
NotDefault |
| FileUrl |
string |
URL file watermark. URL dapat berupa URL OSS atau URL CDN. Catatan
Parameter ini hanya dikembalikan untuk template watermark gambar. |
https://outin-3262*****9f4b3e7.oss-cn-shanghai.aliyuncs.com/image/cover/E6C3448CC8B715E6F8A72EC6B-6-2.png?Expires=1541600583&OSSAccessKeyId=****&Signature=gmf1eYMoDVg%2BHQCb4UGozBW**** |
| WatermarkConfig |
string |
Informasi konfigurasi watermark gambar atau teks dalam format JSON. Konfigurasi mencakup posisi tampilan dan efek watermark. Parameter konfigurasi untuk watermark gambar dan watermark teks berbeda. Untuk informasi selengkapnya tentang struktur parameter, lihat WatermarkConfig. |
{ "Width": "55", "Height": "55", "Dx": "9", "Dy": "9", "ReferPos": "BottomLeft" } |
| Name |
string |
Nama template watermark. |
Image watermark template |
| WatermarkId |
string |
ID template watermark. Anda dapat menggunakan ID template watermark untuk mengaitkan template watermark dengan kelompok template transkoding, atau mengkueri, mengubah, atau menghapus template watermark, atau mengaturnya sebagai template watermark default. |
9bcc8bfadb84*****109a2671d0df97 |
Contoh
Respons sukses
JSONformat
{
"RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
"WatermarkInfo": {
"CreationTime": "2018-11-07T09:05:52Z",
"Type": "Image",
"IsDefault": "NotDefault",
"FileUrl": "https://outin-3262*****9f4b3e7.oss-cn-shanghai.aliyuncs.com/image/cover/E6C3448CC8B715E6F8A72EC6B-6-2.png?Expires=1541600583&OSSAccessKeyId=****&Signature=gmf1eYMoDVg%2BHQCb4UGozBW****",
"WatermarkConfig": "{\n \"Width\": \"55\",\n \"Height\": \"55\",\n \"Dx\": \"9\",\n \"Dy\": \"9\",\n \"ReferPos\": \"BottomLeft\"\n}",
"Name": "Image watermark template",
"WatermarkId": "9bcc8bfadb84*****109a2671d0df97"
}
}
Kode kesalahan
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.