查询媒体直播频道详情。
接口说明
调用本接口查询媒体直播频道详情。
QPS 限制
本接口的单用户 QPS 限制为 50 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ice:GetMediaLiveChannel |
get |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| ChannelId |
string |
是 |
频道 ID。 |
SEGK5KA6KYKAWQQH |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 ID。 |
******11-DB8D-4A9A-875B-275798****** |
| Channel |
object |
频道配置。 |
|
| ChannelId |
string |
频道 ID。 |
SEGK5KA6KYKAWQQH |
| Name |
string |
频道名称。 |
mych |
| State |
string |
频道状态。 可能的返回值包括：IDLE（空闲中）, STARTING（启动中）, RUNNING（运行中）, RECOVERING（恢复中）， STOPPING（停止中）。 |
IDLE |
| InputAttachments |
array<object> |
输入绑定设置。 |
|
|
array<object> |
|||
| InputId |
string |
绑定的输入 ID。 |
SEGK5KA6KYKAWQQH |
| InputName |
string |
输入名称。 |
myinput |
| LanguageName |
string |
语言名称。 |
eng |
| AudioSelectors |
array<object> |
音频选择器列表。 |
|
|
array<object> |
|||
| Name |
string |
音频选择器名称。 |
myselector |
| AudioLanguageSelection |
object |
语言选择器。 |
|
| LanguageCode |
string |
ISO639-2 语言代码。3 字符。 |
eng |
| AudioPidSelection |
object |
PID 选择器。 |
|
| Pid |
integer |
输入源流的 Pid。 |
123 |
| AudioTrackSelection |
array<object> |
track 选择器。 |
|
|
object |
|||
| TrackId |
integer |
输入源流的 TrackId。 |
1 |
| OutputGroups |
array<object> |
输出组配置。 |
|
|
array<object> |
|||
| Name |
string |
输出组名称。 |
group1 |
| Type |
string |
输出组类型。 |
MediaPackage |
| Outputs |
array<object> |
输出列表设置。 |
|
|
array<object> |
|||
| Name |
string |
输出名称。 |
output1 |
| MediaType |
integer |
输出的媒体类型。 |
0 |
| MediaPackageOutputSetting |
object |
输出组类型为 MediaPackage 时的输出设置。 |
|
| NameModifier |
string |
manifest 后缀。 |
480p |
| AudioGroupId |
string |
manifest 音频组 id 设置。 |
audiogroup |
| VideoSettingName |
string |
引用的视频设置名称。 |
myVideo1 |
| AudioSettingNames |
array |
引用的音频设置名称列表。 |
|
|
string |
引用的音频设置名称。 |
myAudio1 |
|
| MediaPackageGroupSetting |
object |
输出组类型为 MediaPackage 时的输出组设置。 |
|
| GroupName |
string |
引用的 MediaPackage 的 GroupName。 |
myPackageGroup |
| ChannelName |
string |
引用的 MediaPackage 的 ChannelName。 |
myPackageChannel |
| MonitorUrl |
string |
输出组监看地址，用于监播。仅当输出组类型为 MediaPackage 类型，查询频道详情时会返回输出组监看地址。 |
rtmp://xxx |
| AudioSettings |
array<object> |
音频设置。 |
|
|
array<object> |
|||
| Name |
string |
音频设置名称。 |
zhuanfengzhuang |
| AudioSelectorName |
string |
音频选择器名称。 |
myselector |
| LanguageCode |
string |
ISO639-2 语言代码，3 字符。 |
eng |
| LanguageName |
string |
语言名称。 |
English |
| AudioCodec |
string |
音频编码类型。 |
aac |
| AudioCodecSetting |
object |
音频编码设置。 |
|
| Profile |
string |
音频编码级别。 |
AAC-LOW |
| Bitrate |
integer |
音频比特率。 |
200000 |
| SampleRate |
integer |
音频采样率。 |
44100 |
| VideoSettings |
array<object> |
视频设置。 |
|
|
array<object> |
|||
| Name |
string |
视频设置名称。 |
video1 |
| Width |
integer |
视频分辨率宽。 |
1280 |
| Height |
integer |
视频分辨率高。 |
720 |
| VideoCodec |
string |
视频编码类型。 |
H264 |
| VideoCodecSetting |
object |
视频编码设置。 |
|
| Rate |
object |
视频编码速率设置。 |
|
| Bitrate |
integer |
视频比特率。 |
2500000 |
| RateControlMode |
string |
视频编码码控规则。 |
ABR |
| MaxBitrate |
integer |
视频编码最大比特率。 |
6000000 |
| BufferSize |
integer |
视频编码缓冲区大小。 |
6000000 |
| Framerate |
object |
视频帧率设置。 |
|
| FramerateControl |
string |
视频帧率设置模式。 |
SPECIFIED |
| FramerateNumerator |
integer |
视频帧率分子。 |
25 |
| FramerateDenominator |
integer |
视频帧率分母。 |
1 |
| Gop |
object |
视频 GOP 设置。 |
|
| GopSizeUnits |
string |
视频 GOP 长度单位。 |
FRAMES |
| GopSize |
integer |
视频 GOP 大小。 |
90 |
| BframesNum |
integer |
B 帧数。 |
3 |
| CodecDetail |
object |
视频编码详情设置。 |
|
| Profile |
string |
视频编码配置。 |
MAIN |
| Level |
string |
视频编码级别。暂不支持。 |
H264_LEVEL_AUTO |
| VideoCodecType |
string |
视频转码方式（普通转码、窄带高清转码等） |
NORMAL |
| CreateTime |
string |
频道创建时间，格式为：yyyy-MM-ddTHH:mm:ssZ（RFC 3339 格式），采用 UTC +0 时区。 |
2024-12-03T06:56:42Z |
| LastStartTime |
string |
频道最近一次启动时间，格式为：yyyy-MM-ddTHH:mm:ssZ（RFC 3339 格式），采用 UTC +0 时区。 如果频道创建后从未启动过，则返回空字符串。 |
2024-12-03T06:56:42Z |
| LastStopTime |
string |
频道最近一次停止时间，格式为：yyyy-MM-ddTHH:mm:ssZ（RFC 3339 格式），采用 UTC +0 时区。 如果频道创建后从未停止过，则返回空字符串。 |
2024-12-03T06:56:42Z |
示例
正常返回示例
JSON格式
{
"RequestId": "******11-DB8D-4A9A-875B-275798******",
"Channel": {
"ChannelId": "SEGK5KA6KYKAWQQH",
"Name": "mych",
"State": "IDLE",
"InputAttachments": [
{
"InputId": "SEGK5KA6KYKAWQQH",
"InputName": "myinput",
"LanguageName": "eng",
"AudioSelectors": [
{
"Name": "myselector",
"AudioLanguageSelection": {
"LanguageCode": "eng"
},
"AudioPidSelection": {
"Pid": 123
},
"AudioTrackSelection": [
{
"TrackId": 1
}
]
}
]
}
],
"OutputGroups": [
{
"Name": "group1",
"Type": "MediaPackage",
"Outputs": [
{
"Name": "output1",
"MediaType": 0,
"MediaPackageOutputSetting": {
"NameModifier": "480p",
"AudioGroupId": "audiogroup"
},
"VideoSettingName": "myVideo1",
"AudioSettingNames": [
"myAudio1"
]
}
],
"MediaPackageGroupSetting": {
"GroupName": "myPackageGroup",
"ChannelName": "myPackageChannel"
},
"MonitorUrl": "rtmp://xxx"
}
],
"AudioSettings": [
{
"Name": "zhuanfengzhuang",
"AudioSelectorName": "myselector",
"LanguageCode": "eng",
"LanguageName": "English",
"AudioCodec": "aac",
"AudioCodecSetting": {
"Profile": "AAC-LOW",
"Bitrate": 200000,
"SampleRate": 44100
}
}
],
"VideoSettings": [
{
"Name": "video1",
"Width": 1280,
"Height": 720,
"VideoCodec": "H264",
"VideoCodecSetting": {
"Rate": {
"Bitrate": 2500000,
"RateControlMode": "ABR",
"MaxBitrate": 6000000,
"BufferSize": 6000000
},
"Framerate": {
"FramerateControl": "SPECIFIED",
"FramerateNumerator": 25,
"FramerateDenominator": 1
},
"Gop": {
"GopSizeUnits": "FRAMES",
"GopSize": 90,
"BframesNum": 3
},
"CodecDetail": {
"Profile": "MAIN",
"Level": "H264_LEVEL_AUTO"
}
},
"VideoCodecType": "NORMAL"
}
],
"CreateTime": "2024-12-03T06:56:42Z",
"LastStartTime": "2024-12-03T06:56:42Z",
"LastStopTime": "2024-12-03T06:56:42Z"
}
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。