All Products
Search

This Product

    ApsaraVideo Live:ListRtcMPUTaskDetail

    Document Center

    ApsaraVideo Live:ListRtcMPUTaskDetail

    Last Updated:Jul 16, 2026

    Mengkueri detail parameter tugas pencampuran dan penerusan aliran.

    Deskripsi operasi

    • Operasi ini mengkueri detail parameter tugas pencampuran dan penerusan aliran. Hanya tugas pencampuran dan penerusan aliran yang dibuat menggunakan operasi API yang dapat dikueri.

    • Untuk kueri berhalaman, hasil kueri diurutkan berdasarkan waktu pembaruan tugas secara menurun secara default.

    Batas QPS

    Batas QPS per pengguna tunggal untuk operasi ini adalah 50 panggilan per detik. Jika batas terlampaui, pemanggilan API akan dibatasi (throttled), yang dapat memengaruhi bisnis Anda. Panggil operasi ini sesuai kebutuhan.

    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:ListRtcMPUTaskDetail

    list

    *Semua sumber daya.

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    AppId

    string

    Yes

    ID aplikasi.

    Catatan

    ID aplikasi terdiri dari huruf besar, huruf kecil, digit, garis bawah, dan tanda hubung (-), dengan maksimal 64 karakter.

    yourAppId
    TaskId

    string

    No

    ID tugas.

    Catatan

    • ID tugas terdiri dari huruf besar, huruf kecil, digit, garis bawah, dan tanda hubung (-), dengan maksimal 55 karakter.

    • Jika Anda menentukan ID tugas, kueri dilakukan berdasarkan ID tugas terlebih dahulu, dan hasilnya berisi detail parameter tugas pencampuran dan penerusan aliran dengan ID tugas yang ditentukan.

    yourTaskId
    PageSize

    integer

    No

    Jumlah rekaman per halaman. Nilai valid: 1 hingga 100.

    Catatan

    Jika Anda tidak menentukan ID tugas, Anda harus menentukan parameter PageSize dan PageNo. Dalam hal ini, hasil kueri berhalaman dari semua tugas pencampuran dan penerusan aliran di bawah ID aplikasi yang ditentukan akan dikembalikan.

    10
    PageNo

    integer

    No

    Nomor halaman.

    Catatan

    Jika Anda tidak menentukan ID tugas, Anda harus menentukan parameter PageSize dan PageNo. Dalam hal ini, hasil kueri berhalaman dari semua tugas pencampuran dan penerusan aliran di bawah ID aplikasi yang ditentukan akan dikembalikan.

    20

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    ******3B-0E1A-586A-AC29-742247******
    MPUTasks

    array<object>

    Detail parameter tugas. Format parameter sama dengan format parameter yang digunakan saat Anda memanggil operasi untuk membuat tugas pencampuran aliran.

    array<object>

    AppId

    string

    ID aplikasi.

    yourAppId
    ChannelId

    string

    ID saluran.

    yourChannelId
    TaskId

    string

    ID tugas. ID ini adalah pengenal tugas pencampuran dan penerusan aliran.

    yourTaskId
    MixMode

    string

    Mode pencampuran aliran. Nilai valid:

    • 0: penerusan aliran tunggal tanpa pencampuran atau transkoding aliran. Hanya aliran tunggal asli yang diteruskan. Anda tidak perlu mengonfigurasi parameter pencampuran dan transkoding aliran.

    • 1 (default): pencampuran aliran, transkoding, dan penerusan.

    0
    StreamURL

    string

    URL ingest aliran langsung.

    rtmp://example.com/live/stream****
    MultiStreamURL

    array<object>

    Parameter penerusan multi-alamat.

    object

    URL

    string

    URL ingest.

    rtmp://example.com/live/stream****
    IsAliCdn

    boolean

    Menunjukkan apakah relai aliran dilakukan dengan menggunakan Alibaba Cloud CDN. Nilai yang valid:

    • false: Relai aliran dilakukan dengan menggunakan layanan CDN selain Alibaba Cloud CDN.

    • true: Relai aliran dilakukan dengan menggunakan Alibaba Cloud CDN.

    false
    Region

    string

    Wilayah tempat layanan pencampuran aliran yang diminta berada. Nilai valid:

    • CN-Shanghai: Shanghai.

    • AP-Singapore (default): Singapura.

    • EMAA-Saudi: Arab Saudi.

    CN-Shanghai
    MaxIdleTime

    string

    Periode waktu tunggu idle. Unit: detik.

    Catatan

    Jika parameter ini diatur, tugas akan otomatis berhenti ketika tugas telah idle selama periode lebih lama dari MaxIdleTime. Jika parameter ini tidak diatur, tugas akan berhenti segera setelah saluran ditutup.

    10
    SingleSubParams

    object

    Parameter penerusan aliran tunggal.

    SourceType

    string

    Sumber video. Parameter ini valid hanya jika Anda menetapkan StreamType ke 2. Nilai yang valid:

    • camera (default): menangkap video dengan menggunakan kamera.

    • shareScreen: menangkap konten yang ditampilkan di layar.

    camera
    StreamType

    string

    Jenis aliran yang direlai. Nilai yang valid:

    • 0 (default): aliran asli.

    • 1: aliran khusus audio.

    • 2: aliran khusus video.

    0
    UserId

    string

    ID pengguna yang aliranya direlai. Dalam mode relai aliran tunggal, Anda hanya dapat merelai satu aliran dalam satu permintaan.

    yourSubUserId
    TranscodeParams

    object

    Parameter pencampuran aliran, transkoding, dan penerusan.

    Background

    object

    Gambar latar belakang global.

    RenderMode

    string

    Mode tampilan. Nilai yang valid:

    • 0: menskalakan video atau gambar latar belakang secara proporsional agar pas dengan panel. Bilah hitam ditambahkan untuk mengisi ruang ekstra.

    • 1 (default): memotong video atau gambar latar belakang agar pas dengan panel.

    1
    URL

    string

    URL gambar latar belakang global.

    yourImageUrl
    EncodeParams

    object

    Parameter pengkodean aliran keluaran.

    AudioOnly

    string

    Menunjukkan apakah aliran keluaran adalah aliran khusus audio. Nilai yang valid:

    • true

    • false (default)

    false
    AudioBitrate

    string

    Bitrate audio. Satuan: Kbit/d.

    128
    AudioChannels

    string

    Jumlah saluran audio. Nilai yang valid: 1 dan 2.

    2
    AudioSampleRate

    string

    Laju sampling audio. Satuan: Hz.

    44100
    VideoCodec

    string

    Format pengkodean video. Nilai default: H.264.

    H.264
    VideoBitrate

    string

    Bitrate video. Satuan: Kbit/d.

    3500
    VideoFramerate

    string

    Laju frame video. Satuan: frame per detik (FPS).

    25
    VideoGop

    string

    Ukuran group of pictures (GOP) video.

    20
    VideoHeight

    string

    Tinggi video. Satuan: piksel.

    1000
    VideoWidth

    string

    Lebar video. Satuan: piksel.

    1920
    EnhancedParam

    string

    Parameter untuk pengkodean video tingkat lanjut. Nilainya berupa string JSON. Bidang opsional:

    • profile: tingkat pengkodean. Jika format pengkodean video diatur ke H.264, nilai yang valid dari bidang ini adalah baseline, main, dan high.

    • preset: menyesuaikan trade-off antara kecepatan pengkodean dan kualitas video. Nilai yang valid: ultrafast, superfast, veryfast, faster, fast, medium, slow, slower, veryslow, dan placebo. Setiap nilai menentukan tingkat trade-off antara kecepatan pengkodean dan kualitas video. Sebagai contoh, preset ultrafast memiliki kecepatan pengkodean tercepat tetapi kualitas video terendah, sedangkan preset placebo mengorbankan kecepatan pengkodean untuk kualitas video terbaik.

    {"profile": "high", "preset": "veryfast"}
    Layout

    object

    Informasi tata letak video.

    Catatan

    Informasi tata letak video mencakup koordinat x, koordinat y, lebar, tinggi, dan lapisan panel. Untuk transkoding khusus audio, tidak ada informasi tata letak video yang dikembalikan.

    UserPanes

    array<object>

    Informasi tentang panel.

    array<object>

    UserInfo

    object

    Informasi tentang pengguna yang aliranya diputar di panel.

    SourceType

    string

    Sumber video. Parameter ini valid hanya jika Anda menetapkan StreamType ke 2. Nilai yang valid:

    • camera (default): menangkap video dengan menggunakan kamera.

    • shareScreen: menangkap konten yang ditampilkan di layar.

    camera
    ChannelId

    string

    ID saluran tempat pengguna berada.

    yourChannelId
    UserId

    string

    ID pengguna.

    yourSubUserId
    Height

    string

    Tinggi panel. Nilai telah dinormalisasi.

    0.2632
    Width

    string

    Lebar panel. Nilai telah dinormalisasi.

    0.3564
    X

    string

    Koordinat x panel. Nilai telah dinormalisasi.

    0.2456
    Y

    string

    Koordinat y panel. Nilai telah dinormalisasi.

    0.3789
    ZOrder

    string

    Lapisan panel. Nilai 0 menunjukkan bahwa panel ditempatkan di lapisan paling bawah. Nilai yang lebih besar menunjukkan lapisan yang lebih tinggi.

    0
    BackgroundImageUrl

    string

    URL gambar latar belakang panel. Gambar ini ditampilkan jika pengguna mematikan kamera atau tidak hadir di saluran.

    yourImageUrl
    RenderMode

    string

    Mode tampilan. Nilai yang valid:

    • 0: menskalakan video atau gambar latar belakang secara proporsional agar pas dengan panel. Bilah hitam ditambahkan untuk mengisi ruang ekstra.

    • 1 (default): memotong video atau gambar latar belakang agar pas dengan panel.

    1
    UserInfos

    array<object>

    Informasi tentang pengguna yang aliranya dicampur. Jika nilai kosong dikembalikan, aliran dari semua pengguna dicampur.

    object

    ChannelId

    string

    ID saluran tempat pengguna berada.

    yourChannelId
    UserId

    string

    ID pengguna.

    yourSubUserId
    SourceType

    string

    Sumber video. Parameter ini valid hanya jika Anda menetapkan StreamType ke 2. Nilai yang valid:

    • camera (default): menangkap video dengan menggunakan kamera.

    • shareScreen: menangkap konten yang ditampilkan di layar.

    camera
    StreamType

    string

    Jenis aliran yang direlai. Nilai yang valid:

    • 0 (default): aliran asli.

    • 1: aliran khusus audio.

    • 2: aliran khusus video.

    0
    SeiParams

    object

    Parameter konfigurasi SEI.

    LayoutVolume

    object

    SEI tata letak dan volume. Jika nilai yang dikembalikan berupa string kosong, SEI tata letak dan volume default digunakan.

    FollowIdr

    string

    Menunjukkan apakah akan menambahkan pesan SEI ke frame Instantaneous Decoder Refresh (IDR). Nilai yang valid:

    • 0: tidak menambahkan pesan SEI.

    • 1: menambahkan pesan SEI.

    0
    Interval

    string

    Interval saat pesan SEI ditambahkan. Satuan: milidetik.

    1000
    PassThrough

    object

    SEI kustom.

    FollowIdr

    string

    Menunjukkan apakah akan menambahkan pesan SEI ke frame Instantaneous Decoder Refresh (IDR). Nilai yang valid:

    • 0: tidak menambahkan pesan SEI.

    • 1: menambahkan pesan SEI.

    0
    Interval

    string

    Interval saat pesan SEI ditambahkan. Satuan: milidetik.

    1000
    PayloadContent

    string

    Konten payload SEI kustom.

    yourPayloadContent
    PayloadContentKey

    string

    Kunci konten payload. Nilai default: udd.

    yourPayloadContentKey
    PayloadType

    string

    Jenis payload kustom. Nilai yang valid: 100 hingga 254. Nilai default: 5.

    100

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "******3B-0E1A-586A-AC29-742247******",
  "MPUTasks": [
    {
      "AppId": "yourAppId",
      "ChannelId": "yourChannelId",
      "TaskId": "yourTaskId",
      "MixMode": "0",
      "StreamURL": "rtmp://example.com/live/stream****",
      "MultiStreamURL": [
        {
          "URL": "rtmp://example.com/live/stream****",
          "IsAliCdn": false
        }
      ],
      "Region": "CN-Shanghai",
      "MaxIdleTime": "10",
      "SingleSubParams": {
        "SourceType": "camera",
        "StreamType": "0",
        "UserId": "yourSubUserId"
      },
      "TranscodeParams": {
        "Background": {
          "RenderMode": "1",
          "URL": "yourImageUrl"
        },
        "EncodeParams": {
          "AudioOnly": "false",
          "AudioBitrate": "128",
          "AudioChannels": "2",
          "AudioSampleRate": "44100",
          "VideoCodec": "H.264",
          "VideoBitrate": "3500",
          "VideoFramerate": "25",
          "VideoGop": "20",
          "VideoHeight": "1000",
          "VideoWidth": "1920",
          "EnhancedParam": "{\"profile\": \"high\", \"preset\": \"veryfast\"}"
        },
        "Layout": {
          "UserPanes": [
            {
              "UserInfo": {
                "SourceType": "camera",
                "ChannelId": "yourChannelId",
                "UserId": "yourSubUserId"
              },
              "Height": "0.2632",
              "Width": "0.3564",
              "X": "0.2456",
              "Y": "0.3789",
              "ZOrder": "0",
              "BackgroundImageUrl": "yourImageUrl",
              "RenderMode": "1"
            }
          ]
        },
        "UserInfos": [
          {
            "ChannelId": "yourChannelId",
            "UserId": "yourSubUserId",
            "SourceType": "camera",
            "StreamType": "0"
          }
        ]
      },
      "SeiParams": {
        "LayoutVolume": {
          "FollowIdr": "0",
          "Interval": "1000"
        },
        "PassThrough": {
          "FollowIdr": "0",
          "Interval": "1000",
          "PayloadContent": "yourPayloadContent",
          "PayloadContentKey": "yourPayloadContentKey"
        },
        "PayloadType": "100"
      }
    }
  ]
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidParam %s. Validasi parameter gagal.
    400 InvalidAppId %s, please check and try again later. AppId tidak valid. Periksa dan coba lagi.
    400 MissingParam %s, please check and try again later. Parameter yang diperlukan tidak ada. Periksa dan coba lagi.
    500 InternalError %s, please try again later. Terjadi error internal. Coba lagi nanti.
    403 OperationDenied Your account has not enabled the Live service
    403 Forbidden %s, please check and try again later. Anda tidak memiliki izin yang diperlukan. Periksa dan coba lagi.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.