修改频道打包信息
功能介绍
修改频道打包信息。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
PUT /v1/{project_id}/ott/channels/endpoints
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
项目ID，获取方法请参考获取项目ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token，使用Token鉴权方式时必选。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
Access-Control-Allow-Internal |
否 |
String |
服务鉴权Token，服务开启鉴权，必须携带Access-Control-Allow-Internal访问服务。 |
Access-Control-Allow-External |
否 |
String |
服务鉴权Token，服务开启鉴权，必须携带Access-Control-Allow-External访问服务。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
domain |
是 |
String |
频道推流域名 |
app_name |
是 |
String |
组名或应用名 |
id |
是 |
String |
频道ID。频道唯一标识，为必填项 |
endpoints |
否 |
Array of EndpointItem objects |
频道出流信息 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
hls_package |
否 |
Array of HlsPackageItem objects |
HLS打包信息 |
dash_package |
否 |
Array of DashPackageItem objects |
DASH打包信息 |
mss_package |
否 |
Array of MssPackageItem objects |
MSS打包信息 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
url |
是 |
String |
客户自定义的拉流地址，包括方法、域名、路径和参数 |
stream_selection |
否 |
Array of StreamSelectionItem objects |
从全量流中过滤出一个码率在[min, max]区间的流。如果不需要码率过滤可不选。 |
hls_version |
否 |
String |
HLS版本号 |
segment_duration_seconds |
否 |
Integer |
频道输出分片的时长，为必选项 单位：秒。取值范围：1-10 |
playlist_window_seconds |
否 |
Integer |
频道直播返回分片的窗口长度，为频道输出分片的时长乘以数量后得到的值。实际返回的分片数不小于3个。 单位：秒。取值范围：0 - 86400（24小时转化成秒后的取值） |
encryption |
否 |
Encryption object |
加密信息 |
ads |
否 |
Object |
广告配置 |
ext_args |
否 |
Object |
其他额外参数 |
request_args |
否 |
PackageRequestArgs object |
播放相关配置 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
url |
是 |
String |
客户自定义的拉流地址，包括方法、域名、路径和参数 |
stream_selection |
否 |
Array of StreamSelectionItem objects |
从全量流中过滤出一个码率在[min, max]区间的流。如果不需要码率过滤可不选。 |
segment_duration_seconds |
否 |
Integer |
频道输出分片的时长，为必选项 单位：秒。取值范围：1-10 |
playlist_window_seconds |
否 |
Integer |
频道直播返回分片的窗口长度，为频道输出分片的时长乘以数量后得到的值。实际返回的分片数不小于3个。 单位：秒。取值范围：0 - 86400（24小时转化成秒后的取值） |
encryption |
否 |
Encryption object |
加密信息 |
ads |
否 |
Object |
广告配置 |
ext_args |
否 |
Object |
其他额外参数 |
request_args |
否 |
PackageRequestArgs object |
播放相关配置 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
url |
是 |
String |
客户自定义的拉流地址，包括方法、域名、路径和参数 |
stream_selection |
否 |
Array of StreamSelectionItem objects |
从全量流中过滤出一个码率在[min, max]区间的流。如果不需要码率过滤可不选。 |
segment_duration_seconds |
否 |
Integer |
频道输出分片的时长，为必选项 单位：秒。取值范围：1-10 |
playlist_window_seconds |
否 |
Integer |
频道直播返回分片的窗口长度，为频道输出分片的时长乘以数量后得到的值。实际返回的分片数不小于3个。 单位：秒。取值范围：0 - 86400（24小时转化成秒后的取值） |
encryption |
否 |
Encryption object |
加密信息 |
ext_args |
否 |
Object |
其他额外参数 |
delay_segment |
否 |
Integer |
延播时长，单位秒 |
request_args |
否 |
PackageRequestArgs object |
播放相关配置 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
key |
否 |
String |
拉流URL中用于码率过滤的参数 |
max_bandwidth |
否 |
Integer |
最大码率，单位：bps 取值范围：0 - 104,857,600（100Mbps） |
min_bandwidth |
否 |
Integer |
最小码率，单位：bps 取值范围：0 - 104,857,600（100Mbps） |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
key_rotation_interval_seconds |
否 |
Integer |
密钥缓存时间。如果密钥不变，默认缓存七天 |
encryption_method |
否 |
String |
加密方式 |
level |
否 |
String |
取值如下：
默认值：content |
drm_content_id |
是 |
String |
客户生成的DRM内容ID |
system_ids |
是 |
Array of strings |
system_id枚举值 |
auth_info |
是 |
String |
增加到请求消息体header中的鉴权信息 |
km_url |
是 |
String |
获取密钥的DRM地址 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
record |
否 |
Array of RecordRequestArgs objects |
录制播放相关配置 |
timeshift |
否 |
Array of TimeshiftRequestArgs objects |
时移播放相关配置 |
live |
否 |
Array of LiveRequestArgs objects |
直播播放相关配置 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
result_code |
String |
错误码 |
result_msg |
String |
错误描述 |
domain |
String |
推流域名 |
app_name |
String |
组名或应用名，为必填项 |
id |
String |
频道ID。频道唯一标识，为必填项 |
sources |
Array of SourceRsp objects |
推流URL列表。创建频道时，只有入流协议为RTMP_PUSH时，会返回推流URL列表 |
参数 |
参数类型 |
描述 |
|---|---|---|
url |
String |
RTMP推流地址 |
bitrate |
Integer |
码率。 单位：bps。取值范围：0 - 104,857,600（100Mbps） |
width |
Integer |
分辨率对应宽的值。取值范围：0 - 4096（4K） |
height |
Integer |
分辨率对应高的值。取值范围：0 - 2160（4K） |
enable_snapshot |
Boolean |
描述是否使用该流做截图 |
状态码： 400
参数 |
参数类型 |
描述 |
|---|---|---|
result_code |
String |
错误码 |
result_msg |
String |
错误描述 |
domain |
String |
推流域名 |
app_name |
String |
组名或应用名，为必填项 |
id |
String |
频道ID。频道唯一标识，为必填项 |
请求示例
PUT https://{endpoint}/v1/{project_id}/ott/channels/endpoints
{
"domain" : "push.testott.hls.com",
"app_name" : "ott",
"id" : "test",
"endpoints" : [ {
"hls_package" : [ {
"url" : "pull.testott.hls.com/ott/test/index.m3u8",
"stream_selection" : [ {
"key" : "sss",
"max_bandwidth" : 1000,
"min_bandwidth" : 100
} ],
"hls_version" : "1",
"segment_duration_seconds" : 4,
"playlist_window_seconds" : 3600
} ],
"dash_package" : [ {
"url" : "pull.testott.hls.com/ott/test/index.mpd",
"stream_selection" : [ {
"key" : "bitrate=900000-1800000",
"max_bandwidth" : 1800000,
"min_bandwidth" : 900000
} ],
"segment_duration_seconds" : 4,
"playlist_window_seconds" : 3600
} ],
"mss_package" : [ {
"url" : "pull.testott.hls.com/ott/channel/manifest",
"stream_selection" : [ {
"key" : "bitrate=900000-1800000",
"max_bandwidth" : 1800000,
"min_bandwidth" : 900000
} ],
"segment_duration_seconds" : 4,
"playlist_window_seconds" : 3600
} ]
} ]
}
响应示例
状态码： 200
Demo Information
{
"result_code" : "LIVE.100000000",
"result_msg" : "SUCCESS",
"domain" : "push.testott.hls.com",
"app_name" : "ott",
"id" : "test"
}
状态码： 400
Error response
{
"result_code" : "LIVE.100011001",
"result_msg" : "param check failed",
"domain" : "push.testott.hls.com",
"app_name" : "ott",
"id" : ""
}
状态码
状态码 |
描述 |
|---|---|
200 |
Demo Information |
400 |
Error response |
错误码
请参见错误码。
