QueryTemplateList - - Alibaba Cloud Documentation Center

Mengambil detail templat transkoding kustom.

Catatan penggunaan

Anda dapat memanggil operasi ini untuk mengambil hingga 10 templat transkoding kustom sekaligus.

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 berpotensi mengganggu bisnis Anda. Pastikan Anda mematuhi 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	Tipe	Wajib	Contoh	Deskripsi
Action	String	Ya	QueryTemplateList	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke QueryTemplateList.
TemplateIds	String	Ya	16f01ad6175e4230ac42bb5182cd**,88c6ca184c0e424d5w5b665e2a12**	ID templat transkoding kustom yang ingin Anda tanyakan. Anda dapat menanyakan hingga 10 templat transkoding kustom sekaligus. Pisahkan beberapa ID templat transkoding kustom dengan koma (,).

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
NonExistTids	Array of String	88c6ca184c0e424d5w5b665e2a12****	ID templat yang tidak ada. Parameter ini tidak dikembalikan jika semua templat transkoding yang ditentukan ditemukan.
TemplateList	Array of Template		Detail templat transkoding kustom.
Template
Video	Object		Konfigurasi kodek video.
Bufsize	String	6000	Ukuran buffer. Unit: KB. Nilai default: 6000.
LongShortMode	String	false	Menunjukkan apakah fitur putar-otomatis layar diaktifkan. Jika fitur ini diaktifkan, lebar video output sesuai dengan sisi panjang video input, yaitu tinggi video input dalam mode potret. Tinggi video output sesuai dengan sisi pendek video input, yaitu lebar video input dalam mode potret. true: Fitur putar-otomatis layar diaktifkan. false: Fitur putar-otomatis layar dinonaktifkan. Nilai default: false.
Degrain	String	10	Tingkat kontrol kualitas pada video.
BitrateBnd	Object		Rentang bitrate rata-rata video.
Max	String	100	Batas atas bitrate total. Unit: Kbit/s.
Min	String	500	Batas bawah bitrate total. 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 akan ditambahkan ke video. Format: width:height:left:top. Contoh: 1280:800:0:140.
Codec	String	H.264	Kodek video. 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 output. Unit: piksel. Nilai default: lebar asli video.
Fps	String	25	Laju frame. Nilainya adalah 60 jika laju frame video input melebihi 60. Nilai default: laju frame video input.
Preset	String	medium	Algoritma video preset. Nilai yang valid: veryfast, fast, medium, slow, dan slower. Nilai default: medium.
ScanMode	String	interlaced	Mode pemindaian. Kodek audio yang valid: interlaced: Dilakukan pemindaian interlaced. progressive: Dilakukan pemindaian progresif.
ResoPriority	String	heightFirst	Kebijakan penyesuaian resolusi. Nilai yang valid: CropFirst, widthFirst, dan heightFirst.
TransConfig	Object		Konfigurasi transkoding umum.
IsCheckAudioBitrate	String	false	Menunjukkan apakah bitrate audio diperiksa. Jika parameter ini diatur ke true dan sistem mendeteksi bahwa bitrate audio output lebih besar daripada bitrate audio input, bitrate audio input akan dipertahankan setelah transkoding. Dalam kasus ini, bitrate audio yang ditentukan tidak berlaku. Parameter ini memiliki prioritas lebih rendah daripada parameter IsCheckAudioBitrateFail. Nilai yang valid: true: Bitrate video diperiksa. false: Resolusi 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: Bitrate video diperiksa. false: Resolusi tidak diperiksa. Nilai default: false.
IsCheckVideoBitrateFail	String	false	Menunjukkan apakah kesalahan pemeriksaan bitrate video diperbolehkan. Parameter ini memiliki prioritas lebih tinggi daripada 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 diskala 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 tinggi daripada file input, bitrate video file input akan 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 daripada parameter IsCheckAudioBitrate. true: Jika pemeriksaan bitrate audio gagal, file input tidak ditranskoding. false: Bitrate audio tidak diperiksa. Nilai default: false.
State	String	Normal	Status templat. Nilai yang valid: Normal: Templat normal. Deleted: Templat dihapus.
MuxConfig	Object		Konfigurasi transmuxing.
Webp	Object		Konfigurasi transmuxing untuk WebP.
Loop	String	0	Jumlah loop.
Gif	Object		Konfigurasi transmuxing untuk GIF.
FinalDelay	String	0	Durasi jeda pada frame terakhir.
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 templat.
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. Kodek audio 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.
Channels	String	2	Jumlah saluran suara. Nilai default: 2.
Bitrate	String	500	Bitrate audio file output. Nilai yang valid: [8, 1000]. Unit: Kbit/s. Nilai default: 128.
Id	String	16f01ad6175e4230ac42bb5182cd****	ID templat transkoding.
Container	Object		Konfigurasi kontainer.
Format	String	flv	Format kontainer. Nilai yang valid: flv, mp4, ts, m3u8, gif, mp3, ogg, dan flac.
RequestId	String	BC860F04-778A-472F-AB39-E1BF329C1EA8	ID permintaan.

Contoh

Permintaan Contoh

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=QueryTemplateList
&TemplateIds=16f01ad6175e4230ac42bb5182cd****,88c6ca184c0e424d5w5b665e2a12****
&<Common request parameters>

Respons Sukses Contoh

XML format

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

<QueryTemplateListResponse>
    <NonExistTids>88c6ca184c0e424d5w5b665e2a12****</NonExistTids>
    <TemplateList>
        <Video>
            <Bufsize>6000</Bufsize>
            <LongShortMode>false</LongShortMode>
            <Degrain>10</Degrain>
            <BitrateBnd>
                <Max>100</Max>
                <Min>500</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>
            <ResoPriority>heightFirst</ResoPriority>
        </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>
            <Webp>
                <Loop>0</Loop>
            </Webp>
            <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>flv</Format>
        </Container>
    </TemplateList>
    <RequestId>BC860F04-778A-472F-AB39-E1BF329C1EA8</RequestId>
</QueryTemplateListResponse>

JSON format

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

{
  "NonExistTids" : [ "88c6ca184c0e424d5w5b665e2a12****" ],
  "TemplateList" : [ {
    "Video" : {
      "Bufsize" : "6000",
      "LongShortMode" : "false",
      "Degrain" : "10",
      "BitrateBnd" : {
        "Max" : "100",
        "Min" : "500"
      },
      "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",
      "ResoPriority" : "heightFirst"
    },
    "TransConfig" : {
      "IsCheckAudioBitrate" : "false",
      "TransMode" : "onepass",
      "IsCheckReso" : "false",
      "IsCheckVideoBitrateFail" : "false",
      "AdjDarMethod" : "none",
      "IsCheckVideoBitrate" : "false",
      "IsCheckResoFail" : "false",
      "IsCheckAudioBitrateFail" : "false"
    },
    "State" : "Normal",
    "MuxConfig" : {
      "Webp" : {
        "Loop" : "0"
      },
      "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" : "flv"
    }
  } ],
  "RequestId" : "BC860F04-778A-472F-AB39-E1BF329C1EA8"
}

Kode kesalahan

Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.