QueryWaterMarkTemplateList - - Alibaba Cloud Documentation Center

Menanyakan template watermark.

Catatan penggunaan

Anda dapat memanggil operasi ini untuk menanyakan hingga 10 template watermark sekaligus.

Batas QPS

Anda dapat memanggil operasi API ini hingga 100 kali per detik per akun. Jika jumlah panggilan per detik melebihi batas, Pembatasan kecepatan akan dipicu, yang berpotensi mengganggu bisnis Anda. Kami menyarankan agar Anda memperhatikan batas ini saat memanggil operasi ini. Untuk informasi selengkapnya, lihat Batas QPS.

Debugging

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

Parameter permintaan

Parameter	Tipe	Wajib	Contoh	Deskripsi
Action	String	Ya	QueryWaterMarkTemplateList	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke QueryWaterMarkTemplateList.
WaterMarkTemplateIds	String	Ya	3780bd69b2b74540bc7b1096f564****	ID template watermark yang ingin Anda tanyakan. Untuk mendapatkan ID template watermark, Anda dapat login ke Konsol ApsaraVideo Media Processing (MPS) dan pilih Global Settings > Watermark Templates di panel navigasi sebelah kiri. Anda dapat menanyakan hingga 10 template watermark sekaligus. Pisahkan beberapa ID template watermark dengan koma (,).

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
RequestId	String	17079AF5-6276-51A9-B755-D26594C93F3C	ID permintaan.
NonExistWids	Array of String	72dfa5e679ab4be9a3ed9974c736****	ID template watermark yang tidak ada. Parameter ini tidak dikembalikan jika semua template watermark yang ditentukan ditemukan.
WaterMarkTemplateList	Array of WaterMarkTemplate		Detail template watermark.
WaterMarkTemplate
Type	String	Image	Tipe watermark. Nilai yang valid: Image, dan Text. Catatan Hanya watermark bertipe Image yang didukung.
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 tersebut dihitung dengan mengacu pada 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, seperti 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, seperti 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, seperti 0.9999. Desimal tambahan akan dibuang.
Dy	String	0.4	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, seperti 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 template watermark. Nilai yang valid: Normal: Template watermark normal. Deleted: Template watermark dihapus.
Dx	String	100	Offset horizontal. Satuan: pixel.
Width	String	8	Lebar gambar watermark. Satuan: pixel.
Height	String	8	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 menunjukkan bahwa watermark ditampilkan hingga video berakhir.
Name	String	example-watermark	Nama template watermark.
Dy	String	100	Offset vertikal. Satuan: pixel.
Id	String	3780bd69b2b74540bc7b1096f564****	ID template watermark.

Contoh

Contoh permintaan

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=QueryWaterMarkTemplateList
&WaterMarkTemplateIds=3780bd69b2b74540bc7b1096f564****
&<Common request parameters>

Contoh respons sukses

XML format

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

<QueryWaterMarkTemplateListResponse>
    <RequestId>17079AF5-6276-51A9-B755-D26594C93F3C</RequestId>
    <NonExistWids>72dfa5e679ab4be9a3ed9974c736****</NonExistWids>
    <WaterMarkTemplateList>
        <Type>Image</Type>
        <RatioRefer>
            <Dx>0.51</Dx>
            <Width>0.36</Width>
            <Height>0.33</Height>
            <Dy>0.4</Dy>
        </RatioRefer>
        <ReferPos>TopRight</ReferPos>
        <State>Normal</State>
        <Dx>100</Dx>
        <Width>8</Width>
        <Height>8</Height>
        <Timeline>
            <Start>0</Start>
            <Duration>10</Duration>
        </Timeline>
        <Name>example-watermark</Name>
        <Dy>100</Dy>
        <Id>3780bd69b2b74540bc7b1096f564****</Id>
    </WaterMarkTemplateList>
</QueryWaterMarkTemplateListResponse>

JSON format

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

{
  "RequestId" : "17079AF5-6276-51A9-B755-D26594C93F3C",
  "NonExistWids" : [ "72dfa5e679ab4be9a3ed9974c736****" ],
  "WaterMarkTemplateList" : [ {
    "Type" : "Image",
    "RatioRefer" : {
      "Dx" : "0.51",
      "Width" : "0.36",
      "Height" : "0.33",
      "Dy" : "0.4"
    },
    "ReferPos" : "TopRight",
    "State" : "Normal",
    "Dx" : "100",
    "Width" : "8",
    "Height" : "8",
    "Timeline" : {
      "Start" : "0",
      "Duration" : "10"
    },
    "Name" : "example-watermark",
    "Dy" : "100",
    "Id" : "3780bd69b2b74540bc7b1096f564****"
  } ]
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi Error Center.