CloudHub 文档中心
下载中心 文档中心

RTC 实时音视频


CloudHub JSSDK

LiveTranscoding

说明:关于直播推流的 LiveTranscoding 的数据定义,数据为 JSON 结构。 调用 setLiveTranscoding 时通过指定 LiveTranscoding 设置直播推流。

名称描述
width:number推流视频的总宽度,默认值 640,单位为像素。
* 如果推视频流,width 值不得低于 64,否则 ChoudHub 会调整为 64。
* 如果推音频流,请将 width 和 height 设为 0。
height:number推流视频的总高度,默认值 360,单位为像素。
* 如果推视频流,height 值不得低于 64,否则 ChoudHub 会调整为 64。
* 如果推音频流,请将 width 和 height 设为 0。
videoBitrate:number用于直播推流的输出视频的码率,单位为 Kbps。 正整数,默认值为 400 Kbps,取值范围为 [1,1000000]。 你可以参考” 视频分辨率表格 进行设置。如果设置的码率超出合理范围,CloudHub 服务器会在合理区间内自动调整码率值。
videoFramerate:number用于直播推流的输出视频的帧率,单位为 fps。 正整数,默认值为 15 fps,取值范围为 [1,30]。 服务器会将高于 30 的帧率设置改为 30。
audioSampleRate:number用于直播推流的输出音频的采样率
* 32000: 音频采样率 32 kHz
* 44100:(默认值)音频采样率 44.1 kHz
* 48000: 音频采样率 48 kHz
audioBitrate:number用于直播推流的输出音频的码率,单位为 Kbps。 正整数,默认值为 48,最大值为 128。
audioChannels:number用于直播推流的输出音频的声道数 默认值为 1。取值范围为 [1,2] 中的整型。
* 1: (默认值)单声道
* 2: 双声道
audioCodecProfile:number用于旁路推流的输出视频的编码规格,默认值为 0
可以设置为 0 和 1。如果设置其他值,ChoudHub 会统一设为默认值 0。
* 0: LC-AAC 规格,表示基本音频编码规格。
* 1: HE-AAC 规格,表示高效音频编码规格。
videoGop:number用于直播推流的输出视频的 GOP,单位为帧。 正整数,默认值为 30 帧,取值范围为 [1,10000]。
videoCodecProfile:number用于直播推流的输出视频的编码规格,默认值为 100
可以设置为 66、77 或 100。如果设置其他值,ChoudHub 会统一设为默认值 100。
* 66: Baseline 级别的视频编码规格,一般用于低阶或需要额外容错的应用,比如视频通话、手机视频等。
* 77: Main 级别的视频编码规格,一般用于主流消费类电子产品,如 mp4、便携的视频播放器、PSP 和 iPad 等。
* 100(默认): High 级别的视频编码规格,一般用于广播及视频碟片存储,高清电视。
streamCount:number参与合图的流数量,默认 0,最多 24 路流。
backgroundColor:number背景色
默认 0x000000,必须是 16 进制格式。 取值范围为 [0x000000, 0xffffff]。
transcodingStreams:array用于管理参与直播推流的视频转码合图的流,类型为数组,数组项为 TranscodingStream。
最多支持 24 人同时参与转码合图。具体设置见” 本文档的 TranscodingStream 说明”。

结构例如:

{
    "width": 640,
    "height": 360, 
    "videoBitrate": 400,
    "videoFramerate": 15,
    "audioSampleRate": 48000,
    "audioBitrate": 48,
    "audioChannels": 1,
    "audioCodecProfile": 0,
    "videoGop": 30,
    "videoCodecProfile": 100,
    "streamCount": 1,
    "backgroundColor": 0x000000,
    "transcodingStreams": [{
        "x": 0,
        "y": 0,
        "width": 640,
        "height": 360,
        "zOrder": 0,
        "uid": "123456",
        "type": 'video',
        "sourceID": 'default_source_id'
    }]
}

TranscodingStream

说明:在调用 setLiveTranscoding 时用于管理参与 CDN 直播的视频转码合图的流,类型为 object。

名称描述
uid:string流的用户 id
type:string流的类型
sourceID:string流的 sourceID
width:number视频帧宽度
整数,取值范围为 [0,10000],默认值为 640。
height:number视频帧高度
整数,取值范围为 [0,10000],默认值为 360。
x:number视频帧左上角的横轴位置
整数,取值范围为 [0,10000],默认值为 0。
y:number视频帧左上角的纵轴位置
整数,取值范围为 [0,10000],默认值为 0。
zOrder:number直播视频上流视频帧的图层编号
整数,取值范围为 [0,100]。
最小值为 0(默认值),表示该区域图像位于最下层。
最大值为 100,表示该区域图像位于最上层。