调用SetLiveStreamDelayConfig配置直播延迟。

使用说明

  • 本接口支持配置播流域名的延迟配置。
  • 因为服务端缓存内是整数个关键帧间隔（GOP），所以延迟不会小于GOP大小，真实的延迟需要按照GOP大小估算。例如RTMP配置RtmpDelay为4秒，GOP大小为2秒，则真实延迟最小为2秒（4秒减去2秒），最大为6秒（4秒加上2秒）。 如果GOP大于RtmpDelay延迟配置，比如GOP=5秒,，RtmpDelay=4秒，则延迟在0～9秒之间波动。
  • 纯音频延迟配置无效，默认延迟接近0。
  • HLS配置方式为：先计算切片大小=Delay/3，向下取整，最小不能小于1秒。然后计算切片最大个数，当切片大小大于等于3秒时为4个，其余情况为6个。
  • HLS实际切片大小不会小于GOP大小。
  • HLS延迟计算方式为配置的切片大小*3。
  • 不调用该接口配置时，默认延迟时间为：RTMP为2秒；FLV为4秒；HLS一个切片大小为5秒，即延迟时间为15秒，最多6个切片。

QPS限制

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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 SetLiveStreamDelayConfig

系统规定参数。取值：SetLiveStreamDelayConfig。

RegionId String 否 cn-shanghai

域名所属地域。
DomainName String 是 example.com

播流域名。
HlsDelay Integer 否 4

HLS播放延迟时间。单位：秒。

说明 该参数为空时，按照HlsLevel延迟级别对应的时间设置。
HlsLevel String 否 short

HLS延迟级别。配置了HlsDelay情况下忽略该参数。

取值如下：

  • short（默认）：表示延迟时间为3秒。
  • medium：表示延迟时间为6秒。
  • long：表示延迟时间为15秒。
说明 如果HlsDelay和HlsLevel参数都为空，则按照默认值short进行配置。
FlvDelay Integer 否 8

FLV播放延迟时间。单位：秒。

说明 该参数为空时，按照FlvLevel延迟级别对应的时间设置。
FlvLevel String 否 medium

FLV延迟级别。配置了FlvDelay情况下忽略该参数。

取值如下：

  • short（默认）：表示延迟时间为4秒。
  • medium：表示延迟时间为8秒。
  • long：表示延迟时间为16秒。
说明 如果FlvDelay和FlvLevel参数都为空，则按照默认值short进行配置。
RtmpDelay Integer 否 4

RTMP播放延迟时间。单位：秒。

说明 该参数为空时，按照RtmpLevel延迟级别对应的时间设置。
RtmpLevel String 否 short

RTMP延迟级别。配置了RtmpDelay情况下忽略该参数。

取值如下：

  • short（默认）：表示延迟时间为4秒。
  • medium：表示延迟时间为8秒。
  • long：表示延迟时间为16秒。
说明 如果RtmpDelay和RtmpLevel参数都为空，则按照默认值short进行配置。

返回数据

名称 类型 示例值 描述
RequestId String 4C747C97-7ECD-4C61-8A92-67AD806331FF

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=SetLiveStreamDelayConfig
&DomainName=example.com
&HlsDelay=4
&FlvDelay=8
&RtmpDelay=4
&公共请求参数

正常返回示例

XML格式 

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

<SetLiveStreamDelayConfigResponse>
    <RequestId>4C747C97-7ECD-4C61-8A92-67AD806331FF</RequestId>
</SetLiveStreamDelayConfigResponse>

JSON格式 

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

{
  "RequestId" : "4C747C97-7ECD-4C61-8A92-67AD806331FF"
}

错误码

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

HttpCode

错误码

错误信息

描述

500

Internal

The request processing has failed due to some unknown error.

后台发生未知错误。

404

InvalidDomain.NotFound

The domain provided does not exist in our records.

当前账户下未查到域名。

403

IllegalOperation

Illegal domain operate is not permitted.

不支持当前操作，如：非直播类域名。

400

InvalidNotifyUrl.Malformedl

Specified parameter NotifyUrl is not valid.

不是一个合法的HTTP地址。

400

InvalidNotifyUrl.Unsafel

Specified NotifyUrl is not safe.

非安全的NotifyUrl值。