使用DescribeCasterStreamUrl查詢導播台流地址-ApsaraVideo for Live-阿里雲 - ApsaraVideo Live

查詢導播台流地址。

介面說明

先通過 CreateCaster 介面建立導播台，再調用本介面查詢導播台流地址，否則會返回 InvalidScene.NotFound 錯誤。

QPS 限制

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

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

live:DescribeCasterStreamUrl

get

*Caster

acs:live:*:{#accountId}:caster/{#CasterId}

無

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	否	地區 ID。	cn-shanghai
CasterId	string	是	導播台 ID，請確保傳入的 CasterId 是正確的。如果您通過 CreateCaster 介面建立導播台，請查看 CreateCaster 介面調用返回的參數 CasterId 值。如果您通過直播控制台建立導播台，請通過直播控制台 > 導播台 > 雲導播台頁面查看。說明直播控制台雲導播台頁面導播台列表中的導播台名稱即導播台 ID。	a2b8e671-2fe5-4642-a2ec-bf93880e****

返回參數

名稱	類型	描述	樣本值
	object
CasterId	string	導播台 ID。	a2b8e671-2fe5-4642-a2ec-bf93880e****
CasterStreams	object
CasterStream	array<object>	導播台流資訊列表。
	array<object>
OutputType	integer	是否正式輸出。 0：輸出預覽。 1：輸出正式。	1
RtmpUrl	string	Rtmp 地址。	rtmp://live/caster/example.edu
SceneId	string	情境 ID。	23ca74e0-aca3-4e7a-8561-9d96f525****
StreamInfos	object
StreamInfo	array<object>	播放地址清單。
	object
OutputStreamUrl	string	播放地址。	http://out/caster/example.net
TranscodeConfig	string	轉碼配置。取值： lsd：標清。 lld：流暢。 lud：超清。 lhd：高清。	lld
VideoFormat	string	格式。取值： flv。 rtmp。 m3u8。 artc 說明此導播台的播流網域名稱需開通超低延時功能才可返回 artc 協議的地址。具體開啟方法詳見開通超低延時直播功能。	flv
StreamUrl	string	輸出資料流地址。	http://live/caster/example.org
RequestId	string	請求 ID。	16A96B9A-F203-4EC5-8E43-CB92E6******
Total	integer	數量。	1

樣本

正常返回樣本

JSON格式

{
  "CasterId": "a2b8e671-2fe5-4642-a2ec-bf93880e****",
  "CasterStreams": {
    "CasterStream": [
      {
        "OutputType": 1,
        "RtmpUrl": "rtmp://live/caster/example.edu",
        "SceneId": "23ca74e0-aca3-4e7a-8561-9d96f525****",
        "StreamInfos": {
          "StreamInfo": [
            {
              "OutputStreamUrl": "http://out/caster/example.net",
              "TranscodeConfig": "lld",
              "VideoFormat": "flv"
            }
          ]
        },
        "StreamUrl": "http://live/caster/example.org"
      }
    ]
  },
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E6******",
  "Total": 1
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	InvalidUserId.Malformed	%s, please check userId.	傳入的userId無效，請檢查。
400	InvalidCasterId.Malformed	%s, please check and try again later.	參數CasterId無效，請檢查後重試。
401	IllegalOperation	%s, please check and try again later.	不允許的操作，請檢查後重試。
500	InternalError	%s, please try again later.	內部錯誤，請稍後重試。
404	InvalidCaster.NotFound	%s, please check and try again later.	導播台不存在，請檢查後重試。
404	InvalidScene.NotFound	%s, please check and try again later.	Scene不存在，請檢查後重試。
404	InvalidDomainName.NotFound	%s, please check and try again later.	網域名稱不存在，請檢查後重試。

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

變更歷史

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