CreateMediaLiveChannel - 创建媒体直播频道-智能媒体服务(IMS)-阿里云帮助中心

创建媒体直播频道。

接口说明

调用本接口创建媒体直播频道。

QPS 限制

本接口的单用户 QPS 限制为 50 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ice:CreateMediaLiveChannel

create

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
Name	string	是	频道名称。支持英文+数字+英文短划线(-)、下划线(_)。长度限制英文 64 字符。	mych
InputAttachments	array<object>	是	输入绑定设置
	array<object>	否
InputId	string	是	绑定的输入 ID。	myinput
LanguageName	string	否	语言名称，仅 rtmp 类型输入有效，表示 output 使用的 Name 标签。该字段长度限制为英文 32 字符，支持以下字符类型： Unicode 各国语言的字母：包括拉丁字母（如英语、法语）、中文、阿拉伯字母以及其他语言的字母。数字：允许使用 0-9 的数字字符。英文下划线 (_) 英文中划线 (-) 空格，空格可以出现在字段中间，不能出现在首尾。	English
AudioSelectors	array<object>	否	音频选择器列表。
	array<object>	否
Name	string	是	音频选择器名称。支持英文+数字+英文短划线(-)、下划线(_)。长度限制英文 64 字符。	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 开始。	1
OutputGroups	array<object>	是	输出组配置。
	array<object>	否
Name	string	是	输出组名称。支持英文+数字+英文短划线(-)、下划线(_)。长度限制英文 64 字符。	group1
Type	string	是	输出组类型。目前支持 MediaPackage。	MediaPackage
Outputs	array<object>	是	输出列表设置。
	array<object>	否
Name	string	是	输出名称。支持英文+数字+英文短划线(-)、下划线(_)。长度限制英文 64 字符。	output1
MediaType	integer	否	输出的媒体类型，枚举。可选值： 0：音视频。 1：纯音频。设置为纯音频时，不允许引用视频设置。 2：纯视频。设置为纯视频时，不允许引用音频设置。	0
MediaPackageOutputSetting	object	否	输出组类型为 MediaPackage 时的输出设置。
NameModifier	string	否	manifest 后缀，一般用于子 m3u8 命名。支持英文+数字+英文短划线(-)、下划线(_)。长度限制英文 40 字符。	480p
AudioGroupId	string	否	manifest 音频组 id 设置。通过指定 AudioGroupId，可以将多个音频轨道归为同一组，以便于在播放时选择音轨。支持英文+数字+英文短划线(-)、下划线(_)。长度限制英文 40 字符。	audiogroup
VideoSettingName	string	否	引用的视频设置名称。	myVideo1
AudioSettingNames	array	否	引用的音频设置名称列表。
	string	否	引用的音频设置名称。	myAudio1
MediaPackageGroupSetting	object	否	输出组类型为 MediaPackage 时的输出组设置。
GroupName	string	是	引用的 MediaPackage 的 GroupName。	myPackageGroup
ChannelName	string	是	引用的 MediaPackage 的 ChannelName。	myPackageChannel
AudioSettings	array<object>	否	音频设置。
	array<object>	否
Name	string	是	音频设置名称。支持英文+数字+英文短划线(-)、下划线(_)。长度限制英文 64 字符。	audio1
AudioSelectorName	string	否	音频选择器名称。	a1
LanguageCode	string	否	ISO639-2 语言代码，3 字符。当 selector 选择的音轨对应输出有语言代码，优先使用 selector 的语言代码；若选择器选择的音轨没有语言代码或者没有和选择器匹配的音轨，则使用该语言代码。	eng
LanguageName	string	否	语言名称，仅 rtmp 类型输入有效，表示 output 使用的 Name 标签。该字段长度限制为英文 32 字符，支持以下字符类型： Unicode 各国语言的字母：包括拉丁字母（如英语、法语）、中文、阿拉伯字母以及其他语言的字母。数字：允许使用 0-9 的数字字符。英文下划线 (_) 英文中划线 (-) 空格，空格可以出现在字段中间，不能出现在首尾。	English
AudioCodec	string	否	音频编码类型。若填空则 copy，即随源。可选值：aac，libfdk_aac。	libfdk_aac
AudioCodecSetting	object	否	音频编码设置。
Profile	string	否	音频编码级别。当 codec="aac"时，支持"AAC-LOW"，"AAC-MAIN"。当 codec="libfdk_aac"时，支持："AAC-LOW"，"AAC-HE"，"AAC-HEV2"。	AAC-LOW
Bitrate	integer	否	音频比特率，单位 bps。范围: [8000, 1000000]，需要能被 1000 整除。	200000
SampleRate	integer	否	音频采样率。单位: Hz。取值范围: 22050、32000、44100、48000、96000。	44100
VideoSettings	array<object>	否	视频设置。
	array<object>	否
Name	string	是	视频设置名称。支持英文+数字+英文短划线(-)、下划线(_)。长度限制英文 64 字符。	video1
Width	integer	否	视频分辨率宽，不设置或者设置为 0 则按 Height 自适应缩放。取值范围：对于普通转码，需要满足 max(Width, Height) < 3840，min(Width, Height) < 2160 对于窄带高清转码，需要满足 max(Width, Height) < 1920，min(Width, Height) < 1080	1280
Height	integer	否	视频分辨率高，不设置或者设置为 0 则按 Width 自适应缩放。取值范围：对于普通转码，需要满足 max(Width, Height) < 3840，min(Width, Height) < 2160 对于窄带高清转码，需要满足 max(Width, Height) < 1920，min(Width, Height) < 1080	720
VideoCodec	string	否	视频编码类型。可选值：H264，H265。	H264
VideoCodecSetting	object	否	视频编码设置。
Rate	object	否	视频编码速率设置，不设置则随源。
Bitrate	integer	否	视频比特率，单位 bps。不填或 0 则随源。范围:[50000,6000000]，需要能被 1000 整除。	2500000
RateControlMode	string	否	视频编码码控规则。可选值：CBR、ABR 和 VBR。	ABR
MaxBitrate	integer	否	视频编码最大比特率，单位 bps。范围: [100000, 6000000]，需要能被 1000 整除。	6000000
BufferSize	integer	否	视频编码缓冲区大小，单位 bps。范围: [100000, 6000000]，需要能被 1000 整除。	6000000
Framerate	object	否	视频帧率设置，不设置则随源。
FramerateControl	string	否	视频帧率设置模式。可选值：SPECIFIED（固定帧率），FROM_SOURCE（帧率随源）。	SPECIFIED
FramerateNumerator	integer	否	固定帧率的帧率分子，当视频帧率设置模式为 SPECIFIED 时必传。范围: [1,60]，需要能整除分母。	25
FramerateDenominator	integer	否	固定帧率的帧率分母，当视频帧率设置模式为 SPECIFIED 时必传。范围: [1,60]，需要能被分子整除。	1
Gop	object	否	视频 GOP 设置，不设置则随源。
GopSizeUnits	string	否	视频 GOP 长度单位。可选值：FRAMES（单位帧），SECONDS（单位秒）	FRAMES
GopSize	integer	否	视频 GOP 大小。当长度单位为 SECONDS 时，取值范围为[1, 20]。当长度单位为 FRAMES 时，取值范围为[1, 3000]。	90
BframesNum	integer	否	B 帧数。范围: [1, 3]。	3
CodecDetail	object	否	视频编码详情设置。
Profile	string	否	H264 编码质量等级。BASELINE、HIGH、MAIN。默认为 MAIN。仅 H264 编码器设置生效。	MAIN
Level	string	否	视频编码级别。暂不支持。	H264_LEVEL_AUTO
VideoCodecType	string	否	视频转码方式，枚举。可选值： NORMAL：普通转码。 NBHD：窄带高清转码。不配置时默认为普通转码。	NORMAL

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	****11-DB8D-4A9A-875B-275798****
ChannelId	string	频道 ID。	SEGK5KA6KYKAWQQH

示例

正常返回示例

JSON格式

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "ChannelId": "SEGK5KA6KYKAWQQH"
}

错误码

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

变更历史

更多信息，参考变更详情。