AgoraLiveTranscoding Class Reference

Inherits from NSObject
Declared in AgoraObjects.h

Overview

A class for managing user-specific CDN live audio/video transcoding settings.

  size

Size of the video (width and height).

@property (assign, nonatomic) CGSize size

Discussion

  • If you push video streams to the CDN, set the value of width × height to at least 64 × 64 (px), or the SDK will adjust it to 64 × 64 (px).
  • If you push audio streams to the CDN, set the value of width × height to 0 × 0 (px).

Declared In

AgoraObjects.h

  videoBitrate

Bitrate of the CDN live output video stream.

@property (assign, nonatomic) NSInteger videoBitrate

Discussion

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.

Declared In

AgoraObjects.h

  videoFramerate

Frame rate of the CDN live output video stream.

@property (assign, nonatomic) NSInteger videoFramerate

Discussion

The default value is 15 fps, and the value range is (0,30].

Note: Agora adjusts all values over 30 to 30.

Declared In

AgoraObjects.h

  lowLatency

Latency mode. DEPRECATED from v2.8.0

@property (assign, nonatomic) BOOL lowLatency

Discussion

  • YES: Low latency with unassured quality.
  • NO:（Default）High latency with assured quality.

Declared In

AgoraObjects.h

  videoGop

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

@property (assign, nonatomic) NSInteger videoGop

Declared In

AgoraObjects.h

  videoCodecProfile

Video codec profile type

@property (assign, nonatomic) AgoraVideoCodecProfileType videoCodecProfile

Discussion

Set it as 66, 77, or 100 (default), see AgoraVideoCodecProfileType.

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

Declared In

AgoraObjects.h

  transcodingUsers

An AgoraLiveTranscodingUser object managing the user layout configuration in the CDN live stream. Agora supports a maximum of 17 transcoding users in a CDN live stream channel. See AgoraLiveTranscodingUser.

@property (copy, nonatomic) NSArray<AgoraLiveTranscodingUser*> *transcodingUsers

Declared In

AgoraObjects.h

  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.

@property (copy, nonatomic) NSString *transcodingExtraInfo

Declared In

AgoraObjects.h

  watermark

The watermark image added to the CDN live publishing stream.

@property (strong, nonatomic) AgoraImage *watermark

Discussion

The audience of the CDN live publishing stream can see the watermark. Ensure that the format of the image is PNG.

See AgoraImage for the definition of the watermark.

Declared In

AgoraObjects.h

  backgroundImage

The background image added to the CDN live publishing stream.

@property (strong, nonatomic) AgoraImage *backgroundImage

Discussion

The audience of the CDN live publishing stream can see the background image. See AgoraImage for the definition of the background image.

Declared In

AgoraObjects.h

  backgroundColor

The background color in RGB hex value.

@property (strong, nonatomic) COLOR_CLASS *backgroundColor

Discussion

Value only, do not include a #. For example, 0xFFB6C1 (light pink). The default value is 0x000000 (black).

COLOR_CLASS is a general name for the type:

  • iOS: UIColor
  • macOS: NSColor

Declared In

AgoraObjects.h

  audioSampleRate

Self-defined audio sample rate: AgoraAudioSampleRateType.

@property (assign, nonatomic) AgoraAudioSampleRateType audioSampleRate

Declared In

AgoraObjects.h

  audioBitrate

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

@property (assign, nonatomic) NSInteger audioBitrate

Declared In

AgoraObjects.h

  audioChannels

Agora’s self-defined audio channel type. Agora recommends choosing 1 or 2. Special players are required if you choose 3, 4, or 5:

@property (assign, nonatomic) NSInteger audioChannels

Discussion

  • 1: (Default) Mono
  • 2: Two-channel stereo
  • 3: Three-channel stereo
  • 4: Four-channel stereo
  • 5: Five-channel stereo

Declared In

AgoraObjects.h

  audioCodecProfile

Audio codec profile. See AgoraAudioCodecProfileType.

@property (assign, nonatomic) AgoraAudioCodecProfileType audioCodecProfile

Discussion

The default value is AgoraAudioCodecProfileLCAAC(0).

Declared In

AgoraObjects.h

+ defaultTranscoding

Creates a default transcoding object.

+ (AgoraLiveTranscoding *_Nonnull)defaultTranscoding

Return Value

Default AgoraLiveTranscoding object.

Declared In

AgoraObjects.h