調(diào)用CreateMPULayout創(chuàng)建旁路直播布局。
使用說明
本接口用于創(chuàng)建旁路直播布局。例如：您可以配置混音個(gè)數(shù)、主窗格等參數(shù)。
QPS限制
本接口的單用戶QPS限制為10次/秒。超過限制，API調(diào)用會(huì)被限流，這可能會(huì)影響您的業(yè)務(wù)，請合理調(diào)用。更多信息，請參見QPS限制。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
請求參數(shù)
| 名稱 | 類型 | 是否必選 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | CreateMPULayout |
系統(tǒng)規(guī)定參數(shù)。取值：CreateMPULayout。 |
| AppId | String | 是 | yourAppId |
應(yīng)用ID，僅支持傳單個(gè)ID。 您可以在控制臺(tái)創(chuàng)建和查詢。 |
| Name | String | 否 | LayoutName |
布局名稱。 |
| AudioMixCount | Integer | 是 | 3 |
最大混音個(gè)數(shù)。取值范圍：0~6。 |
| Panes.N.MajorPane | Integer | 否 | 1 |
指定主窗格，每個(gè)布局只能有一個(gè)主窗格。
|
| Panes.N.Width | Float | 否 | 0.25 |
窗格寬，歸一化百分比。Width取值范圍：0.0<Width≤1.0。 |
| Panes.N.Height | Float | 否 | 0.25 |
窗格高，歸一化百分比。Height取值范圍：0.0<Height≤1.0。 |
| Panes.N.Y | Float | 否 | 0.25 |
坐標(biāo)Y，歸一化百分比。坐標(biāo)Y取值范圍：0.0≤Y≤1.0。 |
| Panes.N.PaneId | Integer | 否 | 0 |
布局ID，從左上到右下排序，從0開始。 |
| Panes.N.ZOrder | Integer | 否 | 0 |
疊放順序，0為最底層，1層在0層之上，以此類推。 |
| Panes.N.X | Float | 否 | 0.25 |
坐標(biāo)X，歸一化百分比。坐標(biāo)X取值范圍：0.0≤X≤1.0。 |
返回?cái)?shù)據(jù)
| 名稱 | 類型 | 示例值 | 描述 |
|---|---|---|---|
| LayoutId | Long | 2 |
布局ID。 |
| RequestId | String | 760bad53276431c499e30dc36f6b26be |
請求ID。 |
示例
請求示例
https://rtc.aliyuncs.com/?Action=CreateMPULayout
&AppId=yourAppId
&AudioMixCount=3
&Panes.1.PaneId=0
&Panes.1.MajorPane=1
&Panes.1.X=0.25
&Panes.1.Y=0.25
&Panes.1.Width=0.25
&Panes.1.Height=0.25
&Panes.1.ZOrder=0
&<公共請求參數(shù)>正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateMPULayoutResponse>
<RequestId>760bad53276431c499e30dc36f6b26be</RequestId>
<LayoutId>2</LayoutId>
</CreateMPULayoutResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "760bad53276431c499e30dc36f6b26be",
"LayoutId" : 2
}