LiveTranscoding

  • Electron

更新时间不可用

旁路推流的转码属性。

TypeScript
export class LiveTranscoding {

  width?: number;

  height?: number;

  videoBitrate?: number;

  videoFramerate?: number;

  lowLatency?: boolean;

  videoGop?: number;

  videoCodecProfile?: VideoCodecProfileType;

  backgroundColor?: number;

  videoCodecType?: VideoCodecTypeForStream;

  userCount?: number;

  transcodingUsers?: TranscodingUser[];

  transcodingExtraInfo?: string;

  metadata?: string;

  watermark?: RtcImage[];

  watermarkCount?: number;

  backgroundImage?: RtcImage[];

  backgroundImageCount?: number;

  audioSampleRate?: AudioSampleRateType;

  audioBitrate?: number;

  audioChannels?: number;

  audioCodecProfile?: AudioCodecProfileType;

  advancedFeatures?: LiveStreamAdvancedFeature[];

  advancedFeatureCount?: number;
}

属性

参数名描述
width

推流视频的总宽度,默认值 360,单位为像素。

  • 如果推视频流,width 取值范围为 [64,1920]。如果取值低于 64,声网服务器会自动调整为 64; 如果取值高于 1920,声网服务器会自动调整为 1920。
  • 如果推音频流,请将 width 和 height 设为 0。
height

推流视频的总高度,默认值 640,单位为像素。

  • 如果推视频流,height 取值范围为 [64,1080]。如果取值低于 64,声网服务器会自动调整为 64; 如果取值高于 1080,声网服务器会自动调整为 1080。
  • 如果推音频流,请将 width 和 height 设为 0。
videoBitrate

视频编码码率,单位为 Kbps。该参数无需设置,保留默认值 STANDARD_BITRATE 即可,SDK 会根据你设定的视频分辨率和帧率自动匹配最合适的码率。有关视频分辨率和帧率的对应关系,详见视频属性。

videoFramerate

用于旁路直播的输出视频的帧率。取值范围是 (0,30],单位为 fps。15 fps 为默认值。

注: 声网服务器会将高于 30 fps 的帧率统一调整为 30 fps。

lowLatency

注: 弃用不建议使用。

低延时模式

  • true: 低延时,不保证画质。
  • false:(默认值)高延时,保证画质。
videoGop

用于旁路直播的输出视频的 GOP (Group of Pictures)。单位为帧。默认值为 30。

videoCodecProfile

用于旁路直播的输出视频的编码规格。可以设置为 66、77 或 100,详见 VideoCodecProfileType。

注: 如果你把这个参数设为其他值,声网服务器会将其调整为默认值。

videoCodecType

用于旁路直播的输出视频的编解码类型。详见 VideoCodecTypeForStream。

transcodingUsers

用于管理参与旁路直播的视频转码合图的用户。最多支持 17 人同时参与转码合图。详见 TranscodingUser。

transcodingExtraInfo

预留参数:用户自定义的发送到旁路推流客户端的信息,用于填充 H264/H265 视频中 SEI 帧内容。长度限制:4096 字节。关于 SEI 的详细信息,详见 SEI 帧相关问题。

backgroundColor

用于旁路直播的输出视频的背景色,格式为 RGB 定义下的十六进制整数,不要带 # 号,如 0xFFB6C1 表示浅粉色。默认0x000000,黑色。

userCount

参与合图的用户数量,默认 0。取值范围为 [0,17]。

metadata

发送给 CDN 客户端的 metadata。

注: 弃用已废弃,不建议使用。

watermark

直播视频上的水印。图片格式需为 PNG。详见 RtcImage。 你可以添加一个水印,或使用数组的方式添加多个水印。该参数与 watermarkCount搭配使用。

backgroundImage

直播视频上的背景图。图片格式需为 PNG。详见 RtcImage。 你可以添加一张背景图,或使用数组的方式添加多张背景图。该参数与 backgroundImageCount 搭配使用。

audioSampleRate

用于旁路推流的输出媒体流的音频采样率 (Hz),详见 AudioSampleRateType。

audioBitrate

用于旁路直播的输出音频的码率。单位为 Kbps,默认值为 48,最大值为 128。

audioChannels

用于旁路直播的输出音频的声道数,默认值为 1。取值范围为 [1,5] 中的整型,建议取 1 或 2。3、4、5 需要特殊播放器支持:

  • 1: (默认)单声道
  • 2: 双声道
  • 3: 三声道
  • 4: 四声道
  • 5: 五声道
audioCodecProfile

用于旁路直播输出音频的编码规格。详见 AudioCodecProfileType。

watermarkCount

直播视频上的水印的数量。水印和背景图的总数量需大于等于 0 且小于等于 10。该参数与 watermark 搭配使用。

backgroundImageCount

直播视频上的背景图的数量。水印和背景图的总数量需大于等于 0 且小于等于 10。该参数与 backgroundImage 搭配使用。

advancedFeatures

转码推流的高级功能。详见 LiveStreamAdvancedFeature。

advancedFeatureCount

开启的高级功能数量。默认值为 0。

表格内容超出当前宽度,可横向滚动查看更多列。

这个页面有帮助吗?