ZegoMixerTask Class Reference

Inherits from NSObject
Declared in ZegoExpressDefines.h

Overview

This class is the configuration class of the stream mixing task. When a stream mixing task is requested to the ZEGO RTC server, the configuration of the stream mixing task is required. This class describes the detailed configuration information of this stream mixing task.

  taskID

Mix stream task ID, a string of up to 256 characters. You cannot include URL keywords, otherwise publishing stream and playing stream will fails. Only support numbers, English characters and ‘~’, ‘!’, ‘@’, ‘$’, ‘%’, ‘^’, ‘&’, ‘*’, ‘(’, ‘)’, ‘_’, ‘+’, ‘=’, ‘-’, ‘`’, ‘;’, ‘’’, ‘,’, ‘.’, ‘<’, ‘>’, ‘/’, ‘\’.

@property (nonatomic, copy, readonly) NSString *taskID

Declared In

ZegoExpressDefines.h

+ new

Please use [initWithTaskID:] instead

+ (instancetype)new

Declared In

ZegoExpressDefines.h

– init

Please use [initWithTaskID:] instead

- (instancetype)init

Declared In

ZegoExpressDefines.h

– initWithTaskID:

ZegoMixerTask instance

- (instancetype)initWithTaskID:(NSString *)taskID

Return Value

ZegoMixerTask instance

Declared In

ZegoExpressDefines.h

– setAudioConfig:

Set the audio configuration of the mix stream task object

- (void)setAudioConfig:(ZegoMixerAudioConfig *)audioConfig

Declared In

ZegoExpressDefines.h

– setVideoConfig:

Set the video configuration of the mix stream task object

- (void)setVideoConfig:(ZegoMixerVideoConfig *)videoConfig

Declared In

ZegoExpressDefines.h

– setInputList:

Set the input stream list for the mix stream task object

- (void)setInputList:(NSArray<ZegoMixerInput*> *)inputList

Declared In

ZegoExpressDefines.h

– setOutputList:

Set the output list of the mix stream task object

- (void)setOutputList:(NSArray<ZegoMixerOutput*> *)outputList

Declared In

ZegoExpressDefines.h

– setWatermark:

Set the watermark of the mix stream task object

- (void)setWatermark:(ZegoWatermark *)watermark

Declared In

ZegoExpressDefines.h

– setWhiteboard:

Set the whiteboard of the mix stream task object

- (void)setWhiteboard:(ZegoMixerWhiteboard *)whiteboard

Declared In

ZegoExpressDefines.h

– setBackgroundColor:

Set the background color of the mix stream task object, The color value corresponding to RGBA is 0xRRGGBBAA, and setting the transparency of the background color is currently not supported. The AA in 0xRRGGBBAA is 00. For example, select RGB as #87CEFA as the background color, this parameter passes 0x87CEFA00.

- (void)setBackgroundColor:(int)backgroundColor

Declared In

ZegoExpressDefines.h

– setBackgroundImageURL:

Set the background image of the mix stream task object

- (void)setBackgroundImageURL:(NSString *)backgroundImageURL

Declared In

ZegoExpressDefines.h

– enableSoundLevel:

Enable or disable sound level callback for the task. If enabled, then the remote player can get the soundLevel of every stream in the inputlist by [onMixerSoundLevelUpdate] callback.

- (void)enableSoundLevel:(BOOL)enable

Declared In

ZegoExpressDefines.h

– setStreamAlignmentMode:

Setting the stream mixing alignment mode

- (void)setStreamAlignmentMode:(ZegoStreamAlignmentMode)mode

Declared In

ZegoExpressDefines.h

– setUserData:length:

Set custom user data, the length is no more than 1000.Note that only data with length will be read by SDK. If the length is greater than the actual length of data, the SDK will read the data according to the actual length of data.

- (void)setUserData:(NSData *)data length:(int)length

Declared In

ZegoExpressDefines.h

– setAdvancedConfig:

Set advanced configuration, such as specifying video encoding and others. If you need to use it, contact ZEGO technical support.

- (void)setAdvancedConfig:(NSDictionary<NSString*,NSString*> *)config

Declared In

ZegoExpressDefines.h

– setMinPlayStreamBufferLength:

Description: Sets the lower limit of the interval range for the adaptive adjustment of the stream playing cache of the stream mixing server. In the real-time chorus KTV scenario, slight fluctuations in the network at the push end may cause the mixed stream to freeze. At this time, when the audience pulls the mixed stream, there is a high probability of the problem of freeze. By adjusting the lower limit of the interval range for the adaptive adjustment of the stream playing cache of the stream mixing server, it can optimize the freezing problem that occurs when playing mixing streams at the player end, but it will increase the delay. It is not set by default, that is, the server uses its own configuration values. It only takes effect for the new input stream setting, and does not take effect for the input stream that has already started mixing.Value Range: [0,10000], exceeding the maximum value will result in a failure of the stream mixing request. On web platforms, this property does not take effect.

- (void)setMinPlayStreamBufferLength:(int)minPlayStreamBufferLength

Declared In

ZegoExpressDefines.h