添加直播封装配置_视频直播(LIVE)-阿里云帮助中心

使用说明

域名第一次添加封装配置时，会同步下发播放域名加速相关配置，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（低延迟）
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"
}

错误码

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