調用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值。