调用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代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| live:SetLiveStreamDelayConfig | update | *Domain acs:cdn:*:{#accountId}:domain/{#DomainName} |
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| 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 |
返回参数
示例
正常返回示例
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 值。|