SearchWaterMarkTemplate - - Alibaba Cloud Documentation Center

Kueri template watermark dalam status tertentu.

Catatan penggunaan

Anda dapat memanggil operasi ini untuk mengkueri template watermark dalam status tertentu. Jika status tidak ditentukan, semua template watermark akan dikueri secara default.

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 memengaruhi 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 kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Wajib	Contoh	Deskripsi
Action	String	Ya	SearchWaterMarkTemplate	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke SearchWaterMarkTemplate.
PageSize	Long	Tidak	10	Jumlah entri yang ditampilkan pada setiap halaman. Maksimal 100 entri dapat ditampilkan pada setiap halaman. Nilai default: 10.
PageNumber	Long	Tidak	1	Nomor halaman yang ditampilkan. Nilai default: 1.
State	String	Tidak	Normal	Status template watermark yang ingin Anda kueri. Nilai yang valid: All: Semua template watermark dikueri. Ini adalah nilai default. normal: Template watermark normal dikueri. Deleted: Template watermark yang telah dihapus dikueri.

Parameter respons

Parameter	Type	Contoh	Deskripsi
TotalCount	Long	1	Total jumlah entri yang dikembalikan.
PageSize	Long	10	Jumlah entri yang dikembalikan pada setiap halaman.
RequestId	String	FC029D04-8F47-57FF-A759-23383C15617D	ID permintaan.
PageNumber	Long	1	Nomor halaman yang dikembalikan.
WaterMarkTemplateList	Array of WaterMarkTemplate		Detail template watermark.
WaterMarkTemplate
Type	String	Image	Tipe watermark. Nilai yang valid: Image: watermark berupa gambar. Text: watermark berupa teks. Catatan Hanya watermark tipe 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, 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.2	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 template watermark. Nilai yang valid: Normal: Template watermark dalam kondisi normal. Deleted: Template watermark telah 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	ToEND	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	88c6ca184c0e4578645b665e2a12****	ID template watermark.

Contoh

Contoh permintaan

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=SearchWaterMarkTemplate
&PageSize=10
&PageNumber=1
&State=Normal
&<Common request parameters>

Contoh respons sukses

XML format

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

<SearchWaterMarkTemplateResponse>
    <TotalCount>1</TotalCount>
    <PageSize>10</PageSize>
    <RequestId>FC029D04-8F47-57FF-A759-23383C15617D</RequestId>
    <PageNumber>1</PageNumber>
    <WaterMarkTemplateList>
        <Type>Image</Type>
        <RatioRefer>
            <Dx>0.51</Dx>
            <Width>0.36</Width>
            <Height>0.33</Height>
            <Dy>0.2</Dy>
        </RatioRefer>
        <ReferPos>TopRight</ReferPos>
        <State>Normal</State>
        <Dx>100</Dx>
        <Width>8</Width>
        <Height>8</Height>
        <Timeline>
            <Start>0</Start>
            <Duration>ToEND</Duration>
        </Timeline>
        <Name>example-watermark</Name>
        <Dy>100</Dy>
        <Id>88c6ca184c0e4578645b665e2a12****</Id>
    </WaterMarkTemplateList>
</SearchWaterMarkTemplateResponse>

JSON format

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

{
  "TotalCount" : 1,
  "PageSize" : 10,
  "RequestId" : "FC029D04-8F47-57FF-A759-23383C15617D",
  "PageNumber" : 1,
  "WaterMarkTemplateList" : [ {
    "Type" : "Image",
    "RatioRefer" : {
      "Dx" : "0.51",
      "Width" : "0.36",
      "Height" : "0.33",
      "Dy" : "0.2"
    },
    "ReferPos" : "TopRight",
    "State" : "Normal",
    "Dx" : "100",
    "Width" : "8",
    "Height" : "8",
    "Timeline" : {
      "Start" : "0",
      "Duration" : "ToEND"
    },
    "Name" : "example-watermark",
    "Dy" : "100",
    "Id" : "88c6ca184c0e4578645b665e2a12****"
  } ]
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi Error Center.