视频直播 LIVE-查询频道信息:响应参数
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
total |
Integer |
总频道数 |
channels |
Array of CreateOttChannelInfoReq objects |
频道信息 |
参数 |
参数类型 |
描述 |
---|---|---|
domain |
String |
频道推流 域名 |
app_name |
String |
组名或应用名 |
id |
String |
频道ID。频道唯一标识,为必填项。 |
name |
String |
频道名。可选配置 |
state |
String |
频道状态
|
input |
InputStreamInfo object |
频道入流信息 |
encoder_settings |
Array of encoder_settings objects |
转码模板配置 |
record_settings |
record_settings object |
回看录制的配置信息。 |
endpoints |
Array of EndpointItem objects |
频道出流信息 |
encoder_settings_expand |
EncoderSettingsExpand object |
音频输出配置 |
参数 |
参数类型 |
描述 |
---|---|---|
input_protocol |
String |
频道入流协议
|
sources |
Array of SourcesInfo objects |
频道主源流信息。入流协议为RTMP_PUSH和SRT_PUSH时,非必填项。其他情况下,均为必填项。 |
secondary_sources |
Array of SecondarySourcesInfo objects |
备入流数组,非必填项。如果有备入流,则主备入流必须保证路数、codec和分辨率均一致。入流协议为RTMP_PUSH时,无需填写。 |
failover_conditions |
FailoverConditions object |
非必填,频道供应商提供的主备音视频流URL切换的配置。 |
max_bandwidth_limit |
Integer |
当入流协议为HLS_PULL时,需要配置的最大带宽。 用户提供的拉流URL中,针对不同码率的音视频,均会携带带宽参数“BANDW IDT H”。
|
ip_port_mode |
Boolean |
当推流协议为SRT_PUSH时,如果配置了直推源站,编码器不支持输入streamid,需要打开设置为true |
ip_whitelist |
String |
SRT_PUSH类型时,客户push ip白名单 |
scte35_source |
String |
广告的scte35信号源。 仅HLS_PULL类型的频道支持此配置,且目前仅支持SEGMENTS。 |
ad_triggers |
Array of strings |
广告触发器配置。 包含如下取值:
|
audio_selectors |
Array of InputAudioSelector objects |
设置音频选择器,最多设置8个音频选择器 |
参数 |
参数类型 |
描述 |
---|---|---|
url |
String |
频道源流URL,用于外部拉流 |
bitrate |
Integer |
码率。无需直播转码时,此参数为必填项 单位:bps。取值范围:(0,104,857,600](100Mbps) |
width |
Integer |
分辨率对应宽的值,非必填项 取值范围:0 - 4096(4K) |
height |
Integer |
分辨率对应高的值,非必填项 取值范围:0 - 2160(4K) |
enable_snapshot |
Boolean |
描述是否使用该流做截图 |
bitrate_for3u8 |
Boolean |
是否使用bitrate来固定码率。默认值:false |
passphrase |
String |
协议为SRT_PUSH时的加密信息 |
backup_urls |
Array of strings |
备入流地址列表 |
stream_id |
String |
频道为SRT_PULL类型时,拉流地址的Stream ID。 |
latency |
Integer |
频道为SRT_PULL类型时的拉流时延。 |
参数 |
参数类型 |
描述 |
---|---|---|
url |
String |
频道源流URL,用于外部拉流 |
bitrate |
Integer |
码率。无需直播转码时,此参数为必填项 单位:bps。取值范围:(0,104,857,600](100Mbps) |
width |
Integer |
分辨率对应宽的值,非必填项 取值范围:0 - 4096(4K) |
height |
Integer |
分辨率对应高的值,非必填项 取值范围:0 - 2160(4K) |
bitrate_for3u8 |
Boolean |
是否使用bitrate来固定码率。默认值:false |
passphrase |
String |
协议为SRT_PUSH时的加密信息 |
backup_urls |
Array of strings |
备入流地址列表 |
stream_id |
String |
频道为SRT_PULL类型时,拉流地址的Stream ID。 |
latency |
Integer |
频道为SRT_PULL类型时的拉流时延。 |
参数 |
参数类型 |
描述 |
---|---|---|
input_loss_threshold_msec |
Integer |
入流停止的时长阈值。到达此阈值后,自动触发主备切换。 单位:毫秒,取值范围:0 - 3600000。 非必填,默认填2000ms。 |
input_preference |
String |
以主入流URL为第一优先级(PRIMARY)或主备URL平等切换(EQUAL)。 如果是平等切换时,使用的是备URL,不会自动切换至主URL。 非必填,默认值为EQUAL。 |
参数 |
参数类型 |
描述 |
---|---|---|
name |
String |
音频选择器的名称。仅支持大小写字母、数字、中划线和下划线。 同一个频道中每个选择器的名称需要唯一。 |
selector_settings |
AudioSelectorSettings object |
设置音频选择器 |
参数 |
参数类型 |
描述 |
---|---|---|
audio_language_selection |
AudioSelectorLangSelection object |
设置语言选择器 |
audio_pid_selection |
AudioSelectorPidSelection object |
设置PID选择器 |
参数 |
参数类型 |
描述 |
---|---|---|
language_code |
String |
语言简称,输入2或3个小写字母的语言代码。 |
language_selection_policy |
String |
语言输出策略。 取值如下:
|
参数 |
参数类型 |
描述 |
---|---|---|
rollingbuffer_duration |
Integer |
最大回看录制时长。在此时间段内会连续不断的录制,为必选项 单位:秒。取值为“0”时,表示不支持录制;最大支持录制14天 |
参数 |
参数类型 |
描述 |
---|---|---|
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 |
播放相关配置 |
ad_marker |
Array of strings |
广告标识。 HLS取值:["ENHANCED_SCTE35"]。 |
参数 |
参数类型 |
描述 |
---|---|---|
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 |
播放相关配置 |
ad_marker |
String |
广告标识。 DASH取值:"xml+bin"。 |
参数 |
参数类型 |
描述 |
---|---|---|
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 |
resource_id |
String |
客户生成的DRM内容ID |
system_ids |
Array of strings |
system_id枚举值。 取值如下:
|
url |
String |
获取密钥的DRM地址 |
speke_version |
String |
drm speke 版本号 当前只支持1.0 |
request_mode |
String |
请求模式。 取值如下:
|
http_headers |
Array of HttpHeader objects |
需要添加在drm请求头中的鉴权信息。最多支持配置5个。 仅direct_http请求模式支持配置http_headers。 |
urn |
String |
functiongraph_proxy请求模式需要提供functiongraph的urn。 |
参数 |
参数类型 |
描述 |
---|---|---|
record |
Array of RecordRequestArgs objects |
录制播放相关配置 |
timeshift |
Array of TimeshiftRequestArgs objects |
时移播放相关配置 |
live |
Array of LiveRequestArgs objects |
直播播放相关配置 |
参数 |
参数类型 |
描述 |
---|---|---|
start_time |
String |
开始时间 |
end_time |
String |
结束时间 |
format |
String |
格式 |
unit |
String |
单位 |
参数 |
参数类型 |
描述 |
---|---|---|
audio_descriptions |
Array of audio_descriptions objects |
音频输出配置的描述信息 |
参数 |
参数类型 |
描述 |
---|---|---|
name |
String |
音频输出配置的名称。仅支持大小写字母,数字,中划线(-),下划线(_)。 同一个频道不同的音频输出配置名称,不允许重复。 |
audio_selector_name |
String |
音频选择器名称 |
language_code_control |
String |
语言代码控制。这里的设置不会修改音频实际的语言,只会修改音频对外展示的语言。 包含如下选项:
|
language_code |
String |
语言代码,输入2或3个小写字母。 |
stream_name |
String |
流名称 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
result_code |
String |
错误码 |
result_msg |
String |
错误描述 |
domain |
String |
推流域名 |
app_name |
String |
组名或应用名,为必填项 |
id |
String |
频道ID。频道唯一标识,为必填项 |