全部产品
Search
文档中心

视频直播:配置触发拉流

更新时间:Jul 08, 2024

调用SetLiveLazyPullStreamInfoConfig添加拉流信息。

使用说明

本接口的拉流方式属于触发拉流,即当需要拉取的源站开始播放直播流时,自动触发阿里云视频直播服务进行拉流直播。

说明 本接口暂时不支持IPv6协议。

QPS限制

本接口的单用户QPS限制为1000次/分钟。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称

类型

是否必选

示例值

描述

Action String SetLiveLazyPullStreamInfoConfig

系统规定参数。取值:SetLiveLazyPullStreamInfoConfig

DomainName String example.com

主播流域名。

AppName String ali_all_app

播流所属应用名称。

说明 如果需要全部App都触发回源,则取值ali_all_app
PullDomainName String guide.aliyundoc.com

直播流所在的源站。多个源站使用英文分号(;)分隔。

PullAppName String livePullApp****

回源拉流App。

说明 如果使用播放URL中的App,则此参数为空。
TranscodeLazy String no

转码播放触发拉流。默认为no。可选值:

  • yes
  • no
PullProtocol String rtmp

回源拉流协议。取值:

  • rtmp
  • httpflv
  • hls

返回数据

名称

类型

示例值

描述

RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CF8

请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=SetLiveLazyPullStreamInfoConfig
&DomainName=example.com
&AppName=ali_all_app
&PullDomainName=guide.aliyundoc.com
&PullAppName=livePullApp****
&TranscodeLazy=no
&PullProtocol=rtmp
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<SetLiveLazyPullStreamInfoConfigResponse>
    <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CF8</RequestId>
</SetLiveLazyPullStreamInfoConfigResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "16A96B9A-F203-4EC5-8E43-CB92E68F4CF8"
}

错误码

访问错误中心查看更多错误码。

错误代码

描述

HTTP 状态码

语义

InvalidDomain.NotFound

The domain provided does not exist in our records.

404

当前账户下未查到域名

IllegalOperation

Illegal domain operate is not permitted.

403

不支持当前操作,如:非直播类域名

Missing DomainName

DomainName is mandatory for this action.

400

缺少参数

InternalError

The request processing has failed due to some unknown error.

500

后台发生未知错误