Agora C++ API Reference for All Platforms

Loading...
Searching...
No Matches
Public Member Functions | Public Attributes | List of all members
agora::rtc::LiveTranscoding Struct Reference

`#include <AgoraBase.h>`

## 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

## 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

The encoding bitrate (Kbps) of the video. This parameter does not need to be set; keeping the default value `STANDARD_BITRATE` is sufficient. The SDK automatically matches the most suitable bitrate based on the video resolution and frame rate you have set. For the correspondence between video resolution and frame rate, see `Video profile`.

## ◆ videoFramerate

int agora::rtc::LiveTranscoding::videoFramerate

Frame rate (fps) of the output video stream set for Media Push. The default value is 15. The value range is (0,30].

Note
  The Agora server adjusts any value over 30 to 30.

## ◆ lowLatency

bool agora::rtc::LiveTranscoding::lowLatency

Deprecated This member is deprecated. Latency mode:

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

## ◆ videoGop

int agora::rtc::LiveTranscoding::videoGop

GOP (Group of Pictures) in fps of the video frames for Media Push. The default value is 30.

## ◆ videoCodecProfile

VIDEO_CODEC_PROFILE_TYPE agora::rtc::LiveTranscoding::videoCodecProfile

Video codec profile type for Media Push. Set it as 66, 77, or 100 (default). See `VIDEO_CODEC_PROFILE_TYPE` for details.

Note
  If you set this parameter to any other value, Agora adjusts it to the default value.

## ◆ 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

Video codec profile types for Media Push. See `VIDEO_CODEC_TYPE_FOR_STREAM`.

## ◆ userCount

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

The number of users in the Media Push. The value range is [0,17].

## ◆ transcodingUsers

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

Manages the user layout configuration in the Media Push. Agora supports a maximum of 17 transcoding users in a Media Push channel. See `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, see SEI-related questions.

## ◆ metadata

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

Deprecated Obsolete and not recommended for use. The metadata sent to the CDN client.

## ◆ watermark

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

The watermark on the live video. The image format needs to be PNG. See `RtcImage`. You can add one watermark, or add multiple watermarks using an array. This parameter is used 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 can range from 0 to 10. This parameter is used with `watermark`.

## ◆ backgroundImage

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

The number of background images on the live video. The image format needs to be PNG. See `RtcImage`. You can add a background image or use an array to add multiple background images. This parameter is used 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 can range from 0 to 10. This parameter is used with `backgroundImage`.

## ◆ audioSampleRate

AUDIO_SAMPLE_RATE_TYPE agora::rtc::LiveTranscoding::audioSampleRate

The audio sampling rate (Hz) of the output media stream. See `AUDIO_SAMPLE_RATE_TYPE`.

## ◆ audioBitrate

int agora::rtc::LiveTranscoding::audioBitrate

Bitrate (Kbps) of the audio output stream for Media Push. The default value is 48, and the highest value is 128.

## ◆ audioChannels

int agora::rtc::LiveTranscoding::audioChannels

The number of audio channels for Media Push. Agora recommends choosing 1 (mono), or 2 (stereo) audio channels. Special players are required if you choose 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

Audio codec profile type for Media Push. See `AUDIO_CODEC_PROFILE_TYPE`.

## ◆ advancedFeatures

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

Advanced features of the Media Push with transcoding. See `LiveStreamAdvancedFeature`.

## ◆ advancedFeatureCount

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

The number of enabled advanced features. The default value is 0.