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

使用说明

调用本接口更新直播封装配置，重新推流后生效。

QPS限制

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

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	UpdateLivePackageConfig	系统规定参数。取值：UpdateLivePackageConfig。
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	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8	请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=UpdateLivePackageConfig
&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

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

JSON格式

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

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

错误码

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