agora::rtc::LiveTranscoding Struct Reference

Public Member Functions
	LiveTranscoding ()

Public Attributes
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

Detailed Description

A struct for managing CDN live audio/video transcoding settings.

Constructor & Destructor Documentation

LiveTranscoding()

agora::rtc::LiveTranscoding::LiveTranscoding ( )

inline

Member Data Documentation

width

int agora::rtc::LiveTranscoding::width

The width of the video in pixels. The default value is 360.

• When pushing video streams to the CDN, the value range of width is [64,1920]. If the value is less than 64, Agora server automatically adjusts it to 64; if the value is greater than 1920, Agora server automatically adjusts it to 1920.
• When pushing audio streams to the CDN, set width and height as 0.

height

int agora::rtc::LiveTranscoding::height

The height of the video in pixels. The default value is 640.

• When pushing video streams to the CDN, the value range of height is [64,1080]. If the value is less than 64, Agora server automatically adjusts it to 64; if the value is greater than 1080, Agora server automatically adjusts it to 1080.
• When pushing audio streams to the CDN, set width and height as 0.

videoBitrate

int agora::rtc::LiveTranscoding::videoBitrate

Bitrate of the CDN live output video stream. The default value is 400 Kbps.

Set this parameter according to the Video Bitrate Table. If you set a bitrate beyond the proper range, the SDK automatically adapts it to a value within the range.

videoFramerate

int agora::rtc::LiveTranscoding::videoFramerate

Frame rate of the output video stream set for the CDN live streaming. The default value is 15 fps, and the value range is (0,30].

Note

The Agora server adjusts any value over 30 to 30.

lowLatency

bool agora::rtc::LiveTranscoding::lowLatency

Deprecated:

Latency mode:

• true: Low latency with unassured quality.
• false: (Default) High latency with assured quality.

videoGop

int agora::rtc::LiveTranscoding::videoGop

Video GOP in frames. The default value is 30 fps.

videoCodecProfile

VIDEO_CODEC_PROFILE_TYPE agora::rtc::LiveTranscoding::videoCodecProfile

Self-defined video codec profile: VIDEO_CODEC_PROFILE_TYPE.

Note

If you set this parameter to other values, Agora adjusts it to the default value of 100.

backgroundColor

unsigned int agora::rtc::LiveTranscoding::backgroundColor

The background color in RGB hex value. Value only. Do not include a preceeding #. For example, 0xFFB6C1 (light pink). The default value is 0x000000 (black).

videoCodecType

VIDEO_CODEC_TYPE_FOR_STREAM agora::rtc::LiveTranscoding::videoCodecType

The video codec type of the output video stream. See VIDEO_CODEC_TYPE_FOR_STREAM.

Since

v3.2.0

userCount

unsigned int agora::rtc::LiveTranscoding::userCount

The number of users in the interactive live streaming.

The value range is [0,17].

transcodingUsers

TranscodingUser* agora::rtc::LiveTranscoding::transcodingUsers

TranscodingUser

transcodingExtraInfo

const char* agora::rtc::LiveTranscoding::transcodingExtraInfo

Reserved property. Extra user-defined information to send SEI for the H.264/H.265 video stream to the CDN live client. Maximum length: 4096 Bytes.

For more information on SEI frame, see SEI-related questions.

metadata

const char* agora::rtc::LiveTranscoding::metadata

Deprecated:

The metadata sent to the CDN live client defined by the RTMP or HTTP-FLV metadata.

watermark

RtcImage* agora::rtc::LiveTranscoding::watermark

The watermark on the live video. The format must be in the PNG format. See RtcImage. You can add a watermark or use an array to add multiple watermarks. This parameter is used in conjunction with watermarkCount.

watermarkCount

unsigned int agora::rtc::LiveTranscoding::watermarkCount

The number of watermarks on the live video. The total number of watermarks and background images must be greater than or equal to 0 and less than or equal to 10. This parameter is used in conjunction with watermark.

Since

v3.6.0

backgroundImage

RtcImage* agora::rtc::LiveTranscoding::backgroundImage

The background image on the live video. The format must be in the PNG format. See RtcImage. You can add a background image or use an array to add multiple background images. This parameter is used in conjunction with backgroundImageCount.

backgroundImageCount

unsigned int agora::rtc::LiveTranscoding::backgroundImageCount

The number of background images on the live video. The total number of watermarks and background images must be greater than or equal to 0 and less than or equal to 10. This parameter is used in conjunction with backgroundImage.

audioSampleRate

AUDIO_SAMPLE_RATE_TYPE agora::rtc::LiveTranscoding::audioSampleRate

Self-defined audio-sample rate: AUDIO_SAMPLE_RATE_TYPE.

audioBitrate

int agora::rtc::LiveTranscoding::audioBitrate

Bitrate of the CDN live audio output stream. The default value is 48 Kbps, and the highest value is 128.

audioChannels

int agora::rtc::LiveTranscoding::audioChannels

The numbder of audio channels for the CDN live stream. Agora recommends choosing 1 (mono), or 2 (stereo) audio channels. Special players are required if you choose option 3, 4, or 5:

• 1: (Default) Mono.
• 2: Stereo.
• 3: Three audio channels.
• 4: Four audio channels.
• 5: Five audio channels.

audioCodecProfile

AUDIO_CODEC_PROFILE_TYPE agora::rtc::LiveTranscoding::audioCodecProfile

Self-defined audio codec profile: AUDIO_CODEC_PROFILE_TYPE.

advancedFeatures

LiveStreamAdvancedFeature* agora::rtc::LiveTranscoding::advancedFeatures

The advanced feature of the RTMP or RTMPS streaming with transcoding. See LiveStreamAdvancedFeature.

advancedFeatureCount

unsigned int agora::rtc::LiveTranscoding::advancedFeatureCount

The number of the enabled advanced feature. The default value is 0.