SearchTemplate - - Alibaba Cloud Documentation Center

Menanyakan template transkoding kustom berdasarkan status tertentu.

Catatan penggunaan

Anda dapat memanggil operasi ini untuk menanyakan template transkoding kustom berdasarkan status tertentu.

Batas QPS

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

Debugging

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

Parameter permintaan

Parameter	Type	Wajib	Contoh	Deskripsi
Action	String	Ya	SearchTemplate	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke SearchTemplate.
PageSize	Long	Tidak	10	Jumlah entri yang dikembalikan pada setiap halaman. Maksimal 100 entri dapat dikembalikan pada setiap halaman. Nilai default: 10.
PageNumber	Long	Tidak	1	Nomor halaman yang dikembalikan. Nilai default: 1.
State	String	Tidak	Normal	Status template transkoding kustom yang ingin Anda tanyakan. All: Semua template transkoding kustom ditanyakan. normal: Template transkoding kustom normal ditanyakan. Deleted: Template transkoding kustom yang telah dihapus ditanyakan. Nilai default: All.

Parameter respons

Parameter	Type	Contoh	Deskripsi
TotalCount	Long	1	Total jumlah entri yang dikembalikan.
TemplateList	Array of Template		Detail template transkoding kustom.
Template
Video	Object		Konfigurasi kodek video.
Bufsize	String	6000	Ukuran buffer. Unit: KB. Nilai default: 6000.
LongShortMode	String	false	Menunjukkan apakah fitur auto-rotate screen diaktifkan. Jika fitur ini diaktifkan, lebar video output sesuai dengan sisi panjang video input, yaitu tinggi video input dalam mode portrait. Tinggi video output sesuai dengan sisi pendek video input, yaitu lebar video input dalam mode portrait. true: Fitur auto-rotate screen diaktifkan. false: Fitur auto-rotate screen dinonaktifkan. Nilai default: false.
Degrain	String	10	Tingkat kontrol kualitas pada video.
BitrateBnd	Object		Rentang bitrate rata-rata video.
Max	String	500	Batas atas total bitrate. Unit: Kbit/s.
Min	String	100	Batas bawah total bitrate. Unit: Kbit/s.
PixFmt	String	yuv420p	Format piksel video. Nilai yang valid: format piksel standar seperti yuv420p dan yuvj420p.
Pad	String	1280:800:0:140	Batas hitam yang ditambahkan ke video. Format: width:height:left:top. Contoh: 1280:800:0:140.
Codec	String	H.264	Kodek video. Nilai yang valid: H.264 dan H.265. Nilai default: H.264.
Height	String	800	Tinggi video. Unit: piksel. Nilai default: tinggi video input.
Qscale	String	1	Kekuatan algoritma reduksi noise independen.
Crop	String	border	Metode pemotongan video. Nilai yang valid: border: mendeteksi dan menghapus batas secara otomatis. Nilai lainnya: mode pemotongan kustom. Format: width:height:left:top. Contoh: 1280:800:0:140.
Bitrate	String	200	Bitrate rata-rata video. Unit: Kbit/s.
Maxrate	String	500	Bitrate maksimum video. Unit: Kbit/s.
MaxFps	String	60	Laju frame maksimum.
Profile	String	high	Profil codec. Nilai yang valid: baseline: berlaku untuk perangkat seluler. main: berlaku untuk perangkat definisi standar. high: berlaku untuk perangkat definisi tinggi. Nilai default: high.
Crf	String	15	Faktor kontrol kualitas bitrate. Nilai default saat parameter Codec diatur ke H.264: 23. Nilai default saat parameter Codec diatur ke H.265: 26. Jika parameter ini dikembalikan, pengaturan parameter Bitrate tidak berlaku.
Remove	String	false	Menunjukkan apakah aliran video dihapus. Nilai yang valid: true: Aliran video dihapus. false: Aliran video dipertahankan. Nilai default: false.
Gop	String	10	Jumlah maksimum frame antara dua keyframe. Nilai default: 250.
Width	String	256	Lebar video. Nilai yang valid: [128, 4096]. Unit: piksel. Nilai default: lebar video asli.
Fps	String	25	Laju frame video. Nilainya adalah 60 jika laju frame video input melebihi 60. Nilai default: laju frame video input.
Preset	String	medium	Algoritma video preset. Nilai default: medium. Nilai yang valid: veryfast fast medium slow slower
ScanMode	String	interlaced	Mode pemindaian. Nilai yang valid: interlaced: Pemindaian interlaced dilakukan. progressive: Pemindaian progressive dilakukan.
TransConfig	Object		Konfigurasi transkoding umum.
IsCheckAudioBitrate	String	false	Menunjukkan apakah bitrate audio diperiksa. Jika bitrate audio output lebih besar daripada bitrate audio input, bitrate audio input dipertahankan setelah transkoding. Dalam kasus ini, bitrate audio yang ditentukan tidak berlaku. Parameter ini memiliki prioritas lebih rendah dibandingkan parameter IsCheckAudioBitrateFail. Nilai yang valid: true: Bitrate audio diperiksa. false: Bitrate audio tidak diperiksa. Nilai default: Jika parameter dibiarkan kosong dan kodek audio output berbeda dari kodek audio input, nilai default-nya adalah false. Jika parameter dibiarkan kosong dan kodek audio output sama dengan kodek audio input, nilai default-nya adalah true.
TransMode	String	onepass	Mode transkoding. Nilai default: onepass. Nilai yang valid: onepass twopass CBR
IsCheckReso	String	false	Menunjukkan apakah resolusi diperiksa. Jika parameter ini diatur ke true dan sistem mendeteksi bahwa resolusi output lebih tinggi daripada resolusi input berdasarkan lebar atau tinggi, sistem menganggap bahwa resolusi output sama dengan resolusi input. true: Resolusi diperiksa. false: Resolusi tidak diperiksa. Nilai default: false.
IsCheckVideoBitrateFail	String	false	Menunjukkan apakah kesalahan pemeriksaan bitrate video diperbolehkan. Parameter ini memiliki prioritas lebih tinggi dibandingkan parameter IsCheckVideoBitrate. true: Jika pemeriksaan bitrate video gagal, file input tidak ditranskoding. false: Bitrate video tidak diperiksa. Nilai default: false.
AdjDarMethod	String	none	Metode penyesuaian resolusi. Nilai default: none. Nilai yang valid: rescale: Video input diskalakan ulang. crop: Video input dipotong. none: Tidak ada perubahan.
IsCheckVideoBitrate	String	false	Menunjukkan apakah bitrate video diperiksa. Jika parameter ini diatur ke true dan sistem mendeteksi bahwa bitrate video file output lebih besar daripada file input, bitrate video file input dipertahankan setelah transkoding. Nilai yang valid: true: Bitrate video diperiksa. false: Bitrate video tidak diperiksa. Nilai default: false.
IsCheckResoFail	String	false	Menunjukkan apakah resolusi diperiksa. Jika parameter ini diatur ke true dan sistem mendeteksi bahwa resolusi output lebih tinggi daripada resolusi input berdasarkan lebar atau tinggi, kegagalan transkoding akan dikembalikan. true: Resolusi diperiksa. false: Resolusi tidak diperiksa. Nilai default: false.
IsCheckAudioBitrateFail	String	false	Menunjukkan apakah kesalahan pemeriksaan bitrate audio diperbolehkan. Parameter ini memiliki prioritas lebih tinggi dibandingkan parameter IsCheckAudioBitrate. true: Jika pemeriksaan bitrate video gagal, file input tidak ditranskoding. false: Bitrate audio tidak diperiksa. Nilai default: false.
State	String	Normal	Status template. Nilai yang valid: Normal: Template normal. Deleted: Template dihapus.
MuxConfig	Object		Konfigurasi transmuxing.
Gif	Object		Konfigurasi transmuxing untuk GIF.
FinalDelay	String	0	Durasi jeda pada frame terakhir. Unit: centidetik.
DitherMode	String	sierra	Algoritma dithering warna palet. Nilai yang valid: sierra dan bayer.
Loop	String	0	Jumlah loop.
IsCustomPalette	String	false	Menunjukkan apakah palet kustom digunakan.
Segment	Object		Konfigurasi segmen.
Duration	String	10	Panjang segmen. Unit: detik.
Name	String	MPS-example	Nama template.
Audio	Object		Konfigurasi kodek audio.
Profile	String	aac_low	Profil codec audio. Nilai yang valid saat parameter Codec diatur ke aac: aac_low aac_he aac_he_v2 aac_ld aac_eld
Remove	String	false	Menunjukkan apakah aliran audio dihapus. Nilai yang valid: true: Aliran audio dihapus. false: Aliran audio dipertahankan. Nilai default: false.
Codec	String	aac	Kodek audio. Nilai default: aac. Nilai yang valid: aac mp3 vorbis flac
Samplerate	String	44100	Laju pengambilan sampel. Unit: Hz. Nilai default: 44100.
Qscale	String	1	Kekuatan algoritma reduksi noise independen. Nilai yang valid: [1, 9].
Channels	String	2	Jumlah saluran suara. Nilai default: 2.
Bitrate	String	500	Bitrate audio file output. Unit: Kbit/s. Nilai default: 128.
Id	String	16f01ad6175e4230ac42bb5182cd****	ID template transkoding.
Container	Object		Konfigurasi kontainer.
Format	String	mp4	Format kontainer. Nilai yang valid: flv mp4 ts m3u8 gif mp3 ogg flac
PageSize	Long	10	Jumlah entri yang dikembalikan per halaman.
RequestId	String	BC860F04-778A-472F-AB39-E1BF329C****	ID permintaan.
PageNumber	Long	1	Nomor halaman yang dikembalikan.

Contoh

Contoh permintaan

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

Contoh respons sukses

XML format

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

<SearchTemplateResponse>
    <TotalCount>1</TotalCount>
    <TemplateList>
        <Video>
            <Bufsize>6000</Bufsize>
            <LongShortMode>false</LongShortMode>
            <Degrain>10</Degrain>
            <BitrateBnd>
                <Max>500</Max>
                <Min>100</Min>
            </BitrateBnd>
            <PixFmt>yuv420p</PixFmt>
            <Pad>1280:800:0:140</Pad>
            <Codec>H.264</Codec>
            <Height>800</Height>
            <Qscale>1</Qscale>
            <Crop>border</Crop>
            <Bitrate>200</Bitrate>
            <Maxrate>500</Maxrate>
            <MaxFps>60</MaxFps>
            <Profile>high</Profile>
            <Crf>15</Crf>
            <Remove>false</Remove>
            <Gop>10</Gop>
            <Width>256</Width>
            <Fps>25</Fps>
            <Preset>medium</Preset>
            <ScanMode>interlaced</ScanMode>
        </Video>
        <TransConfig>
            <IsCheckAudioBitrate>false</IsCheckAudioBitrate>
            <TransMode>onepass</TransMode>
            <IsCheckReso>false</IsCheckReso>
            <IsCheckVideoBitrateFail>false</IsCheckVideoBitrateFail>
            <AdjDarMethod>none</AdjDarMethod>
            <IsCheckVideoBitrate>false</IsCheckVideoBitrate>
            <IsCheckResoFail>false</IsCheckResoFail>
            <IsCheckAudioBitrateFail>false</IsCheckAudioBitrateFail>
        </TransConfig>
        <State>Normal</State>
        <MuxConfig>
            <Gif>
                <FinalDelay>0</FinalDelay>
                <DitherMode>sierra</DitherMode>
                <Loop>0</Loop>
                <IsCustomPalette>false</IsCustomPalette>
            </Gif>
            <Segment>
                <Duration>10</Duration>
            </Segment>
        </MuxConfig>
        <Name>MPS-example</Name>
        <Audio>
            <Profile>aac_low</Profile>
            <Remove>false</Remove>
            <Codec>aac</Codec>
            <Samplerate>44100</Samplerate>
            <Qscale>1</Qscale>
            <Channels>2</Channels>
            <Bitrate>500</Bitrate>
        </Audio>
        <Id>16f01ad6175e4230ac42bb5182cd****</Id>
        <Container>
            <Format>mp4</Format>
        </Container>
    </TemplateList>
    <PageSize>10</PageSize>
    <RequestId>BC860F04-778A-472F-AB39-E1BF329C****</RequestId>
    <PageNumber>1</PageNumber>
</SearchTemplateResponse>

JSON format

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

{
  "TotalCount" : 1,
  "TemplateList" : [ {
    "Video" : {
      "Bufsize" : "6000",
      "LongShortMode" : "false",
      "Degrain" : "10",
      "BitrateBnd" : {
        "Max" : "500",
        "Min" : "100"
      },
      "PixFmt" : "yuv420p",
      "Pad" : "1280:800:0:140",
      "Codec" : "H.264",
      "Height" : "800",
      "Qscale" : "1",
      "Crop" : "border",
      "Bitrate" : "200",
      "Maxrate" : "500",
      "MaxFps" : "60",
      "Profile" : "high",
      "Crf" : "15",
      "Remove" : "false",
      "Gop" : "10",
      "Width" : "256",
      "Fps" : "25",
      "Preset" : "medium",
      "ScanMode" : "interlaced"
    },
    "TransConfig" : {
      "IsCheckAudioBitrate" : "false",
      "TransMode" : "onepass",
      "IsCheckReso" : "false",
      "IsCheckVideoBitrateFail" : "false",
      "AdjDarMethod" : "none",
      "IsCheckVideoBitrate" : "false",
      "IsCheckResoFail" : "false",
      "IsCheckAudioBitrateFail" : "false"
    },
    "State" : "Normal",
    "MuxConfig" : {
      "Gif" : {
        "FinalDelay" : "0",
        "DitherMode" : "sierra",
        "Loop" : "0",
        "IsCustomPalette" : "false"
      },
      "Segment" : {
        "Duration" : "10"
      }
    },
    "Name" : "MPS-example",
    "Audio" : {
      "Profile" : "aac_low",
      "Remove" : "false",
      "Codec" : "aac",
      "Samplerate" : "44100",
      "Qscale" : "1",
      "Channels" : "2",
      "Bitrate" : "500"
    },
    "Id" : "16f01ad6175e4230ac42bb5182cd****",
    "Container" : {
      "Format" : "mp4"
    }
  } ],
  "PageSize" : 10,
  "RequestId" : "BC860F04-778A-472F-AB39-E1BF329C****",
  "PageNumber" : 1
}

Kode kesalahan

Untuk daftar kode kesalahan, lihat Kode Kesalahan Layanan.