全部產品
Search
文件中心

ApsaraVideo Live:HotLiveRtcStream - 設定RTC流預熱

更新時間:Apr 21, 2026

設定RTC流預熱。

介面說明

QPS 限制

本介面的單使用者 QPS 限制為 10 次/秒。超過限制,API 呼叫會被限流,這可能會影響您的業務,請合理調用。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

live:HotLiveRtcStream

none

*Domain

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

無 無

請求參數

名稱

類型

必填

描述

樣本值

RegionId

string

否

地區 ID。

cn-shanghai

DomainName

string

是

播流網域名稱。

example.com

AppName

string

是

預熱直播流 App 名稱。

app

StreamName

string

是

預熱直播流名稱。

stream

RegionCode

string

是

預熱地區,詳細內容請查看 RegionCode 對應簡碼錶格。

說明

預熱地區粒度海外是國家簡碼,中國或中國內地是各省簡碼。

  • 如果傳入某個 RegionCode 後返回 CodeRegionHasNoNode,說明對應地區沒有 L1 節點覆蓋,無法預熱,可以更換 RegionCode

ZHJ

AudioMsid

string

是

音頻 Msid。

rts audio

VideoMsid

string

是

視頻 Msid。

rts video

ConnectionTimeout

string

否

預熱連結保持的時間,單位毫秒。預設 0 是一直保持。

0

MediaTimeout

string

否

自訂逾時事件的觸發時間。單位毫秒。

100000

RegionCode 對應簡碼

中國或中國內地代碼

中文名簡碼
北京市BEJ
天津市TAJ
河北省HEB
山西省SHX
內蒙古自治區NMG
遼寧省LIA
吉林省JIL
黑龍江省HLJ
上海市SHH
江蘇省JSU
浙江省ZHJ
安徽省ANH
福建省FUJ
江西省JXI
山東省SHD
河南省HEN
湖北省HUB
湖南省HUN
廣東省GUD
廣西壯族自治區GXI
海南省HAI
重慶市CHQ
四川省SCH
貴州省GUI
雲南省YUN
西藏自治區TIB
陝西省SHA
甘肅省GAN
青海省QIH
寧夏回族自治區NXA
新疆維吾爾自治區XIN
台灣省TAI
香港特別行政區HKG
澳門特別行政區MAC

國家代碼

中文名簡碼
巴布亞新畿內亞PG
斯洛伐克SK
秘魯PE
拉脫維亞LV
阿拉伯聯合酋長國AE
加拿大CA
古巴CU
毛里塔尼亞MR
日本JP
亞美尼亞AM
土庫曼TM
俄羅斯RU
白俄羅斯BY
幾內亞GN
伊拉克IQ
阿根廷AR
智利CL
斯威士蘭SZ
剛果CD
比利時BE
哈薩克KZ
塞爾維亞RS
土耳其TR
納米比亞NA
立陶宛LT
波多黎各PR
剛果共和國CG
新喀裡多尼亞NC
摩洛哥MA
格陵蘭島GL
科威特KW
利比里亞LR
烏克蘭UA
印尼ID
緬甸MM
玻利維亞BO
摩爾多瓦MD
希臘GR
新西蘭NZ
索羅門群島SB
埃塞俄比亞ET
斐濟FJ
也門YE
塞浦路斯CY
波斯尼亞黑塞哥維那BA
厄立特里亞ER
德國DE
巴基斯坦PK
中非共和國CF
克羅地亞HR
埃及EG
泰國TH
哥斯達黎加CR
坦桑尼亞TZ
寮國LA
利比亞LY
突尼斯TN
波蘭PL
英國GB
赤道幾內亞GQ
中國CN
冰島IS
阿曼OM
蒙古MN
乍得TD
美國US
墨西哥MX
吉爾吉斯KG
蘇里南SR
印度IN
幾內亞比紹GW
委內瑞拉VE
意大利IT
阿爾及利亞DZ
卡塔爾QA
法國FR
南非ZA
挪威NO
葡萄牙PT
匈牙利HU
韓國KR
烏茲別克UZ
布隆迪BI
愛沙尼亞EE
孟加拉國BD
不丹BT
阿富汗AF
瑞士CH
伯利茲BZ
東帝汶TL
海地HT
多哥TG
阿爾巴尼亞AL
喀麥隆CM
尼加拉瓜NI
尼日利亞NG
洪都拉斯HN
布基納法索BF
莫桑比克MZ
格魯吉亞GE
溫納圖VU
巴拉圭PY
盧森堡LU
黎巴嫩LB
烏幹達UG
馬里ML
沙地阿拉伯SA
巴勒斯坦PS
蒙特內格羅ME
哥倫比亞CO
菲律賓PH
瑞典SE
芬蘭FI
肯雅KE
羅馬尼亞RO
巴拿馬PA
約旦JO
盧旺達RW
萊索托LS
馬其頓MK
贊比亞ZM
敘利亞SY
西班牙ES
厄瓜多爾EC
加蓬GA
愛爾蘭IE
多明尼加共和國共和國DO
加納GH
馬達加斯加MG
馬來西亞MY
奧地利AT
塔吉克TJ
丹麥DK
烏拉圭UY
柬埔寨KH
塞內加爾SN
薩爾瓦多SV
塞拉利昂SL
文萊達魯薩蘭國BN
西撒哈拉EH
尼日爾NE
伊朗IR
圭亞那GY
安哥拉AO
博茨瓦納BW
巴西BR
澳大利亞AU
科特迪瓦CI
捷克共和國CZ
岡比亞GM
貝寧BJ
越南VN
蘇丹SD
荷蘭NL
吉布堤DJ
斯洛文尼亞SI
尼泊爾NP
津巴布韋ZW
牙買加JM
馬拉維MW
阿塞拜疆AZ
索馬里SO
以色列IL
福克蘭群島(馬爾維納斯群島)FK
朝鮮KP
危地馬拉GT
巴哈馬BS
斯裡蘭卡LK
新加坡SG
巴林BH

返回參數

名稱

類型

描述

樣本值

object

請求 ID。

RequestId

string

請求 ID。

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

樣本

正常返回樣本

JSON格式

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

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

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.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情。