文档

添加直播封装配置

更新时间:

调用AddLivePackageConfig添加直播封装配置。

使用说明

  • 域名第一次添加封装配置时,会同步下发播放域名加速相关配置,3~5分钟后可生效。
  • 若播放域名对应的区域为海外区域时(新加坡、德国、日本、印度、印尼),可能会存在延迟较大的问题,建议配置完成后请先测试验证是否符合预期。
  • 调用本接口增加直播封装配置,需要重新推流后才生效。

QPS限制

本接口的单用户QPS限制为300次/分钟。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称

类型

是否必选

示例值

描述

Action String AddLivePackageConfig

系统规定参数。取值:AddLivePackageConfig

DomainName String example.com

直播域名(主播放域名)。

AppName String AppName

App名,*表示匹配所有名称。

StreamName String StreamName

直播流名,*表示匹配AppName下所有流。

Protocol String HLS_CMAF

直播协议与封装格式。取值:

  • HLS_CMAF
  • LLHLS_TS

    (低延迟)

  • LLHLS_CMAF(低延迟)
  • DASH_CMAF
  • HLSDASH_CMAF
SegmentNum Integer 3

直播M3U8切片个数。

  • 取值范围:3~10。
  • 默认值:3。
SegmentDuration Integer 5

切片时长,单位:秒。

  • 如Protocol为HLS_CMAF,取值范围1~10,默认5秒;
  • 如Protocol为LLHLS_*,取值范围1~2,默认1秒。
PartDuration Integer 350

Part切片时长,单位:毫秒。

  • SegmentDuration为1s时,默认350ms。
  • SegmentDuration为2s时,默认700ms。
  • 仅当Protocol为LLHLS_*时有效。
IgnoreTranscode Boolean true

是否忽略转码流,取值:

  • true(默认值):忽略。
  • false:不忽略。

返回数据

名称

类型

示例值

描述

RequestId String 05D00B48-DF50-5DC0-A07D-A250DFAE4258

请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=AddLivePackageConfig
&DomainName=example.com
&AppName=AppName
&StreamName=StreamName
&Protocol=HLS_CMAF
&SegmentNum=3
&SegmentDuration=5
&PartDuration=350
&IgnoreTranscode=true
&公共请求参数

正常返回示例

XML格式

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

<AddLivePackageConfigResponse>
    <RequestId>05D00B48-DF50-5DC0-A07D-A250DFAE4258</RequestId>
</AddLivePackageConfigResponse>

JSON格式

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

{
  "RequestId" : "05D00B48-DF50-5DC0-A07D-A250DFAE4258"
}

错误码

访问错误中心查看更多错误码。

  • 本页导读 (1)