LiveTranscoding
用于配置媒体推流的转码参数。
C++
struct LiveTranscoding {
int width;
int height;
int videoBitrate;
int videoFramerate;
bool lowLatency;
int videoGop;
VIDEO_CODEC_PROFILE_TYPE videoCodecProfile;
unsigned int backgroundColor;
VIDEO_CODEC_TYPE_FOR_STREAM videoCodecType;
unsigned int userCount;
TranscodingUser* transcodingUsers;
const char* transcodingExtraInfo;
const char* metadata;
RtcImage* watermark;
unsigned int watermarkCount;
RtcImage* backgroundImage;
unsigned int backgroundImageCount;
AUDIO_SAMPLE_RATE_TYPE audioSampleRate;
int audioBitrate;
int audioChannels;
AUDIO_CODEC_PROFILE_TYPE audioCodecProfile;
LiveStreamAdvancedFeature* advancedFeatures;
unsigned int advancedFeatureCount;
};
width
视频宽度，单位为像素。默认值为 360。
- 当向 CDN 推送视频流时，
width的取值范围为 [64,1920]。如果小于 64，声网服务器会自动调整为 64；如果大于 1920，会自动调整为 1920。 - 当向 CDN 推送音频流时，请将
width和height设置为 0。
height
视频高度，单位为像素。默认值为 640。
- 当向 CDN 推送视频流时，
height的取值范围为 [64,1080]。如果小于 64，声网服务器会自动调整为 64；如果大于 1080，会自动调整为 1080。 - 当向 CDN 推送音频流时，请将
width和height设置为 0。
videoBitrate
视频编码码率（Kbps）。无需设置该参数，保持默认值 STANDARD_BITRATE 即可。SDK 会根据设置的视频分辨率和帧率自动匹配最合适的码率。有关视频分辨率与帧率的对应关系，详见
Video profile。videoFramerate
媒体推流输出视频流的帧率（fps）。默认值为 15，取值范围为 (0,30]。
信息
声网服务器会将超过 30 的值自动调整为 30。
lowLatency
已废弃。 延迟模式：
- true：低延迟但画质不保证。
- false：（默认）高延迟但画质有保证。
videoGop
媒体推流视频帧的 GOP（图像组）帧率，单位为 fps。默认值为 30。
videoCodecProfile
媒体推流的视频编码器配置文件类型。可设置为 66、77 或 100（默认）。详见 VIDEO_CODEC_PROFILE_TYPE。
信息
如果设置为其他值，声网会自动调整为默认值。
backgroundColor
背景颜色的 RGB 十六进制值，仅值，不包含前缀 #。例如，0xFFB6C1 表示浅粉色。默认值为 0x000000（黑色）。
videoCodecType
媒体推流使用的视频编码器类型。详见 VIDEO_CODEC_TYPE_FOR_STREAM。
userCount
媒体推流中的用户数量。取值范围为 [0,17]。
transcodingUsers
媒体推流中的用户布局配置。最多支持添加 17 个转码用户。详见 TranscodingUser。
transcodingExtraInfo
保留参数。用于向 CDN 客户端发送 H.264/H.265 视频流 SEI 中的用户自定义信息。最大长度为 4096 字节。
metadata
已废弃。不推荐使用。发送给 CDN 客户端的元数据。
watermark
直播视频中的水印。图片格式需为 PNG。你可以添加一个水印，或使用数组添加多个水印。该参数与
watermarkCount 配合使用。详见 RtcImage。watermarkCount
直播视频中的水印数量。水印和背景图像的总数范围为 0 到 10。该参数与
watermark 配合使用。backgroundImage
直播视频中的背景图像。图片格式需为 PNG。你可以添加一个背景图像，或使用数组添加多个背景图像。该参数与
backgroundImageCount 配合使用。详见 RtcImage。backgroundImageCount
直播视频中的背景图像数量。水印和背景图像的总数范围为 0 到 10。该参数与
backgroundImage 配合使用。audioSampleRate
输出媒体流的音频采样率（Hz）。详见 AUDIO_SAMPLE_RATE_TYPE。
audioBitrate
媒体推流的音频输出码率（Kbps）。默认值为 48，最大值为 128。
audioChannels
媒体推流的音频声道数。
- 1：（默认）单声道。
- 2：立体声。
- 3：三声道。
- 4：四声道。
- 5：五声道。
audioCodecProfile
媒体推流的音频编码器配置文件类型。详见 AUDIO_CODEC_PROFILE_TYPE。
advancedFeatures
带转码的媒体推流的高级功能。详见 LiveStreamAdvancedFeature。
advancedFeatureCount
启用的高级功能数量。默认值为 0。