All Products
Search
Document Center

ApsaraVideo Live:CreateLiveDelayConfig

更新時間:Oct 29, 2024

Adds a stream delay configuration.

Usage notes

Stream delay is different from latency caused by streaming protocols. Stream delay is a feature that allows you to delay the playback of a live stream that is processed in the cloud.

QPS limit

You can call this operation up to 60 times per second per account. Requests that exceed this limit are dropped and you will experience service interruptions. We recommend that you take note of this limit when you call this operation. For more information, see QPS limits.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter

Type

Required

Example

Description

Action String Yes CreateLiveDelayConfig

The operation that you want to perform. Set the value to CreateLiveDelayConfig.

Domain String Yes example.com

The main streaming domain.

App String Yes liveApp****

The name of the application to which the live stream belongs. You can specify an asterisk (*) as the value to match all applications under the domain name.

Stream String Yes liveStream****

The name of the live stream. You can specify an asterisk (*) as the value to match all streams in the application.

DelayTime Integer Yes 60

The duration for which the playback of the live stream is delayed. The value must be an integer. Valid values: 16 to 3600. Unit: seconds.

TaskTriggerMode String Yes PUBLISH_ONLY

The trigger mode. Valid values:

  • PUBLISH_ONLY: Stream delay can be triggered only by specifying the stream delay parameter in the ingest URL.
  • CONFIG_ONLY: Stream delay can be triggered only by the stream delay configuration.
  • PUBLISH_CONFIG: Stream delay can be triggered by the stream delay parameter in the ingest URL or the stream delay configuration. The stream delay parameter takes precedence over the stream delay configuration.

Response parameters

Parameter

Type

Example

Description

RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

The request ID.

Examples

Sample requests

http(s)://live.aliyuncs.com/?Action=CreateLiveDelayConfig
&Domain=example.com
&App=liveApp****
&Stream=liveStream****
&DelayTime=60
&TaskTriggerMode=PUBLISH_ONLY
&<Common request parameters>

Sample success responses

XML format

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

<CreateLiveDelayConfigResponse>
    <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</CreateLiveDelayConfigResponse>

JSON format

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

{
  "RequestId" : "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

Error codes

For a list of error codes, see Service error codes.