调用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 调用会被限流，这可能会影响您的业务，请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
live:SetLiveStreamDelayConfig |
update |
*Domain
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
|
DomainName |
string |
是 |
播流域名。 |
example.com |
|
HlsDelay |
integer |
否 |
HLS 播放延迟时间。单位：秒。 说明
该参数为空时，按照 HlsLevel 延迟级别对应的时间设置。 |
4 |
|
HlsLevel |
string |
否 |
HLS 延迟级别。配置了 HlsDelay 情况下忽略该参数。 取值如下：
说明
如果 HlsDelay 和 HlsLevel 参数都为空，则按照默认值 short 进行配置。 |
short |
|
FlvDelay |
integer |
否 |
FLV 播放延迟时间。单位：秒。 说明
该参数为空时，按照 FlvLevel 延迟级别对应的时间设置。 |
8 |
|
FlvLevel |
string |
否 |
FLV 延迟级别。配置了 FlvDelay 情况下忽略该参数。 取值如下：
说明
如果 FlvDelay 和 FlvLevel 参数都为空，则按照默认值 short 进行配置。 |
medium |
|
RtmpDelay |
integer |
否 |
RTMP 播放延迟时间。单位：秒。 说明
该参数为空时，按照 RtmpLevel 延迟级别对应的时间设置。 |
4 |
|
RtmpLevel |
string |
否 |
RTMP 延迟级别。配置了 RtmpDelay 情况下忽略该参数。 取值如下：
说明
如果 RtmpDelay 和 RtmpLevel 参数都为空，则按照默认值 short 进行配置。 |
short |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
请求 ID。 |
4C747C97-7ECD-4C61-8A92-67AD806331FF |
示例
正常返回示例
JSON格式
{
"RequestId": "4C747C97-7ECD-4C61-8A92-67AD806331FF"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。