调用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情况下忽略该参数。 取值如下:
说明 如果HlsDelay和HlsLevel参数都为空,则按照默认值short进行配置。
|
FlvDelay | Integer | 否 | 8 |
FLV播放延迟时间。单位:秒。 说明 该参数为空时,按照FlvLevel延迟级别对应的时间设置。
|
FlvLevel | String | 否 | medium |
FLV延迟级别。配置了FlvDelay情况下忽略该参数。 取值如下:
说明 如果FlvDelay和FlvLevel参数都为空,则按照默认值short进行配置。
|
RtmpDelay | Integer | 否 | 4 |
RTMP播放延迟时间。单位:秒。 说明 该参数为空时,按照RtmpLevel延迟级别对应的时间设置。
|
RtmpLevel | String | 否 | short |
RTMP延迟级别。配置了RtmpDelay情况下忽略该参数。 取值如下:
说明 如果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值。 |