UpdateWaterMarkTemplate - - Alibaba Cloud Documentation Center

Memperbarui templat watermark.

Catatan penggunaan

Anda dapat memanggil operasi ini untuk memperbarui informasi templat watermark berdasarkan ID-nya, seperti nama dan konfigurasi templat.
Templat watermark tidak dapat diperbarui jika sedang digunakan oleh pekerjaan yang telah dikirimkan.

Batas QPS

Anda dapat memanggil operasi API ini hingga 100 kali per detik per akun. Jika jumlah panggilan melebihi batas tersebut, pembatasan kecepatan (throttling) akan diterapkan dan dapat mengganggu bisnis Anda. Pastikan Anda memperhatikan batas ini saat melakukan pemanggilan. Untuk informasi selengkapnya, lihat Batas QPS.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer, yang secara dinamis menghasilkan contoh kode untuk berbagai SDK.

Parameter permintaan

Parameter	Tipe	Wajib	Contoh	Deskripsi
Action	String	Ya	UpdateWaterMarkTemplate	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke UpdateWaterMarkTemplate.
WaterMarkTemplateId	String	Ya	3780bd69b2b74540bc7b1096f564****	ID templat watermark yang ingin Anda perbarui. Untuk mendapatkan ID templat watermark tersebut, Anda dapat login ke Konsol ApsaraVideo Media Processing (MPS), lalu pilih Global Settings > Watermark Templates pada panel navigasi sebelah kiri.
Name	String	Ya	example-watermark-****	Nama baru untuk templat watermark. Nilainya dapat berisi huruf dan angka, serta panjangnya maksimal 128 byte.
Config	String	Ya	{"Width":"10","Height":"30","Dx":"10","Dy":"5","Type":"Image","Timeline":{"Start":"0","Duration":"10"}}	Konfigurasi terbaru dari templat watermark. Nilainya berupa objek JSON. Untuk informasi selengkapnya, lihat Konfigurasi templat watermark.

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
WaterMarkTemplate	Object		Detail templat watermark.
Type	String	Image	Jenis watermark. Nilai yang valid: Image: watermark berupa gambar. Text: watermark berupa teks. Catatan Hanya watermark jenis Image yang didukung.
RatioRefer	Object		Nilai parameter Height, Width, Dx, dan Dy relatif terhadap tepi referensi. Jika nilai 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	0.51	Offset horizontal watermark relatif terhadap gambar video output. Nilai default: 0. Nilai default menunjukkan tidak ada offset. Nilainya dapat berupa bilangan bulat atau desimal. Integer: offset vertikal. Ini menunjukkan posisi absolut. Satuan: pixel. Decimal: rasio offset horizontal terhadap lebar video output. Rasio ini bervariasi tergantung ukuran video. Dukungan hingga empat tempat desimal, misalnya 0.9999. Desimal tambahan akan dibuang.
Width	String	0.36	Lebar gambar watermark dalam video output. Nilainya dapat berupa bilangan bulat atau desimal. Integer: lebar gambar watermark. Ini menunjukkan posisi absolut. Satuan: pixel. Decimal: rasio lebar gambar watermark terhadap lebar video output. Rasio ini bervariasi tergantung ukuran video. Dukungan hingga empat tempat desimal, misalnya 0.9999. Desimal tambahan akan dibuang.
Height	String	0.33	Tinggi gambar watermark dalam video output. Nilainya dapat berupa bilangan bulat atau desimal. Integer: tinggi gambar watermark. Ini menunjukkan posisi absolut. Satuan: pixel. Decimal: rasio tinggi gambar watermark terhadap tinggi video output. Rasio ini bervariasi tergantung ukuran video. Dukungan hingga empat tempat desimal, misalnya 0.9999. Desimal tambahan akan dibuang.
Dy	String	0.28	Offset vertikal watermark relatif terhadap gambar video output. Nilai default: 0. Nilai default menunjukkan tidak ada offset. Nilainya dapat berupa bilangan bulat atau desimal. Integer: offset vertikal. Ini menunjukkan posisi absolut. Satuan: pixel. Decimal: rasio offset vertikal terhadap tinggi video output. Rasio ini bervariasi tergantung ukuran video. Dukungan hingga empat tempat desimal, misalnya 0.9999. Desimal tambahan akan dibuang.
ReferPos	String	TopRight	Posisi watermark. Nilai yang valid: TopRight: pojok kanan atas. TopLeft: pojok kiri atas. BottomRight: pojok kanan bawah. BottomLeft: pojok kiri bawah.
State	String	Normal	Status templat watermark. Nilai default: Normal.
Dx	String	10	Offset horizontal. Satuan: pixel.
Width	String	10	Lebar gambar watermark. Satuan: pixel.
Height	String	30	Tinggi gambar watermark. Satuan: pixel.
Timeline	Object		Timeline watermark.
Start	String	0	Awal rentang waktu tampilan watermark. Satuan: detik. Nilai default: 0.
Duration	String	10	Durasi tampilan watermark. Nilai default: ToEND. Nilai default ini menunjukkan bahwa watermark ditampilkan hingga video berakhir.
Name	String	example-watermark-****	Nama templat watermark.
Dy	String	5	Offset vertikal. Satuan: pixel.
Id	String	3780bd69b2b74540bc7b1096f564****	ID templat watermark. Kami menyarankan agar Anda menyimpan ID ini untuk panggilan operasi selanjutnya.
RequestId	String	E558894E-40D9-57C6-B5CC-0F5CDF23614E	ID permintaan.

Contoh

Contoh permintaan

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=UpdateWaterMarkTemplate
&WaterMarkTemplateId=3780bd69b2b74540bc7b1096f564****
&Name=example-watermark-****
&Config={"Width":"10","Height":"30","Dx":"10","Dy":"5","Type":"Image","Timeline":{"Start":"0","Duration":"10"}}
&<Common request parameters>

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<UpdateWaterMarkTemplateResponse>
    <WaterMarkTemplate>
        <Type>Image</Type>
        <RatioRefer>
            <Dx>0.51</Dx>
            <Width>0.36</Width>
            <Height>0.33</Height>
            <Dy>0.28</Dy>
        </RatioRefer>
        <ReferPos>TopRight</ReferPos>
        <State>Normal</State>
        <Dx>10</Dx>
        <Width>10</Width>
        <Height>30</Height>
        <Timeline>
            <Start>0</Start>
            <Duration>10</Duration>
        </Timeline>
        <Name>example-watermark-****</Name>
        <Dy>5</Dy>
        <Id>3780bd69b2b74540bc7b1096f564****</Id>
    </WaterMarkTemplate>
    <RequestId>E558894E-40D9-57C6-B5CC-0F5CDF23614E</RequestId>
</UpdateWaterMarkTemplateResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "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" : "10"
    },
    "Name" : "example-watermark-****",
    "Dy" : "5",
    "Id" : "3780bd69b2b74540bc7b1096f564****"
  },
  "RequestId" : "E558894E-40D9-57C6-B5CC-0F5CDF23614E"
}

Kode kesalahan

For a list of error codes, visit the Error Center.