調用AddRtsLiveStreamTranscode添加RTS自定義轉碼配置信息。
使用說明
調用本接口添加RTS自定義轉碼配置信息,本接口目前只支持h264、h264-nbhd、h264-origin、audio四種自定義轉碼模版類型。
QPS限制
本接口的單用戶QPS限制為10次/秒。超過限制,API調用會被限流,這可能會影響您的業務,請合理調用。更多信息,請參見QPS限制。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | AddRtsLiveStreamTranscode | 系統規定參數。取值:AddRtsLiveStreamTranscode。 |
Domain | String | 是 | example.com | 主播流域名。 |
App | String | 是 | aliyun-test | 播流所屬應用名稱。取值要求:
|
Template | String | 是 | ld | 轉碼模板自定義名稱。取值要求:
說明 不能與標準的轉碼模板命名重復。 |
TemplateType | String | 是 | h264 | 自定義轉碼模版類型。目前支持:
說明 如果選擇h264或h264-nbhd或h264-origin類型,必須同時設置請求參數Height,Width,FPS,VideoBitrate和DeleteBframes。 |
Height | Integer | 否 | 1280 | 轉碼視頻高度。單位:像素。取值: 重要 當TemplateType(自定義轉碼模版類型)設為h264或h264-nbhd或h264-origin時,本參數必填。
需要同時滿足如下三個條件:
例如:1560×1560(正方形視頻)是不合法的。 說明 原畫模板由于需要保持片源的信息,分辨率最高支持到4K。 |
Width | Integer | 否 | 720 | 轉碼視頻寬度。單位:像素。取值: 重要 當TemplateType(自定義轉碼模版類型)設為h264或h264-nbhd或h264-origin時,本參數必填。
需要同時滿足如下三個條件:
例如:1560×1560(正方形視頻)是不合法的。 說明 原畫模板由于需要保持片源的信息,分辨率最高支持到4K。 |
FPS | Integer | 否 | 30 | 轉碼視頻幀率。單位:FPS。取值:1~60。 重要 當TemplateType(自定義轉碼模版類型)設為h264或h264-nbhd或h264-origin時,本參數必填。
|
VideoBitrate | Integer | 否 | 2000 | 轉碼視頻比特率。單位:kbps。取值:1~6000。 重要 當TemplateType(自定義轉碼模版類型)設為h264或h264-nbhd或h264-origin時,本參數必填。
說明 轉碼視頻會盡量接近您所設定的比特率,但轉碼視頻的實際比特率不能保證和您所設定的完全一致,尤其是當您設定的比特率過大或過小時。 |
AudioBitrate | Integer | 否 | 128 | 轉碼音頻比特率。 單位:kbps。取值:1~1000。 重要 當TemplateType(自定義轉碼模版類型)設為audio時,本參數必填。
|
Gop | String | 否 | 2 | 視頻GOP(Group of Picture)。主要用于控制關鍵幀間隔。單位:秒。取值:1~3。 |
DeleteBframes | Boolean | 否 | false | 是否使用B幀進行轉碼。取值: 重要 當TemplateType(自定義轉碼模版類型)設為h264或h264-nbhd或h264-origin時,本參數必填。
說明 不傳參數時默認為false。 |
Opus | Boolean | 否 | true | 音頻轉碼是否使用opus進行轉碼(主要用戶兼容原生webrtc問題)。取值:
說明 不傳參數時默認為false。 |
Profile | Integer | 否 | 2 | 編碼級別。視頻支持的一組特定的編碼功能,一般值越大得到的畫面質量越好,同時編解碼消耗的資源也越高。取值:
|
AudioProfile | String | 否 | aac_low | 音頻編碼級別。取值:
|
AudioCodec | String | 否 | aac | 音頻編碼器。取值:
說明 如果要使用opus編碼,把Opus選項參數置為true即可。 |
AudioRate | Integer | 否 | 44100 | 音頻采樣率。取值:22050~96000,其中44100比較常用。單位:Hz。 說明 如果音頻編碼AudioProfile是aac_ld,則采樣率不能超過44100。 |
AudioChannelNum | Integer | 否 | 2 | 音頻聲道數。取值:
|
Lazy | String | 否 | no | 是否開啟觸發轉碼。取值:
|
返回數據
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 | 請求ID。 |
示例
請求示例
https://live.aliyuncs.com/?Action=AddRtsLiveStreamTranscode
&Domain=example.com
&App=aliyun-test
&Template=ld
&TemplateType=h264
&Height=1280
&Width=720
&FPS=25
&VideoBitrate=2400
&DeleteBframes=false
&<公共請求參數>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<AddLiveStreamTranscodeResponse>
<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</AddLiveStreamTranscodeResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
特殊錯誤碼
錯誤代碼 |
描述 |
HTTP 狀態碼 |
語義 |
InvalidDomain.NotFound |
The domain provided does not exist in our records. |
404 |
域名不存在或不屬于當前用戶。 |
IllegalOperation |
Illegal domain operate is not permitted. |
403 |
不支持當前操作,如:非直播類域名。 |
InvalidParameters |
Invalid parameters. |
400 |
參數不合法,如高度過大、比特率過大等。 |
ConfigAlreadyExists |
Config has already exist. |
400 |
配置已添加。 |
InternalError |
The request processing has failed due to some unknown error. |
500 |
后臺發生未知錯誤。 |