DescribeLiveStreamTranscodeInfo - ApsaraVideo Live

Menanyakan konfigurasi transkoding.

Deskripsi operasi

Anda dapat memanggil operasi API ini untuk menanyakan konfigurasi transkoding setelah memperoleh domain streaming untuk ingest.

Batas QPS

Batas permintaan per detik (QPS) untuk satu pengguna adalah 60 panggilan per detik. Jika batas ini terlampaui, panggilan API akan mengalami pembatasan kecepatan yang dapat memengaruhi bisnis Anda. Oleh karena itu, rencanakan panggilan API Anda secara tepat.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

live:DescribeLiveStreamTranscodeInfo

get

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	No	ID wilayah.	cn-shanghai
DomainTranscodeName	string	Yes	Domain streaming untuk ingest.	example.com
AppName	string	No	Nama aplikasi tempat aliran tersebut berada.	myapp

Elemen respons

Element	Type	Description	Example
	object	Konfigurasi transkoding.
RequestId	string	ID permintaan.	62136AE6-7793-45ED-B14A-60D19A9486D3
DomainTranscodeList	object
DomainTranscodeInfo	array<object>	Konfigurasi transkoding.
	array<object>	Konfigurasi transkoding.
TranscodeApp	string	Nama aplikasi.	liveApp****
TranscodeTemplate	string	Templat transkoding. Nilai yang valid: Templat transkoding standar: lld: definisi rendah. lsd: definisi standar. lhd: definisi tinggi. lud: resolusi ultra-tinggi. Templat transkoding Narrowband HD™: ld: definisi rendah. sd: definisi standar. hd: definisi tinggi. ud: resolusi ultra-tinggi.	lld
IsLazy	boolean	Menunjukkan apakah transkoding on-demand diaktifkan. Nilai yang valid: true: Transkoding on-demand diaktifkan. false: Transkoding paksa diaktifkan.	true
TranscodeName	string	Domain streaming untuk ingest.	example.com
CustomTranscodeParameters	object	Konfigurasi transkoding kustom.
BitrateWithSource	object	Konfigurasi untuk bitrate adaptif.	{\"UpLimit\":2500,\"LowerLimit\":800,\"Factor\":1}
VideoProfile	string	Profil pengkodean video. Nilai yang valid: baseline: cocok untuk perangkat seluler. main: cocok untuk perangkat definisi standar. high: cocok untuk perangkat resolusi tinggi.	high
AudioBitrate	integer	Bitrate audio untuk transkoding. Satuan: kbps. Nilai yang valid: 1 hingga 1000.	64
Height	integer	Tinggi video untuk transkoding.	1200
RtsFlag	string	Tag untuk latensi rendah. Nilainya tetap true. Catatan Parameter ini hanya dikembalikan saat menggunakan transkoding latensi rendah.	true
TemplateType	string	Jenis templat transkoding kustom. Nilai yang valid: h264: templat standar H.264 kustom. h264-nbhd: templat Narrowband HD™ H.264 kustom. h265: templat standar H.265 kustom. h265-nbhd: templat Narrowband HD H.265 kustom. audio: templat hanya audio.	h264
Bframes	string	Jumlah B-frame. Nilainya tetap 0.	0
ExtWithSource	object	Konfigurasi adaptif lainnya.	{\"KeyFrameOpen\":\"yes\",\"Copyts\":\"yes\",\"SeiMode\":1}
AudioRate	integer	Laju sampel audio. Nilai yang valid: 22050 hingga 96000. Catatan Jika AudioProfile diatur ke aac_ld, laju sampel tidak boleh melebihi 44100.	44100
FpsWithSource	object	Konfigurasi untuk laju frame adaptif.	{\"UpLimit\":60,\"LowerLimit\":1}
AudioCodec	string	Format pengkodean audio.	ACC
FPS	integer	Laju bingkai video untuk transkoding. Satuan: frame per detik (FPS).	15
Gop	string	Ukuran Group of Pictures (GOP) video. Satuan: frame. Nilai yang valid: 1 hingga 3000.	10
Width	integer	Lebar video untuk transkoding.	1000
VideoBitrate	integer	Bitrate video untuk transkoding. Satuan: kbps.	3000
AudioChannelNum	integer	Jumlah saluran audio. Nilai yang valid: 1: mono. 2: stereo.	2
AudioProfile	string	Profil pengkodean audio. Nilai yang valid: aac_low aac_he aac_he_v2 aac_ld	aac_low
ResWithSource	object	Konfigurasi untuk resolusi adaptif.	{\"Type\":\"short\",\"Value\":\"1080\"}
DeInterlaced	boolean	Menunjukkan apakah deteksi otomatis dan penghapusan interlacing selama transkoding diaktifkan. Ini mengonversi konten interlaced menjadi konten progresif. true: Deinterlacing diaktifkan. false: Format sumber dipertahankan. Tidak ada pemrosesan yang dilakukan. Ini adalah nilai default.
EncryptParameters	object	Konfigurasi enkripsi.
EncryptType	string	Jenis enkripsi. Nilainya tetap aliyun.	aliyun
KmsKeyID	string	ID kunci utama pengguna di Key Management Service (KMS).	afce5722-81d2-43c3-9930-7601da11****
KmsKeyExpireInterval	string	Interval rotasi kunci. Satuan: detik. Nilai yang valid: 60 hingga 3600.	3600

Contoh

Respons sukses

JSONformat

{
  "RequestId": "62136AE6-7793-45ED-B14A-60D19A9486D3",
  "DomainTranscodeList": {
    "DomainTranscodeInfo": [
      {
        "TranscodeApp": "liveApp****",
        "TranscodeTemplate": "lld",
        "IsLazy": true,
        "TranscodeName": "example.com",
        "CustomTranscodeParameters": {
          "BitrateWithSource": {
            "test": "test",
            "test2": 1
          },
          "VideoProfile": "high",
          "AudioBitrate": 64,
          "Height": 1200,
          "RtsFlag": "true",
          "TemplateType": "h264",
          "Bframes": "0",
          "ExtWithSource": {
            "test": "test",
            "test2": 1
          },
          "AudioRate": 44100,
          "FpsWithSource": {
            "test": "test",
            "test2": 1
          },
          "AudioCodec": "ACC",
          "FPS": 15,
          "Gop": "10",
          "Width": 1000,
          "VideoBitrate": 3000,
          "AudioChannelNum": 2,
          "AudioProfile": "aac_low",
          "ResWithSource": {
            "test": "test",
            "test2": 1
          },
          "DeInterlaced": false
        },
        "EncryptParameters": {
          "EncryptType": "aliyun",
          "KmsKeyID": "afce5722-81d2-43c3-9930-7601da11****",
          "KmsKeyExpireInterval": "3600"
        }
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidParameters	%s Please check and try again later.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.