All Products
Search

This Product

    ApsaraVideo Live:HotLiveRtcStream

    Document Center

    ApsaraVideo Live:HotLiveRtcStream

    Last Updated:Jun 10, 2026

    Melakukan pra-ambil aliran Real-Time Communication (RTC).

    Deskripsi operasi

    QPS limit

    The queries per second (QPS) limit for a single user is 10 calls per second. API calls that exceed this limit are throttled, which may affect your business. Plan your calls accordingly.

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

    none

    *Domain

    acs:live:*:{#accountId}:domain/{#DomainName}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    No

    ID wilayah.

    cn-shanghai
    DomainName

    string

    Yes

    Domain streaming.

    example.com
    AppName

    string

    Yes

    Nama aplikasi aliran langsung yang akan di-pra-ambil.

    app
    StreamName

    string

    Yes

    Nama aliran langsung yang akan di-pra-ambil.

    stream
    RegionCode

    string

    Yes

    Area pra-ambil. Untuk informasi lebih lanjut, lihat tabel lookup RegionCode.

    Catatan

    Untuk wilayah di Tiongkok, tentukan kode yang sesuai dari tabel "Kode wilayah untuk Tiongkok". Untuk semua wilayah lainnya, tentukan kode negara.

    • Jika error CodeRegionHasNoNode dikembalikan setelah Anda menentukan RegionCode, area yang sesuai tidak tercakup oleh node L1 dan tidak dapat di-pra-ambil. Dalam hal ini, tentukan RegionCode yang berbeda.

    ZHJ
    AudioMsid

    string

    Yes

    Msid audio.

    rts audio
    VideoMsid

    string

    Yes

    Msid video.

    rts video
    ConnectionTimeout

    string

    No

    Durasi untuk mempertahankan koneksi pra-ambil. Unit: milidetik. Nilai default, 0, berarti koneksi selalu dipertahankan.

    0
    MediaTimeout

    string

    No

    Periode pengatur waktu kustom untuk event timeout. Unit: milidetik.

    100000

    Tabel lookup RegionCode

    Kode wilayah untuk Tiongkok

    NamaKode
    BeijingBEJ
    TianjinTAJ
    HebeiHEB
    ShanxiSHX
    Inner MongoliaNMG
    LiaoningLIA
    JilinJIL
    HeilongjiangHLJ
    ShanghaiSHH
    JiangsuJSU
    ZhejiangZHJ
    AnhuiANH
    FujianFUJ
    JiangxiJXI
    ShandongSHD
    HenanHEN
    HubeiHUB
    HunanHUN
    GuangdongGUD
    GuangxiGXI
    HainanHAI
    ChongqingCHQ
    SichuanSCH
    GuizhouGUI
    YunnanYUN
    TibetTIB
    ShaanxiSHA
    GansuGAN
    QinghaiQIH
    NingxiaNXA
    XinjiangXIN
    TaiwanTAI
    Hong KongHKG
    MacaoMAC

    Kode negara

    NamaKode
    Papua New GuineaPG
    SlovakiaSK
    PeruPE
    LatviaLV
    United Arab EmiratesAE
    CanadaCA
    CubaCU
    MauritaniaMR
    JapanJP
    ArmeniaAM
    TurkmenistanTM
    RussiaRU
    BelarusBY
    GuineaGN
    IraqIQ
    ArgentinaAR
    ChileCL
    EswatiniSZ
    Congo (DRC)CD
    BelgiumBE
    KazakhstanKZ
    SerbiaRS
    TürkiyeTR
    NamibiaNA
    LithuaniaLT
    Puerto RicoPR
    Congo (Brazzaville)CG
    New CaledoniaNC
    MoroccoMA
    GreenlandGL
    KuwaitKW
    LiberiaLR
    UkraineUA
    IndonesiaID
    MyanmarMM
    BoliviaBO
    MoldovaMD
    GreeceGR
    New ZealandNZ
    Solomon IslandsSB
    EthiopiaET
    FijiFJ
    YemenYE
    CyprusCY
    Bosnia and HerzegovinaBA
    EritreaER
    GermanyDE
    PakistanPK
    Central African RepublicCF
    CroatiaHR
    EgyptEG
    ThailandTH
    Costa RicaCR
    TanzaniaTZ
    LaosLA
    LibyaLY
    TunisiaTN
    PolandPL
    United KingdomGB
    Equatorial GuineaGQ
    ChinaCN
    IcelandIS
    OmanOM
    MongoliaMN
    ChadTD
    United StatesUS
    MexicoMX
    KyrgyzstanKG
    SurinameSR
    IndiaIN
    Guinea-BissauGW
    VenezuelaVE
    ItalyIT
    AlgeriaDZ
    QatarQA
    FranceFR
    South AfricaZA
    NorwayNO
    PortugalPT
    HungaryHU
    South KoreaKR
    UzbekistanUZ
    BurundiBI
    EstoniaEE
    BangladeshBD
    BhutanBT
    AfghanistanAF
    SwitzerlandCH
    BelizeBZ
    Timor-LesteTL
    HaitiHT
    TogoTG
    AlbaniaAL
    CameroonCM
    NicaraguaNI
    NigeriaNG
    HondurasHN
    Burkina FasoBF
    MozambiqueMZ
    GeorgiaGE
    VanuatuVU
    ParaguayPY
    LuxembourgLU
    LebanonLB
    UgandaUG
    MaliML
    Saudi ArabiaSA
    PalestinePS
    MontenegroME
    ColombiaCO
    PhilippinesPH
    SwedenSE
    FinlandFI
    KenyaKE
    RomaniaRO
    PanamaPA
    JordanJO
    RwandaRW
    LesothoLS
    North MacedoniaMK
    ZambiaZM
    SyriaSY
    SpainES
    EcuadorEC
    GabonGA
    IrelandIE
    Dominican RepublicDO
    GhanaGH
    MadagascarMG
    MalaysiaMY
    AustriaAT
    TajikistanTJ
    DenmarkDK
    UruguayUY
    CambodiaKH
    SenegalSN
    El SalvadorSV
    Sierra LeoneSL
    Brunei DarussalamBN
    Western SaharaEH
    NigerNE
    IranIR
    GuyanaGY
    AngolaAO
    BotswanaBW
    BrazilBR
    AustraliaAU
    Côte d'IvoireCI
    Czech RepublicCZ
    GambiaGM
    BeninBJ
    VietnamVN
    SudanSD
    NetherlandsNL
    DjiboutiDJ
    SloveniaSI
    NepalNP
    ZimbabweZW
    JamaicaJM
    MalawiMW
    AzerbaijanAZ
    SomaliaSO
    IsraelIL
    Falkland Islands (Malvinas)FK
    North KoreaKP
    GuatemalaGT
    BahamasBS
    Sri LankaLK
    SingaporeSG
    BahrainBH

    Elemen respons

    Element

    Type

    Description

    Example

    object

    The ID of the request.

    RequestId

    string

    The request ID.

    16BFE188-B193-4C3C-ADC5-79A7E31486EA

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "16BFE188-B193-4C3C-ADC5-79A7E31486EA"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidParam Parameter invalid.
    400 NoSpecialConfiguration no special configuration for domain name.
    400 CodeRegionHasNoNode this region has no corresponding node.
    500 InternalError The request processing has failed due to backend service exception.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.