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

Declared In

AgoraObjects.h

  videoBitrate

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

@property (assign, nonatomic) NSInteger videoBitrate

Declared In

AgoraObjects.h

  videoFramerate

Frame rate of the CDN live output video stream. The default value is 15 fps.

@property (assign, nonatomic) NSInteger videoFramerate

Declared In

AgoraObjects.h

  lowLatency

Latency mode:

@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: AgoraVideoCodecProfileType.

@property (assign, nonatomic) AgoraVideoCodecProfileType videoCodecProfile

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.

@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. 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. Value only, do not include a #.

@property (strong, nonatomic) COLOR_CLASS *backgroundColor

Discussion

COLOR_CLASS is a general name for the type:

  • iOS: UIColor
  • MacOS: NSColor

Declared In

AgoraObjects.h

  audioSampleRate

Self-defined audio sampling 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

+ defaultTranscoding

Creates a default transcoding object.

+ (AgoraLiveTranscoding *_Nonnull)defaultTranscoding

Return Value

Default AgoraLiveTranscoding object.

Declared In

AgoraObjects.h