logo
On this page

Struct

ZegoAccurateSeekConfigZegoAudioConfig
ZegoAudioEffectPlayConfigZegoAudioFrameParam
ZegoAudioSourceMixConfigZegoAutoMixerTask
ZegoBarrageMessageInfoZegoBeautifyOption
ZegoBroadcastMessageInfoZegoCanvas
ZegoCDNConfigZegoColorEnhancementParams
ZegoCopyrightedMusicConfigZegoCopyrightedMusicGetLyricConfig
ZegoCopyrightedMusicGetSharedConfigZegoCopyrightedMusicGetSharedConfigV2
ZegoCopyrightedMusicQueryCacheConfigZegoCopyrightedMusicQueryCacheConfigV2
ZegoCopyrightedMusicRequestConfigZegoCopyrightedMusicRequestConfigV2
ZegoCustomAudioConfigZegoCustomVideoCaptureConfig
ZegoCustomVideoProcessConfigZegoCustomVideoRenderConfig
ZegoDataRecordConfigZegoDataRecordProgress
ZegoDeviceInfoZegoDumpDataConfig
ZegoEffectsBeautyParamZegoEngineConfig
ZegoEngineProfileZegoFontStyle
ZegoImageBufferZegoLabelInfo
ZegoLogConfigZegoMediaPlayerResource
ZegoMixerAudioConfigZegoMixerImageInfo
ZegoMixerInputZegoMixerOutput
ZegoMixerOutputRoomInfoZegoMixerOutputVideoConfig
ZegoMixerTaskZegoMixerVideoConfig
ZegoNetWorkResourceCacheZegoNetworkTimeInfo
ZegoPerformanceStatusZegoPlayerConfig
ZegoPlayStreamQualityZegoPosition
ZegoPositionOrientationZegoProxyInfo
ZegoPublishDualStreamConfigZegoPublisherConfig
ZegoPublishStreamQualityZegoReceiveRangeParam
ZegoRectZegoReverbAdvancedParam
ZegoReverbEchoParamZegoRoomConfig
ZegoRoomExtraInfoZegoSceneConfig
ZegoSceneParamZegoScenePlayerConfig
ZegoScenePublisherConfigZegoSceneStreamConfig
ZegoScreenCaptureConfigZegoScreenCaptureSourceInfo
ZegoSEIConfigZegoSoundLevelConfig
ZegoSoundLevelInfoZegoStream
ZegoStreamRelayCDNInfoZegoUser
ZegoVideoConfigZegoVideoFrameParam
ZegoVocalRangeParamZegoVoiceChangerParam
ZegoWatermark

ZegoAccurateSeekConfig

Precise seek configuration

Declared in ZegoDefine.cs

Properties

timeout

timeout
public ulong timeout

The timeout time for precise search; if not set, the SDK internal default is set to 5000 milliseconds, the effective value range is [2000, 10000], the unit is ms

Methods

ZegoAccurateSeekConfig

ZegoAccurateSeekConfig
Declared in ZegoDefine.cs

ZegoAudioConfig

Audio configuration.

Details

Configure audio bitrate, audio channel, audio encoding for publishing stream

Declared in ZegoDefine.cs

Properties

bitrate

bitrate
public int bitrate

Audio bitrate in kbps, default is 48 kbps. The settings before and after publishing stream can be effective

channel

channel
public ZegoAudioChannel channel

Audio channel, default is Mono. The setting only take effect before publishing stream

codecID

codecID
public ZegoAudioCodecID codecID

codec ID, default is ZegoAudioCodecIDDefault. The setting only take effect before publishing stream.WebGL does not support Settings.

Methods

ZegoAudioConfig

ZegoAudioConfig
public void ZegoAudioConfig:this(ZegoAudioConfigPreset.StandardQuality)
Create a default audio configuration (ZegoAudioConfigPresetStandardQuality, 48 kbps, Mono, ZegoAudioCodecIDDefault)
Declared in ZegoDefine.cs

ZegoAudioConfig

ZegoAudioConfig
public void ZegoAudioConfig(ZegoAudioConfigPreset presetType)
Create a audio configuration with preset enumeration values
Declared in ZegoDefine.cs

ZegoAudioEffectPlayConfig

AudioEffectPlayer play configuration.

Declared in ZegoDefine.cs

Properties

playCount

playCount
public uint playCount

The number of play counts. When set to 0, it will play in an infinite loop until the user invoke [stop]. The default is 1, which means it will play only once.

isPublishOut

isPublishOut
public bool isPublishOut

Whether to mix audio effects into the publishing stream, the default is false.

ZegoAudioFrameParam

Parameter object for audio frame.

Details

Including the sampling rate and channel of the audio frame

Declared in ZegoDefine.cs

Properties

sampleRate

sampleRate
public ZegoAudioSampleRate sampleRate

Sampling Rate

channel

channel
public ZegoAudioChannel channel

Audio channel, default is Mono

ZegoAudioSourceMixConfig

Audio source mix config

Details

Used to config whether mix media player, audio effect player and captured system audio into publish stream or not when set audio source.

Declared in ZegoDefine.cs

Properties

mediaPlayerIndexList

mediaPlayerIndexList
public List<int> mediaPlayerIndexList

Media player instance index list.

audioEffectPlayerIndexList

audioEffectPlayerIndexList
public List<int> audioEffectPlayerIndexList

Audio effect player instance index list.

enableMixSystemPlayout

enableMixSystemPlayout
public bool enableMixSystemPlayout

Enable or disable mix captured system audio into publish stream.

enableMixEnginePlayout

enableMixEnginePlayout
public bool enableMixEnginePlayout

Enable or disable mix SDK playout into publish stream.

Methods

ZegoAudioSourceMixConfig

ZegoAudioSourceMixConfig
Declared in ZegoDefine.cs

ZegoAutoMixerTask

Auto mix stream task object.

Details

When using [StartAutoMixerTask] function to start an auto stream mixing task to the ZEGO RTC server, user need to set this parameter to configure the auto stream mixing task, including the task ID, room ID, audio configuration, output stream list, and whether to enable the sound level callback.

  • Use cases: This configuration is required when an auto stream mixing task is requested to the ZEGO RTC server.
  • Caution: As an argument passed when [StartAutoMixerTask] function is called.

Declared in ZegoDefine.cs

Properties

taskID

taskID
public string taskID

Auto stream mixing task id, must be unique in a room.

  • Use cases: User need to set this parameter when initiating an auto stream mixing task.
  • Required: Yes.
  • Recommended value: Set this parameter based on requirements.
  • Value range: A string up to 256 bytes.
  • Caution: When starting a new auto stream mixing task, only one auto stream mixing task ID can exist in a room, that is, to ensure the uniqueness of task ID. You are advised to associate task ID with room ID. You can directly use the room ID as the task ID.Cannot include URL keywords, for example, 'http' and '?' etc, otherwise publishing stream and playing stream will fail. Only support numbers, English characters and '~', '!', '@', '$', '%', '^', '&', '*', '(', ')', '_', '+', '=', '-', '`', ';', '’', ',', '.', '<', '>', '/', ''.

roomID

roomID
public string roomID

Auto stream mixing task id.

  • Use cases: User need to set this parameter when initiating an auto stream mixing task.
  • Required: Yes.
  • Recommended value: Set this parameter based on requirements.
  • Value range: A string up to 128 bytes.
  • Caution: Only support numbers, English characters and '~', '!', '@', '#', '$', '%', '^', '&', '*', '(', ')', '_', '+', '=', '-', '`', ';', '’', ',', '.', '<', '>', ''.If you need to communicate with the Web SDK, please do not use '%'.

audioConfig

audioConfig
public ZegoMixerAudioConfig audioConfig

The audio config of the auto mixer task.

  • Use cases: If user needs special requirements for the audio config of the auto stream mixing task, such as adjusting the audio bitrate, user can set this parameter as required. Otherwise, user do not need to set this parameter.
  • Required: No.
  • Default value: The default audio bitrate is 48 kbps, the default audio channel is ZEGO_AUDIO_CHANNEL_MONO, the default encoding ID is ZEGO_AUDIO_CODEC_ID_DEFAULT, and the default multi-channel audio stream mixing mode is ZEGO_AUDIO_MIX_MODE_RAW.
  • Recommended value: Set this parameter based on requirements.

outputList

outputList
public List<ZegoMixerOutput> outputList

The output list of the auto stream mixing task, items in the list are URL or stream ID, if the item set to be URL format, only RTMP URL surpported, for example rtmp://xxxxxxxx.

  • Use cases: User need to set this parameter to specify the mix stream output target when starting an auto stream mixing task.
  • Required: Yes.

enableSoundLevel

enableSoundLevel
public bool enableSoundLevel

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

  • Use cases: This parameter needs to be configured if user need the sound level information of every stream when an auto stream mixing task started.
  • Required: No.
  • Default value: false.
  • Recommended value: Set this parameter based on requirements.

streamAlignmentMode

streamAlignmentMode
public ZegoStreamAlignmentMode streamAlignmentMode

Stream mixing alignment mode.

Methods

ZegoAutoMixerTask

ZegoAutoMixerTask
public void ZegoAutoMixerTask()
Create a auto mix stream task object
Declared in ZegoDefine.cs

ZegoBarrageMessageInfo

Barrage message info.

Details

The received object of the room barrage message, including the message content, message ID, sender, sending time

Declared in ZegoDefine.cs

Properties

message

message
public string message

message content

messageID

messageID
public string messageID

message id

sendTime

sendTime
public ulong sendTime

Message send time, UNIX timestamp, in milliseconds.

fromUser

fromUser
public ZegoUser fromUser

Message sender.Please do not fill in sensitive user information in this field, including but not limited to mobile phone number, ID number, passport number, real name, etc.

ZegoBeautifyOption

Beauty configuration options.

Details

Configure the parameters of skin peeling, whitening and sharpening

Declared in ZegoDefine.cs

Properties

polishStep

polishStep
public double polishStep

The sample step size of beauty peeling, the value range is [0,1], default 0.2

whitenFactor

whitenFactor
public double whitenFactor

Brightness parameter for beauty and whitening, the larger the value, the brighter the brightness, ranging from [0,1], default 0.5

sharpenFactor

sharpenFactor
public double sharpenFactor

Beauty sharpening parameter, the larger the value, the stronger the sharpening, value range [0,1], default 0.1

ZegoBroadcastMessageInfo

Broadcast message info.

Details

The received object of the room broadcast message, including the message content, message ID, sender, sending time

Declared in ZegoDefine.cs

Properties

message

message
public string message

message content

messageID

messageID
public ulong messageID

message id

sendTime

sendTime
public ulong sendTime

Message send time, UNIX timestamp, in milliseconds.

fromUser

fromUser
public ZegoUser fromUser

Message sender.Please do not fill in sensitive user information in this field, including but not limited to mobile phone number, ID number, passport number, real name, etc.

ZegoCDNConfig

CDN config object.

Details

Includes CDN URL and authentication parameter string

Declared in ZegoDefine.cs

Properties

url

url
public string url

CDN URL

authParam

authParam
public string authParam

Auth param of URL. Please contact ZEGO technical support if you need to use it, otherwise this parameter can be ignored (set to null or empty string).

protocol

protocol
public string protocol

URL supported protocols, candidate values are "tcp" and "quic". If there are more than one, separate them with English commas and try them in order. Please contact ZEGO technical support if you need to use it, otherwise this parameter can be ignored (set to null or empty string).

quicVersion

quicVersion
public string quicVersion

QUIC version。 If [protocol] has the QUIC protocol, this information needs to be filled in. If there are multiple version numbers, separate them with commas. Please contact ZEGO technical support if you need to use it, otherwise this parameter can be ignored (set to null or empty string).

httpdns

httpdns
public ZegoHttpDNSType httpdns

customized httpdns service. This feature is only supported for playing stream currently.

quicConnectMode

quicConnectMode
public int quicConnectMode

QUIC establishes link mode. If the value is 1, quic 0 rtt is used preferentially to establish link. Otherwise, the link is established normally. If [protocol] has the QUIC protocol, this value takes effect.

customParams

customParams
public string customParams

custom param of URL. Please contact ZEGO technical support if you need to use it, otherwise this parameter can be ignored (set to null or empty string).

Methods

ZegoCDNConfig

ZegoCDNConfig
public void ZegoCDNConfig()
Declared in ZegoDefine.cs

ZegoCanvas

View object.

Details

Configure view object, view Mode, background color

Declared in ZegoDefine.cs

Properties

view

view
public IntPtr view

View object

viewMode

viewMode
public ZegoViewMode viewMode

View mode, default is ZegoViewModeAspectFit

backgroundColor

backgroundColor
public int backgroundColor

Background color, the format is 0xRRGGBB, default is black, which is 0x000000

ZegoColorEnhancementParams

Color enhancement params.

Declared in ZegoDefine.cs

Properties

intensity

intensity
public float intensity

color enhancement intensity.

  • Value range: [0,1], the larger the value, the stronger the intensity of color enhancement.
  • Default value: 0.

skinToneProtectionLevel

skinToneProtectionLevel
public float skinToneProtectionLevel

Skin tone protection level.

  • Value range: [0,1], the larger the value, the greater the level of skin protection.
  • Default value: 1.

lipColorProtectionLevel

lipColorProtectionLevel
public float lipColorProtectionLevel

Lip color protection level.

  • Value range: [0,1], the larger the value, the greater the level of lip color protection.
  • Default value: 0.

Methods

ZegoColorEnhancementParams

ZegoColorEnhancementParams
Declared in ZegoDefine.cs

ZegoCopyrightedMusicConfig

CopyrightedMusic play configuration.

Declared in ZegoDefine.cs

Properties

user

user
public ZegoUser user

User object instance, configure userID, userName. that the user ID set here needs to be consistent with the user ID set when logging in to the room, otherwise the request for the copyright music background service will fail.

ZegoCopyrightedMusicGetLyricConfig

The configuration of getting lyric.

Declared in ZegoDefine.cs

Properties

songID

songID
public string songID

the ID of the song.

vendorID

vendorID
public int vendorID

Copyright music resource song copyright provider.

Methods

ZegoCopyrightedMusicGetLyricConfig

ZegoCopyrightedMusicGetLyricConfig
Declared in ZegoDefine.cs

ZegoCopyrightedMusicGetSharedConfig

The configuration of getting shared resource.

Declared in ZegoDefine.cs

Properties

songID

songID
public string songID

the ID of the song.

vendorID

vendorID

Copyright music resource song copyright provider.

roomID

roomID
public string roomID

The room ID, the single-room mode can not be passed, and the corresponding room ID must be passed in the multi-room mode. Indicates which room to get resources from.

mode

mode

billing mode.It is only required when using on the Web platform and using vendorID value is ZegoCopyrightedMusicVendor1.

masterID

masterID
public string masterID

The master ID, which must be passed when the billing mode is billed by host.

ZegoCopyrightedMusicGetSharedConfigV2

The configuration of getting shared resource.

Declared in ZegoDefine.cs

Properties

songID

songID
public string songID

the ID of the song.

vendorID

vendorID
public int vendorID

Copyright music resource song copyright provider. Refer to the value of [ZegoCopyrightedMusicVendorID].

roomID

roomID
public string roomID

The room ID, the single-room mode can not be passed, and the corresponding room ID must be passed in the multi-room mode. Indicates which room to get resources from.

resourceType

resourceType
public int resourceType

The resource type of music.

mode

mode
public int mode

billing mode.It is only required when using on the Web platform and using vendorID value is ZegoCopyrightedMusicVendor1.

masterID

masterID
public string masterID

The master ID, which must be passed when the billing mode is billed by host.

ZegoCopyrightedMusicQueryCacheConfig

The configuration of querying cache.

Declared in ZegoDefine.cs

Properties

songID

songID
public string songID

the ID of the song.

resourceType

resourceType

The resource type of music.

resourceQualityType

resourceQualityType
public ZegoCopyrightedMusicResourceQualityType resourceQualityType

The resource quality type of music.

vendorID

vendorID

Copyright music resource song copyright provider.

Methods

ZegoCopyrightedMusicQueryCacheConfig

ZegoCopyrightedMusicQueryCacheConfig
Declared in ZegoDefine.cs

ZegoCopyrightedMusicQueryCacheConfigV2

The configuration of querying cache.

Declared in ZegoDefine.cs

Properties

songID

songID
public string songID

the ID of the song.

resourceType

resourceType
public int resourceType

The resource type of music. Refer to the value of [ZegoCopyrightedMusicResourceType].

resourceQualityType

resourceQualityType
public int resourceQualityType

The resource quality type of music. Refer to the value of [ZegoCopyrightedMusicResourceQualityType].

vendorID

vendorID
public int vendorID

Copyright music resource song copyright provider. Refer to the value of [ZegoCopyrightedMusicVendorID].

Methods

ZegoCopyrightedMusicQueryCacheConfigV2

ZegoCopyrightedMusicQueryCacheConfigV2
Declared in ZegoDefine.cs

ZegoCopyrightedMusicRequestConfig

The configuration of requesting resource.

Declared in ZegoDefine.cs

Properties

songID

songID
public string songID

the ID of the song.

mode

mode

VOD billing mode.

vendorID

vendorID

Copyright music resource song copyright provider.

roomID

roomID
public string roomID

The room ID, the single-room mode can not be passed, and the corresponding room ID must be passed in the multi-room mode. Indicate in which room to order song/accompaniment/accompaniment clip/accompaniment segment.

masterID

masterID
public string masterID

The master ID, which must be passed when the billing mode is billed by host. Indicate which homeowner to order song/accompaniment/accompaniment clip/accompaniment segment.

sceneID

sceneID
public int sceneID

The scene ID, indicate the actual business. For details, please consult ZEGO technical support.

ZegoCopyrightedMusicRequestConfigV2

The configuration of requesting resource.

Declared in ZegoDefine.cs

Properties

songID

songID
public string songID

the ID of the song.

mode

mode
public int mode

VOD billing mode. Refer to the value of [ZegoCopyrightedMusicBillingMode].

vendorID

vendorID
public int vendorID

Copyright music resource song copyright provider. Refer to the value of [ZegoCopyrightedMusicVendorID].

roomID

roomID
public string roomID

The room ID, the single-room mode can not be passed, and the corresponding room ID must be passed in the multi-room mode. Indicate in which room to order song/accompaniment/accompaniment clip/accompaniment segment.

masterID

masterID
public string masterID

The master ID, which must be passed when the billing mode is billed by host. Indicate which homeowner to order song/accompaniment/accompaniment clip/accompaniment segment.

sceneID

sceneID
public int sceneID

The scene ID, indicate the actual business. For details, please consult ZEGO technical support.

resourceType

resourceType
public int resourceType

The resource type of music. Refer to the value of [ZegoCopyrightedMusicResourceType].

Methods

ZegoCopyrightedMusicRequestConfigV2

ZegoCopyrightedMusicRequestConfigV2
Declared in ZegoDefine.cs

ZegoCustomAudioConfig

Custom audio configuration.

Declared in ZegoDefine.cs

Properties

sourceType

sourceType
public ZegoAudioSourceType sourceType

Audio capture source type

ZegoCustomVideoCaptureConfig

Custom video capture configuration.

Details

Custom video capture, that is, the developer is responsible for collecting video data and sending the collected video data to SDK for video data encoding and publishing to the ZEGO RTC server. This feature is generally used by developers who use third-party beauty features or record game screen living. When you need to use the custom video capture function, you need to set an instance of this class as a parameter to the [enableCustomVideoCapture] function. Because when using custom video capture, SDK will no longer start the camera to capture video data. You need to collect video data from video sources by yourself.

Declared in ZegoDefine.cs

Properties

bufferType

bufferType
public ZegoVideoBufferType bufferType

Custom video capture video frame data type

ZegoCustomVideoProcessConfig

Custom video process configuration.

Declared in ZegoDefine.cs

Properties

bufferType

bufferType
public ZegoVideoBufferType bufferType

Custom video process video frame data type

ZegoCustomVideoRenderConfig

Custom video render configuration.

Details

When you need to use the custom video render function, you need to set an instance of this class as a parameter to the [enableCustomVideoRender] function.

Declared in ZegoDefine.cs

Properties

bufferType

bufferType
public ZegoVideoBufferType bufferType

Custom video capture video frame data type

frameFormatSeries

frameFormatSeries
public ZegoVideoFrameFormatSeries frameFormatSeries

Custom video rendering video frame data format。Useless when set bufferType as [EncodedData]

enableEngineRender

enableEngineRender
public bool enableEngineRender

Whether the engine also renders while customizing video rendering. The default value is [false]. Useless when set bufferType as [EncodedData]

ZegoDataRecordConfig

Record config.

Declared in ZegoDefine.cs

Properties

filePath

filePath
public string filePath

The path to save the recording file, absolute path, need to include the file name, the file name need to specify the suffix, currently supports .mp4/.flv/.aac format files, if multiple recording for the same path, will overwrite the file with the same name. The maximum length should be less than 1024 bytes.

recordType

recordType
public ZegoDataRecordType recordType

Type of recording media

Methods

ZegoDataRecordConfig

ZegoDataRecordConfig
public void ZegoDataRecordConfig()
Declared in ZegoDefine.cs

ZegoDataRecordProgress

File recording progress.

Declared in ZegoDefine.cs

Properties

duration

duration
public ulong duration

Current recording duration in milliseconds

currentFileSize

currentFileSize
public ulong currentFileSize

Current recording file size in byte

quality

quality

The quality of current recording file

ZegoDeviceInfo

Device Info.

Details

Including device ID and name

Declared in ZegoDefine.cs

Properties

deviceID

deviceID
public string deviceID

Device ID

deviceName

deviceName
public string deviceName

Device name

deviceExtraInfo

deviceExtraInfo
public string deviceExtraInfo

Device extra info, Format: key="value" key2="value2"..., use line break to separate key-value pairs, and use equal sign = to separate key and "value", and there are double quotes around the value

ZegoDumpDataConfig

Dump data config.

Declared in ZegoDefine.cs

Properties

dataType

dataType
public ZegoDumpDataType dataType

Data type.

Methods

ZegoDumpDataConfig

ZegoDumpDataConfig
public void ZegoDumpDataConfig()
Declared in ZegoDefine.cs

ZegoEffectsBeautyParam

Beauty configuration param.

Details

Configure the whiten, rosy, smooth, and sharpen parameters for beauty.

Declared in ZegoDefine.cs

Properties

whitenIntensity

whitenIntensity
public int whitenIntensity

The whiten intensity parameter, the value range is [0,100], and the default is 50.

rosyIntensity

rosyIntensity
public int rosyIntensity

the rosy intensity parameter, value range [0,100], and the default is 50.

smoothIntensity

smoothIntensity
public int smoothIntensity

the smooth intensity parameter, value range [0,100], and the default is 50.

sharpenIntensity

sharpenIntensity
public int sharpenIntensity

the sharpen intensity parameter, value range [0,100], and the default is 50.

Methods

ZegoEffectsBeautyParam

ZegoEffectsBeautyParam
Declared in ZegoDefine.cs

ZegoEngineConfig

Advanced engine configuration.

Declared in ZegoDefine.cs

Properties

logConfig

logConfig
deprecated
public ZegoLogConfig logConfig

Log configuration, if not set, use the default configuration. It must be set before calling [createEngine] to take effect. If it is set after [createEngine], it will take effect at the next [createEngine] after [destroyEngine].

Deprecated
This property has been deprecated since version 2.3.0, please use the [setLogConfig] function instead.

advancedConfig

advancedConfig
public Dictionary<string, string> advancedConfig

Other special function switches, if not set, no special function will be used by default. Please contact ZEGO technical support before use.

ZegoEngineProfile

Profile for create engine

Details

Profile for create engine

Declared in ZegoDefine.cs

Properties

appID

appID
public uint appID

Application ID issued by ZEGO for developers, please apply from the ZEGO Admin Console https://console.zegocloud.com The value ranges from 0 to 4294967295.

appSign

appSign
public string appSign

Application signature for each AppID, please apply from the ZEGO Admin Console. Application signature is a 64 character string. Each character has a range of '0' ~ '9', 'a' ~ 'z'. AppSign 2.17.0 and later allows null or no transmission. If the token is passed empty or not passed, the token must be entered in the [ZegoRoomConfig] parameter for authentication when the [loginRoom] interface is called to login to the room.

scenario

scenario
public ZegoScenario scenario

The room scenario. the SDK will optimize the audio and video configuration for the specified scenario to achieve the best effect in this scenario. After specifying the scenario, you can call other APIs to adjusting the audio and video configuration. Differences between scenarios and how to choose a suitable scenario, please refer to https://docs.zegocloud.com/article/14940

callbackInMainThread

callbackInMainThread
public bool callbackInMainThread

Set whether to trigger SDK callback in the Main thread. This option is only valid for Express Audio.

Methods

ZegoEngineProfile

ZegoEngineProfile
public void ZegoEngineProfile()
Declared in ZegoDefine.cs

ZegoFontStyle

Font style.

Details

Font style configuration, can be used to configure font type, font size, font color, font transparency.

  • Use cases: Set text watermark in manual stream mixing scene, such as Co-hosting.

Declared in ZegoDefine.cs

Properties

type

type
public ZegoFontType type
  • Required: False.
  • Default value: Source han sans [ZegoFontTypeSourceHanSans]

size

size
public int size
  • Required: False.
  • Default value: 24.
  • Value range: [12,100].

color

color
public int color
  • Required: False.
  • Default value: 16777215(white).
  • Value range: [0,16777215].

transparency

transparency
public int transparency
  • Required: False.
  • Default value: 0.
  • Value range: [0,100], 100 is completely opaque, 0 is completely transparent.

border

border
public bool border
  • Required: False.
  • Default value: False.
  • Value range: True/False.

borderColor

borderColor
public int borderColor
  • Required: False.
  • Default value: 0.
  • Value range: [0,16777215].

Methods

ZegoFontStyle

ZegoFontStyle
public void ZegoFontStyle()
Declared in ZegoDefine.cs

ZegoImageBuffer

image data content

Declared in ZegoDefine.cs

Properties

buffer

buffer
public byte[] buffer

image content in BGRA32 format.

length

length
public uint length

buffer size.

width

width
public uint width

buffer width.

height

height
public uint height

buffer height.

ZegoLabelInfo

Label info.

Details

Font style configuration, can be used to configure font type, font si-e, font color, font transparency.

  • Use cases: Set text watermark in manual stream mixing scene, such as Co-hosting.

Declared in ZegoDefine.cs

Properties

text

text
public string text
  • Required: True.
  • Value range: Maximum support for displaying 100 Chinese characters and 300 English characters.

left

left
public int left
  • Required: False.
  • Default value: 0.

top

top
public int top
  • Required: False.
  • Default value: 0.

font

font
public ZegoFontStyle font
  • Required: False.

Methods

ZegoLabelInfo

ZegoLabelInfo
public void ZegoLabelInfo(string text)
Declared in ZegoDefine.cs

ZegoLogConfig

Log config.

Details

This parameter is required when calling [setlogconfig] to customize log configuration.

  • Use cases: This configuration is required when you need to customize the log storage path or the maximum log file size.
  • Caution: None.

Declared in ZegoDefine.cs

Properties

logPath

logPath
public string logPath

Used to customize the storage path of the log file.

  • Use cases: This configuration is required when you need to customize the log storage path.
  • Required: False.
  • Default value: The default path of each platform is different, please refer to the official website document https://docs.zegocloud.com/faq/express_sdkLog.
  • Caution: Developers need to ensure read and write permissions for files under this path.

logSize

logSize
public ulong logSize

Used to customize the maximum log file size.

  • Use cases: This configuration is required when you need to customize the upper limit of the log file size.
  • Required: False.
  • Default value: 5MB (5 * 1024 * 1024 Bytes).
  • Value range: Minimum 1MB (1 * 1024 * 1024 Bytes), maximum 100M (100 * 1024 * 1024 Bytes), 0 means no need to write logs.
  • Caution: The larger the upper limit of the log file size, the more log information it carries, but the log upload time will be longer.

logCount

logCount
public uint logCount

Log files count. Default is 3. Value range is [3, 20].

logLevel

logLevel
public string logLevel

Local log level. Only valid for web. The higher the level, the fewer logs will be printed. Available values: 'debug' | 'info' | 'warn' | 'error' | 'report' | 'disable'

Methods

ZegoLogConfig

ZegoLogConfig
public void ZegoLogConfig()
Declared in ZegoDefine.cs

ZegoMediaPlayerResource

Multimedia resource for ZEGO media player.

Details

Used to configure loading parameters when loading multimedia resources.

Declared in ZegoDefine.cs

Properties

loadType

loadType
public ZegoMultimediaLoadType loadType

Used to specify the loading type of multimedia resources.

startPosition

startPosition
public long startPosition

The progress at which the plaback started.

filePath

filePath
public string filePath

Common resource path.The absolute resource path or the URL of the network resource and cannot be nil or "". Android can set this path string with Uri.

memory

memory
public IntPtr memory

binary data memory.

memoryLength

memoryLength
public int memoryLength

Binary data memory length.

resourceID

resourceID
public string resourceID

The resource ID obtained from the copyrighted music module.

onlineResourceCachePath

onlineResourceCachePath
public string onlineResourceCachePath

Online resource cache path, in utf8 encoding format.

maxCachePendingLength

maxCachePendingLength
public long maxCachePendingLength

The maximum length of online resource cache to be used, in bytes, with a minimum setting of 500K (500 * 1024). The default value is 0 - no limit, and try to cache the entire file.

Methods

ZegoMediaPlayerResource

ZegoMediaPlayerResource
Declared in ZegoDefine.cs

ZegoMixerAudioConfig

Mix stream audio configuration.

Details

Configure video frame rate, bitrate, and resolution for mixer task

Declared in ZegoDefine.cs

Properties

bitrate

bitrate
public int bitrate

Audio bitrate in kbps, default is 48 kbps, cannot be modified after starting a mixer task

channel

channel
public ZegoAudioChannel channel

Audio channel, default is Mono

codecID

codecID
public ZegoAudioCodecID codecID

codec ID, default is ZegoAudioCodecIDDefault

mixMode

mixMode
public ZegoAudioMixMode mixMode

Multi-channel audio stream mixing mode. If [ZegoAudioMixMode] is selected as [Focused], the SDK will select 4 input streams with [isAudioFocus] set as the focus voice highlight. If it is not selected or less than 4 channels are selected, it will automatically fill in 4 channels. On web platforms, this property does not take effect.

Methods

ZegoMixerAudioConfig

ZegoMixerAudioConfig
public void ZegoMixerAudioConfig()
Declared in ZegoDefine.cs

ZegoMixerImageInfo

Set the image information of a single input stream in the mux.

Details

Sets a picture for the content of a single input stream, which is used in place of the video, i.e. the video is not displayed when the picture is used. The layout layout in [ZegoMixerInput] for image multiplexing. Use case: The developer needs to temporarily turn off the camera to display the image during the video connection to the microphone, or display the picture when the audio is connected to the microphone.

  • Available since: 2.19.0
  • Restrictions: Image size is limited to 1M.

Declared in ZegoDefine.cs

Properties

url

url
public string url

The image path, if not empty, the image will be displayed, otherwise, the video will be displayed. JPG and PNG formats are supported. There are 2 ways to use it: 1. URI: Provide the picture to ZEGO technical support for configuration. After the configuration is complete, the picture URI will be provided, for example: preset-id://xxx.jpg. 2. URL: Only HTTP protocol is supported.

displayMode

displayMode
public int displayMode

Image display mode. 0: Default. Use image to replace video content when url is not null. 1: Display image based on camera status. Display image when camera is turned off. Display video content when camera is turned on (no need to clear the url parameter). 2: Display image based on the input stream has video data or not. Display image when there is no video data in the input stream for 3 consecutive seconds. The default duration for judging that there is no video data is 3 seconds. If you need change this setting, please contact ZEGO technical support. Display video content when the input stream has video data.

Methods

ZegoMixerImageInfo

ZegoMixerImageInfo
public void ZegoMixerImageInfo(string url)
Declared in ZegoDefine.cs

ZegoMixerImageInfo

ZegoMixerImageInfo
public void ZegoMixerImageInfo(string url, int displayMode)
Declared in ZegoDefine.cs

ZegoMixerInput

Mixer input.

Details

Configure the mix stream input stream ID, type, and the layout

Declared in ZegoDefine.cs

Properties

streamID

streamID
public string streamID
  • Caution: You cannot include URL keywords, otherwise publishing stream and playing stream will fails. Only support numbers, English characters and '-', '_'.

contentType

contentType
public ZegoMixerInputContentType contentType

Mix stream content type

layout

layout
public ZegoRect layout

Stream layout. When the mixed stream is an audio stream (that is, the ContentType parameter is set to the audio mixed stream type). Developers do not need to assign a value to this field, just use the SDK default.

soundLevelID

soundLevelID
public uint soundLevelID

If enable soundLevel in mix stream task, an unique soundLevelID is need for every stream

volume

volume
public uint volume

Input stream volume, valid range [0, 200], default is 100.

isAudioFocus

isAudioFocus
public bool isAudioFocus

Whether the focus voice is enabled in the current input stream, the sound of this stream will be highlighted if enabled.

audioDirection

audioDirection
public int audioDirection

The direction of the audio. Valid direction is between 0 to 360. Set -1 means disable. Default value is -1. On web platforms, this property does not take effect.

label

label
public ZegoLabelInfo label

Text watermark.

renderMode

renderMode
public ZegoMixRenderMode renderMode

Video view render mode.

imageInfo

imageInfo
public ZegoMixerImageInfo imageInfo

User image information.

cornerRadius

cornerRadius
public uint cornerRadius

Video frame corner radius, in px.

  • Required: False.
  • Value range: Does not exceed the width and height of the video screen set by the [layout] parameter.
  • Default value: 0.

advancedConfig

advancedConfig
public Dictionary<string, string> advancedConfig

Set advanced configuration. Please contact ZEGO technical support. On web platforms, this property does not take effect.

Methods

ZegoMixerInput

ZegoMixerInput
public void ZegoMixerInput(string streamID, ZegoMixerInputContentType contentType, ZegoRect layout)
Declared in ZegoDefine.cs

ZegoMixerInput

ZegoMixerInput
public void ZegoMixerInput(string streamID, ZegoMixerInputContentType contentType, ZegoRect layout, uint soundLevelID)
Declared in ZegoDefine.cs

ZegoMixerOutput

Mixer output object, currently, a mixed-stream task only supports a maximum of four video streams with different resolutions.

Details

Configure mix stream output target URL or stream ID

Declared in ZegoDefine.cs

Properties

target

target
public string target

Mix stream output target, URL or stream ID, if set to be URL format, only RTMP URL surpported, for example rtmp://xxxxxxxx, addresses with two identical mixed-stream outputs cannot be passed in.

videoConfig

videoConfig
public ZegoMixerOutputVideoConfig videoConfig

Mix stream output video config. On web platforms, this property does not take effect.

targetRoom

targetRoom
public ZegoMixerOutputRoomInfo targetRoom

Specifies the room information for the output stream.

Methods

ZegoMixerOutput

ZegoMixerOutput
public void ZegoMixerOutput(string target)
Declared in ZegoDefine.cs

ZegoMixerOutputRoomInfo

Room information for the output stream in a mixed stream.

Details

Setting room information for a single output stream; the mixed output stream can be added to the specified room, allowing users in the room to receive notifications of increased stream in the room.

  • Use cases: Manual mixed stream scenario, such as Co-hosting.
  • Available since: 3.18.0
  • Restrictions: Dynamic updates during mixed stream are not supported.

Declared in ZegoDefine.cs

Properties

roomID

roomID
public string roomID

Specifies the room ID of the output stream. You need to ensure that the room is already present when mixing starts.

userID

userID
public string userID

Specifies the user ID of the output stream. It is not recommended to use the same userID as the actual user in the room to avoid conflicts with the SDK's stream addition behavior.

Methods

ZegoMixerOutputRoomInfo

ZegoMixerOutputRoomInfo
public void ZegoMixerOutputRoomInfo(String roomID, String userID)
Declared in ZegoDefine.cs

ZegoMixerOutputVideoConfig

Mix stream output video config object.

Details

Configure the video parameters, coding format and bitrate of mix stream output.

  • Use cases: Manual mixed stream scenario, such as Co-hosting.

Declared in ZegoDefine.cs

Properties

videoCodecID

videoCodecID
public ZegoVideoCodecID videoCodecID

Mix stream output video coding format, supporting H.264 and h.265 coding.

bitrate

bitrate
public int bitrate

Mix stream output video bitrate in kbps. The default value is the bitrate configured in [ZegoMixerVideoConfig].

encodeProfile

encodeProfile
public ZegoEncodeProfile encodeProfile

Mix stream video encode profile. Default value is [ZegoEncodeProfileDefault].

encodeLatency

encodeLatency
public int encodeLatency

The video encoding delay of mixed stream output, Valid value range [0, 2000], in milliseconds. The default value is 0.

enableLowBitrateHD

enableLowBitrateHD
public bool enableLowBitrateHD

Enable high definition low bitrate. Default is false.

Methods

ZegoMixerOutputVideoConfig

ZegoMixerOutputVideoConfig
Declared in ZegoDefine.cs

ZegoMixerTask

Mix stream task object.

Details

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.

Declared in ZegoDefine.cs

Properties

taskID

taskID
public string taskID

Mix stream task ID

audioConfig

audioConfig
public ZegoMixerAudioConfig audioConfig

Mix stream audio config

videoConfig

videoConfig
public ZegoMixerVideoConfig videoConfig

Mix stream audio config

inputList

inputList
public List<ZegoMixerInput> inputList

Mix stream task input list

outputList

outputList
public List<ZegoMixerOutput> outputList

Mix stream task output list

watermark

watermark
public ZegoWatermark watermark

Mix stream wate rmark

backgroundColor

backgroundColor
public int backgroundColor

Mix stream background color, 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.

backgroundImageURL

backgroundImageURL
public string backgroundImageURL

Mix stream background image URL

enableSoundLevel

enableSoundLevel
public bool 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.

streamAlignmentMode

streamAlignmentMode
public ZegoStreamAlignmentMode streamAlignmentMode

The stream mixing alignment mode

userData

userData
public IntPtr userData

User data, the length of user data should not be more than 1000 bytes,After setting, the streaming party can obtain the SEI content by listening to the callback of [onPlayerRecvSEI].

userDataLength

userDataLength
public uint userDataLength

User data length, not greater than 1000. 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.

advancedConfig

advancedConfig
public Dictionary<string, string> advancedConfig

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

minPlayStreamBufferLength

minPlayStreamBufferLength
public int minPlayStreamBufferLength

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.

mixImageCheckMode

mixImageCheckMode
public ZegoMixImageCheckMode mixImageCheckMode

Set the mixed stream image check mode.

Methods

ZegoMixerTask

ZegoMixerTask
public void ZegoMixerTask(string taskID)
Create a mix stream task object with TaskID
Declared in ZegoDefine.cs

ZegoMixerVideoConfig

Mix stream video config object.

Details

Configure video frame rate, bitrate, and resolution for mixer task

Declared in ZegoDefine.cs

Properties

width

width
public int width

Video resolution width

height

height
public int height

Video resolution height

fps

fps
public int fps

Video FPS, cannot be modified after starting a mixer task

bitrate

bitrate
public int bitrate

Video bitrate in kbps

quality

quality
public int quality

Video quality, this value is valid when the video rate control mode parameter is set to constant quality. The valid value ranges from 0 to 51. The default value is 23. If you want better video quality, lower the quality value based on 23 to test the adjustment. If you want a smaller file size, test the adjustment by increasing the high quality value at the base of 23. Take the file size under the value x as an example. The file size under the value x + 6 is half the size of the file size under the value x, and the file size under the value x-6 is twice the size of the file size under the value x. On web platforms, this property does not take effect.

rateControlMode

rateControlMode
public ZegoVideoRateControlMode rateControlMode

Video bitrate control mode. On web platforms, this property does not take effect.

Methods

ZegoMixerVideoConfig

ZegoMixerVideoConfig
public void ZegoMixerVideoConfig()
Declared in ZegoDefine.cs

ZegoMixerVideoConfig

ZegoMixerVideoConfig
public void ZegoMixerVideoConfig(int width, int height, int fps, int bitrate)
Declared in ZegoDefine.cs

ZegoNetWorkResourceCache

Media player network cache information

Declared in ZegoDefine.cs

Properties

time

time
public uint time

Cached playable duration, unit ms

size

size
public uint size

Cached playable size, unit byte

ZegoNetworkTimeInfo

The NTP info

Declared in ZegoDefine.cs

Properties

timestamp

timestamp
public ulong timestamp

Network timestamp after synchronization, 0 indicates not yet synchronized

maxDeviation

maxDeviation
public int maxDeviation

The max deviation

ZegoPerformanceStatus

System performance monitoring status

Declared in ZegoDefine.cs

Properties

cpuUsageApp

cpuUsageApp
public double cpuUsageApp

Current CPU usage of the app, value range [0, 1]

cpuUsageSystem

cpuUsageSystem
public double cpuUsageSystem

Current CPU usage of the system, value range [0, 1]

memoryUsageApp

memoryUsageApp
public double memoryUsageApp

Current memory usage of the app, value range [0, 1]

memoryUsageSystem

memoryUsageSystem
public double memoryUsageSystem

Current memory usage of the system, value range [0, 1]

memoryUsedApp

memoryUsedApp
public double memoryUsedApp

Current memory used of the app, in MB

ZegoPlayStreamQuality

Played stream quality information.

Details

Audio and video parameters and network quality, etc.

Declared in ZegoDefine.cs

Properties

videoRecvFPS

videoRecvFPS
public double videoRecvFPS

Video receiving frame rate. The unit of frame rate is f/s

videoDejitterFPS

videoDejitterFPS
public double videoDejitterFPS

Video dejitter frame rate. The unit of frame rate is f/s (Available since 1.17.0).WebGL does not have this information.

videoDecodeFPS

videoDecodeFPS
public double videoDecodeFPS

Video decoding frame rate. The unit of frame rate is f/s.WebGL does not have this information.

videoRenderFPS

videoRenderFPS
public double videoRenderFPS

Video rendering frame rate. The unit of frame rate is f/s

videoKBPS

videoKBPS
public double videoKBPS

Video bit rate in kbps

videoBreakRate

videoBreakRate
public double videoBreakRate

Video break rate, the unit is (number of breaks / every 10 seconds) (Available since 1.17.0).WebGL does not have this information.

audioRecvFPS

audioRecvFPS
public double audioRecvFPS

Audio receiving frame rate. The unit of frame rate is f/s

audioDejitterFPS

audioDejitterFPS
public double audioDejitterFPS

Audio dejitter frame rate. The unit of frame rate is f/s (Available since 1.17.0).WebGL does not have this information.

audioDecodeFPS

audioDecodeFPS
public double audioDecodeFPS

Audio decoding frame rate. The unit of frame rate is f/s.WebGL does not have this information.

audioRenderFPS

audioRenderFPS
public double audioRenderFPS

Audio rendering frame rate. The unit of frame rate is f/s

audioKBPS

audioKBPS
public double audioKBPS

Audio bit rate in kbps

audioBreakRate

audioBreakRate
public double audioBreakRate

Audio break rate, the unit is (number of breaks / every 10 seconds) (Available since 1.17.0).WebGL does not have this information.

mos

mos
public double mos

The audio quality of the playing stream determined by the audio MOS (Mean Opinion Score) measurement method, value range [-1, 5], where -1 means unknown, [0, 5] means valid score, the higher the score, the better the audio quality. For the subjective perception corresponding to the MOS value, please refer to https://docs.zegocloud.com/article/3720#4_4 (Available since 2.16.0).WebGL does not have this information.

rtt

rtt
public int rtt

Server to local delay, in milliseconds

packetLostRate

packetLostRate
public double packetLostRate

Packet loss rate, in percentage, 0.0 ~ 1.0

peerToPeerDelay

peerToPeerDelay
public int peerToPeerDelay

Delay from peer to peer, in milliseconds

peerToPeerPacketLostRate

peerToPeerPacketLostRate
public double peerToPeerPacketLostRate

Packet loss rate from peer to peer, in percentage, 0.0 ~ 1.0

level

level

Published stream quality level

delay

delay
public int delay

Delay after the data is received by the local end, in milliseconds

avTimestampDiff

avTimestampDiff
public int avTimestampDiff

The difference between the video timestamp and the audio timestamp, used to reflect the synchronization of audio and video, in milliseconds. This value is less than 0 means the number of milliseconds that the video leads the audio, greater than 0 means the number of milliseconds that the video lags the audio, and 0 means no difference. When the absolute value is less than 200, it can basically be regarded as synchronized audio and video, when the absolute value is greater than 200 for 10 consecutive seconds, it can be regarded as abnormal (Available since 1.19.0).WebGL does not have this information.

isHardwareDecode

isHardwareDecode
public bool isHardwareDecode

Whether to enable hardware decoding.WebGL does not have this information.

videoCodecID

videoCodecID
public ZegoVideoCodecID videoCodecID

Video codec ID (Available since 1.17.0).WebGL does not have this information.

totalRecvBytes

totalRecvBytes
public double totalRecvBytes

Total number of bytes received, including audio, video, SEI.WebGL does not have this information.

audioRecvBytes

audioRecvBytes
public double audioRecvBytes

Number of audio bytes received.WebGL does not have this information.

videoRecvBytes

videoRecvBytes
public double videoRecvBytes

Number of video bytes received.WebGL does not have this information.

ZegoPlayerConfig

Advanced player configuration.

Details

Configure stream resource mode, CDN configuration and other advanced configurations.

Declared in ZegoDefine.cs

Properties

resourceMode

resourceMode
public ZegoStreamResourceMode resourceMode

Stream resource mode.

cdnConfig

cdnConfig
public ZegoCDNConfig cdnConfig

The CDN configuration for playing stream. If set, the stream is play according to the URL instead of the streamID. After that, the streamID is only used as the ID of SDK internal callback.WebGL does not support Settings.

roomID

roomID
public string roomID

The Room ID. It only needs to be filled in the multi-room mode, which indicates which room this stream needs to be bound to. This parameter is ignored in single room mode.

videoCodecID

videoCodecID
public ZegoVideoCodecID videoCodecID

The video encoding type of the stream, please contact ZEGO technical support if you need to use it, otherwise this parameter can be ignored.

sourceResourceType

sourceResourceType
public ZegoResourceType sourceResourceType

The resource type of the source stream, please contact ZEGO technical support if you need to use it, otherwise this parameter can be ignored.WebGL does not support Settings.

codecTemplateID

codecTemplateID
public int codecTemplateID

Preconfigured codec template ID, please contact ZEGO technical support if you need to use it, otherwise this parameter can be ignored.WebGL does not support Settings.

resourceSwitchMode

resourceSwitchMode
public ZegoStreamResourceSwitchMode resourceSwitchMode

Play resource switching strategy mode, the default is ZegoStreamResourceSwitchModeDefault.WebGL does not support Setting.

resourceWhenStopPublish

resourceWhenStopPublish
public ZegoStreamResourceType resourceWhenStopPublish

Play resource type when stop publish, the default is ZegoStreamResourceTypeDefault. This setting takes effect when the user sets [resourceSwitchMode] to ZegoStreamResourceSwitchModeDefault or ZegoStreamResourceSwitchModeSwitchToRTC.WebGL does not support Setting.

adaptiveSwitch

adaptiveSwitch
public int adaptiveSwitch

Whether to enable adaptive switching of streams, 1 means on, 0 means off. Valid only if [resourceMode] is ZegoStreamResourceModeOnlyL3. Please contact ZEGO technical support if you need to use it, otherwise this parameter can be ignored.

adaptiveTemplateIDList

adaptiveTemplateIDList
public List<int> adaptiveTemplateIDList

Stream adaptive transcoding template ID list, please contact ZEGO technical support if you need to use it, otherwise this parameter can be ignored.

Methods

ZegoPlayerConfig

ZegoPlayerConfig
public void ZegoPlayerConfig()
Declared in ZegoDefine.cs

ZegoPosition

Request configuration of song or accompaniment.

Declared in ZegoDefine.cs

Properties

coordinate

coordinate
public Vector3 coordinate

The coordinates of the oneself in the world coordinate system. The parameter is a float array of length 3. The three values ​​represent the front, right, and top coordinate values ​​in turn.

motionOrientation

motionOrientation
public ZegoPositionOrientation motionOrientation

Motion orientation.

cameraOrientation

cameraOrientation
public ZegoPositionOrientation cameraOrientation

Camera orientation, for 3D range spatializer.

Methods

ZegoPosition

ZegoPosition
public void ZegoPosition()
Declared in ZegoDefine.cs

ZegoPositionOrientation

Orientation.

Declared in ZegoDefine.cs

Properties

axisForward

axisForward
public Vector3 axisForward

The unit vector of the front axis of its own coordinate system. The parameter is a float array with a length of 3. The three values ​​represent the front, right, and top coordinate values ​​in turn.

axisRight

axisRight
public Vector3 axisRight

The unit vector of the right axis of its own coordinate system. The parameter is a float array with a length of 3. The three values ​​represent the front, right, and top coordinate values ​​in turn.

axisUp

axisUp
public Vector3 axisUp

The unit vector of the up axis of its own coordinate system. The parameter is a float array with a length of 3. The three values ​​represent the front, right, and top coordinate values ​​in turn.

ZegoProxyInfo

Proxy config.

Details

Set proxy config.

Declared in ZegoDefine.cs

Properties

ip

ip
public string ip

ip. Under local proxy: local proxy ip configured by the developer. under cloud proxy: proxy ip provided by ZEGO (either hostname or ip will do).

port

port
public uint port

port. Under Local Proxy: Local proxy port configured by the developer. Under Cloud Proxy: Proxy port provided by ZEGO.

hostName

hostName
public string hostName

hostname.Under Local Proxy: Local proxy hostname configured by the developer. Under cloud proxy: proxy hostname provided by ZEGO. proxy hostname (either hostname or ip will do).

userName

userName
public string userName

userName.Under Local Proxy: the authentication username of the local Proxy configured by the developer, can be ignored if there is none. Under cloud proxy: can be ignored.

password

password
public string password

password.Under local proxy: authentication password of local proxy configured by developer, can be ignored if there is none. Under cloud proxy: can be ignored.

Methods

ZegoProxyInfo

ZegoProxyInfo
public void ZegoProxyInfo()
Declared in ZegoDefine.cs

ZegoPublishDualStreamConfig

Dual stream info.

Declared in ZegoDefine.cs

Properties

streamType

streamType
public ZegoVideoStreamType streamType

streamType

encodeWidth

encodeWidth
public int encodeWidth

Video resolution width to be adjusted

encodeHeight

encodeHeight
public int encodeHeight

Video resolution height to be adjusted

fps

fps
public int fps

Video FPS to be adjusted

bitrate

bitrate
public int bitrate

Video bitrate in kbps to be adjusted

ZegoPublishStreamQuality

Published stream quality information.

Details

Audio and video parameters and network quality, etc.

Declared in ZegoDefine.cs

Properties

videoCaptureFPS

videoCaptureFPS
public double videoCaptureFPS

Video capture frame rate. The unit of frame rate is f/s

videoEncodeFPS

videoEncodeFPS
public double videoEncodeFPS

Video encoding frame rate. The unit of frame rate is f/s

videoSendFPS

videoSendFPS
public double videoSendFPS

Video transmission frame rate. The unit of frame rate is f/s

videoKBPS

videoKBPS
public double videoKBPS

Video bit rate in kbps

audioCaptureFPS

audioCaptureFPS
public double audioCaptureFPS

Audio capture frame rate. The unit of frame rate is f/s

audioSendFPS

audioSendFPS
public double audioSendFPS

Audio transmission frame rate. The unit of frame rate is f/s

audioKBPS

audioKBPS
public double audioKBPS

Audio bit rate in kbps

rtt

rtt
public int rtt

Local to server delay, in milliseconds

packetLostRate

packetLostRate
public double packetLostRate

Packet loss rate, in percentage, 0.0 ~ 1.0

level

level

Published stream quality level

isHardwareEncode

isHardwareEncode
public bool isHardwareEncode

Whether to enable hardware encoding

videoCodecID

videoCodecID
public ZegoVideoCodecID videoCodecID

Video codec ID (Available since 1.17.0)

totalSendBytes

totalSendBytes
public double totalSendBytes

Total number of bytes sent, including audio, video, SEI.WebGL does not have this information.

audioSendBytes

audioSendBytes
public double audioSendBytes

Number of audio bytes sent.WebGL does not have this information.

videoSendBytes

videoSendBytes
public double videoSendBytes

Number of video bytes sent.WebGL does not have this information.

ZegoPublisherConfig

Advanced publisher configuration.

Details

Configure room id

Declared in ZegoDefine.cs

Properties

roomID

roomID
public string roomID

The Room ID, It is not necessary to pass in single room mode, but the ID of the corresponding room must be passed in multi-room mode

forceSynchronousNetworkTime

forceSynchronousNetworkTime
public int forceSynchronousNetworkTime

Whether to synchronize the network time when pushing streams. 1 is synchronized with 0 is not synchronized. And must be used with setStreamAlignmentProperty. It is used to align multiple streams at the mixed stream service or streaming end, such as the chorus scene of KTV.

streamCensorshipMode

streamCensorshipMode
public ZegoStreamCensorshipMode streamCensorshipMode

When pushing a flow, review the pattern of the flow. By default, no audit is performed. If you want to use this function, contact ZEGO technical support.

streamCensorFlag

streamCensorFlag
public int streamCensorFlag

Inspect flag. If you want to use this function, contact ZEGO technical support.

codecNegotiationType

codecNegotiationType
public ZegoCapabilityNegotiationType codecNegotiationType

Codec capability negotiation type. By default, no reference to the outcome of the capability negotiation. If you want to use this function, contact ZEGO technical support.

streamTitle

streamTitle
public string streamTitle

Stream title, a utf8 string with a maximum length of 255 bytes or less.

Methods

ZegoPublisherConfig

ZegoPublisherConfig
public void ZegoPublisherConfig()
Declared in ZegoDefine.cs

ZegoReceiveRangeParam

Receive range configuration.

Declared in ZegoDefine.cs

Properties

min

min
public float min

The minimum distance at which the 3D sound effect starts to have attenuation effect, the value needs to be >= 0 and <= max, the default value is 0.

max

max
public float max

The maximum range received, the value needs to be >= min, the default value is 0.

Methods

ZegoReceiveRangeParam

ZegoReceiveRangeParam
public void ZegoReceiveRangeParam()
Declared in ZegoDefine.cs

ZegoRect

View related coordinates.

Declared in ZegoDefine.cs

Properties

x

x
public int x

The horizontal offset from the top-left corner

y

y
public int y

The vertical offset from the top-left corner

width

width
public int width

The width of the rectangle

height

height
public int height

The height of the rectangle

Methods

ZegoRect

ZegoRect
public void ZegoRect(int x, int y, int width, int height)
Declared in ZegoDefine.cs

ZegoRect

ZegoRect
public void ZegoRect()
Declared in ZegoDefine.cs

ZegoReverbAdvancedParam

Audio reverberation advanced parameters.

Details

Developers can use the SDK's built-in presets to change the parameters of the reverb.

Declared in ZegoDefine.cs

Properties

roomSize

roomSize
public float roomSize

Room size(%), in the range [0.0, 1.0], to control the size of the "room" in which the reverb is generated, the larger the room, the stronger the reverb.

reverberance

reverberance
public float reverberance

Echo(%), in the range [0.0, 100.0], to control the trailing length of the reverb.

damping

damping
public float damping

Reverb Damping(%), range [0.0, 100.0], controls the attenuation of the reverb, the higher the damping, the higher the attenuation.

wetOnly

wetOnly
public bool wetOnly

only wet

wetGain

wetGain
public float wetGain

wet gain(dB), range [-20.0, 10.0]

dryGain

dryGain
public float dryGain

dry gain(dB), range [-20.0, 10.0]

toneLow

toneLow
public float toneLow

Tone Low. 100% by default

toneHigh

toneHigh
public float toneHigh

Tone High. 100% by default

preDelay

preDelay
public float preDelay

PreDelay(ms), range [0.0, 200.0]

stereoWidth

stereoWidth
public float stereoWidth

Stereo Width(%). 0% by default

Methods

ZegoReverbAdvancedParam

ZegoReverbAdvancedParam
Declared in ZegoDefine.cs

ZegoReverbEchoParam

Audio reverberation echo parameters.

Declared in ZegoDefine.cs

Properties

inGain

inGain
public float inGain

Gain of input audio signal, in the range [0.0, 1.0]

outGain

outGain
public float outGain

Gain of output audio signal, in the range [0.0, 1.0]

numDelays

numDelays
public int numDelays

Number of echos, in the range [0, 7]

delay

delay
public int[] delay

Respective delay of echo signal, in milliseconds, in the range [0, 5000] ms

decay

decay
public float[] decay

Respective decay coefficient of echo signal, in the range [0.0, 1.0]

ZegoRoomConfig

Advanced room configuration.

Details

Configure maximum number of users in the room and authentication token, etc.

Declared in ZegoDefine.cs

Properties

maxMemberCount

maxMemberCount
public uint maxMemberCount

The maximum number of users in the room, Passing 0 means unlimited, the default is unlimited.

isUserStatusNotify

isUserStatusNotify
public bool isUserStatusNotify

Whether to enable the user in and out of the room callback notification [onRoomUserUpdate], the default is off. If developers need to use ZEGO Room user notifications, make sure that each user who login sets this flag to true

token

token
public string token

The token issued by the developer's business server is used to ensure security. For the generation rules, please refer to Using Token Authentication, the default is an empty string, that is, no authentication. In versions 2.17.0 and above, if appSign is not passed in when calling the [createEngine] API to create an engine, or if appSign is empty, this parameter must be set for authentication when logging in to a room.

capabilityNegotiationTypes

capabilityNegotiationTypes
public uint capabilityNegotiationTypes

The bitmask marker for capability negotiation, refer to enum [ZegoRoomCapabilityNegotiationTypesBitMask], when this param converted to binary, 0b01 that means 1 << 0 for enable the capability negotiation of all user in the room, 0x10 that means 1 << 1 for enable the capability negotiation of publisher in the room. The masks can be combined to allow different types of capability negotiation.

Methods

ZegoRoomConfig

ZegoRoomConfig
public void ZegoRoomConfig()
Declared in ZegoDefine.cs

ZegoRoomExtraInfo

Room extra information.

Declared in ZegoDefine.cs

Properties

key

key
public string key

The key of the room extra information.

value

value
public string value

The value of the room extra information.

updateUser

updateUser
public ZegoUser updateUser

The user who update the room extra information.Please do not fill in sensitive user information in this field, including but not limited to mobile phone number, ID number, passport number, real name, etc.

updateTime

updateTime
public ulong updateTime

Update time of the room extra information, UNIX timestamp, in milliseconds.

ZegoSEIConfig

SEI configuration

Details

Used to set the relevant configuration of the Supplemental Enhancement Information.

Declared in ZegoDefine.cs

Properties

type

type
public ZegoSEIType type

SEI type

ZegoSceneConfig

Scene config.

Declared in ZegoDefine.cs

Properties

channelCount

channelCount
public uint channelCount

State channel count.

ZegoSceneParam

Scene param.

Declared in ZegoDefine.cs

Properties

user

user
public ZegoUser user

User object instance, configure userID, userName. that the userID needs to be globally unique with the same appID, otherwise the user who logs in later will kick out the user who logged in first.

sceneID

sceneID
public long sceneID

Scene ID.

templateID

templateID
public uint templateID

Scene template ID.

position

position
public ZegoPosition position

User position.

broadcastMode

broadcastMode
public ZegoBroadcastMode broadcastMode

Broadcast user's own information mode, the default is ALL.

token

token
public string token

Authentication token.

Methods

ZegoSceneParam

ZegoSceneParam
public void ZegoSceneParam()
Declared in ZegoDefine.cs

ZegoScenePlayerConfig

Advanced scene player configuration.

Declared in ZegoDefine.cs

Properties

rangeSceneHandle

rangeSceneHandle
public int rangeSceneHandle

Range scene handle. Obtained through [getHandle] of ZegoRangeScene instance.

resourceMode

resourceMode
public ZegoStreamResourceMode resourceMode

Stream resource mode.

cdnConfig

cdnConfig
public ZegoCDNConfig cdnConfig

The CDN configuration for playing stream. If set, the stream is play according to the URL instead of the streamID. After that, the streamID is only used as the ID of SDK internal callback.

Methods

ZegoScenePlayerConfig

ZegoScenePlayerConfig
public void ZegoScenePlayerConfig()
Declared in ZegoDefine.cs

ZegoScenePublisherConfig

Advanced scene publisher configuration.

Declared in ZegoDefine.cs

Properties

rangeSceneHandle

rangeSceneHandle
public int rangeSceneHandle

Range scene handle. Obtained through [getHandle] of ZegoRangeScene instance.

ZegoSceneStreamConfig

Scene stream config.

Declared in ZegoDefine.cs

Properties

enablePlayInRange

enablePlayInRange
public bool enablePlayInRange

Enable play stream in range or not.

enablePublishToWorld

enablePublishToWorld
public bool enablePublishToWorld

Enable publish stream to world or not.

Methods

ZegoSceneStreamConfig

ZegoSceneStreamConfig
public void ZegoSceneStreamConfig()
Declared in ZegoDefine.cs

ZegoScreenCaptureConfig

Screen capture configuration parameters.

Declared in ZegoDefine.cs

Properties

captureVideo

captureVideo
public bool captureVideo

Whether to capture video when screen capture. The default is true.

captureAudio

captureAudio
public bool captureAudio

Whether to capture audio when screen capture. The default is true.

microphoneVolume

microphoneVolume
public uint microphoneVolume

Set Microphone audio volume for ReplayKit. The range is 0 ~ 200. The default is 100. (only for iOS)

applicationVolume

applicationVolume
public uint applicationVolume

Set Application audio volume for ReplayKit. The range is 0 ~ 200. The default is 100. (only for iOS and Android)

audioParam

audioParam
public ZegoAudioFrameParam audioParam

Set the audio capture parameters during screen capture. (only for Android)

Methods

ZegoScreenCaptureConfig

ZegoScreenCaptureConfig
Declared in ZegoDefine.cs

ZegoScreenCaptureSourceInfo

The screen captures source information.

Declared in ZegoDefine.cs

Properties

sourceType

sourceType
public ZegoScreenCaptureSourceType sourceType

Target type for screen capture. (only for desktop)

sourceID

sourceID
public long sourceID

The ID of the capture source.

sourceName

sourceName
public string sourceName

Capture source name (in UTF8 encoding).

thumbnailImage

thumbnailImage
public ZegoImageBuffer thumbnailImage

Thumbnail of the capture window.

iconImage

iconImage
public ZegoImageBuffer iconImage

The image content of the icon.

ZegoSoundLevelConfig

Configuration for start sound level monitor.

Declared in ZegoDefine.cs

Properties

millisecond

millisecond
public uint millisecond

Monitoring time period of the sound level, in milliseconds, has a value range of [100, 3000]. Default is 100 ms.

enableVAD

enableVAD
public bool enableVAD

Set whether the sound level callback includes the VAD detection result.

ZegoSoundLevelInfo

Sound level info object.

Declared in ZegoDefine.cs

Properties

soundLevel

soundLevel
public float soundLevel

Sound level value.

vad

vad
public int vad

Whether the stream corresponding to StreamID contains voice, 0 means noise, 1 means normal voice. This value is valid only when the [enableVAD] parameter in the [ZegoSoundLevelConfig] configuration is set to true when calling [startSoundLevelMonitor].

ZegoStream

Stream object.

Details

Identify an stream object

Declared in ZegoDefine.cs

Properties

user

user
public ZegoUser user

User object instance.Please do not fill in sensitive user information in this field, including but not limited to mobile phone number, ID number, passport number, real name, etc.

streamID

streamID
public string streamID
  • Caution: You cannot include URL keywords, otherwise publishing stream and playing stream will fails. Only support numbers, English characters and '-', '_'.

extraInfo

extraInfo
public string extraInfo

Stream extra info

ZegoStreamRelayCDNInfo

Relay to CDN info.

Details

Including the URL of the relaying CDN, relaying state, etc.

Declared in ZegoDefine.cs

Properties

url

url
public string url

URL of publishing stream to CDN

state

state

State of relaying to CDN

updateReason

updateReason
public ZegoStreamRelayCDNUpdateReason updateReason

Reason for relay state changed

stateTime

stateTime
public ulong stateTime

The timestamp when the state changed, UNIX timestamp, in milliseconds.

ZegoUser

User object.

Details

Configure user ID and username to identify users in the room. that the userID must be unique under the same appID, otherwise, there will be mutual kicks when logging in to the room. It is strongly recommended that userID corresponds to the user ID of the business APP, that is, a userID and a real user are fixed and unique, and should not be passed to the SDK in a random userID. Because the unique and fixed userID allows ZEGO technicians to quickly locate online problems.

Declared in ZegoDefine.cs

Properties

userID

userID
public string userID
  • Privacy reminder: Please do not fill in sensitive user information in this field, including but not limited to mobile phone number, ID number, passport number, real name, etc.
  • Caution: Only support numbers, English characters and '~', '!', '@', '#', '$', '%', '^', '&', '*', '(', ')', '_', '+', '=', '-', '`', ';', '’', ',', '.', '<', '>', ''. Do not use '%' if you need to communicate with the Web SDK.

userName

userName
public string userName

User Name, a utf8 string with a maximum length of 256 bytes or less.Please do not fill in sensitive user information in this field, including but not limited to mobile phone number, ID number, passport number, real name, etc.

Methods

ZegoUser

ZegoUser
public void ZegoUser(string userId)
Declared in ZegoDefine.cs

ZegoUser

ZegoUser
public void ZegoUser()
Declared in ZegoDefine.cs

ZegoVideoConfig

Video config.

Details

Configure parameters used for publishing stream, such as bitrate, frame rate, and resolution. Developers should note that the width and height resolution of the mobile and desktop are opposite. For example, 360p, the resolution of the mobile is 360x640, and the desktop is 640x360. When using external capture, the capture and encoding resolution of RTC cannot be set to 0*0, otherwise, there will be no video data in the publishing stream in the entire engine life cycle.

Declared in ZegoDefine.cs

Properties

captureWidth

captureWidth
public int captureWidth

Capture resolution width, control the width of camera image acquisition. SDK requires this member to be set to an even number. Only the camera is not started and the custom video capture is not used, the setting is effective. For performance reasons, the SDK scales the video frame to the encoding resolution after capturing from camera and before rendering to the preview view. Therefore, the resolution of the preview image is the encoding resolution. If you need the resolution of the preview image to be this value, Please call [setCapturePipelineScaleMode] first to change the capture pipeline scale mode to [Post].WebGL does not support Settings.

captureHeight

captureHeight
public int captureHeight

Capture resolution height, control the height of camera image acquisition. SDK requires this member to be set to an even number. Only the camera is not started and the custom video capture is not used, the setting is effective. For performance reasons, the SDK scales the video frame to the encoding resolution after capturing from camera and before rendering to the preview view. Therefore, the resolution of the preview image is the encoding resolution. If you need the resolution of the preview image to be this value, Please call [setCapturePipelineScaleMode] first to change the capture pipeline scale mode to [Post].WebGL does not support Settings.

encodeWidth

encodeWidth
public int encodeWidth

Encode resolution width, control the image width of the encoder when publishing stream. SDK requires this member to be set to an even number. The settings before and after publishing stream can be effective

encodeHeight

encodeHeight
public int encodeHeight

Encode resolution height, control the image height of the encoder when publishing stream. SDK requires this member to be set to an even number. The settings before and after publishing stream can be effective

fps

fps
public int fps

Frame rate, control the frame rate of the camera and the frame rate of the encoder. Publishing stream set to 60 fps, playing stream to take effect need contact technical support

bitrate

bitrate
public int bitrate

Bit rate in kbps. The settings before and after publishing stream can be effective. The SDK will automatically set the bit rate suitable for the scenario selected by the developer. If the bit rate manually set by the developer exceeds the reasonable range, the SDK will automatically process the bit rate according to the reasonable range. If you need to configure a high bit rate due to business needs, please contact ZEGO Business.

codecID

codecID
public ZegoVideoCodecID codecID

The codec id to be used, the default value is [default]. Settings only take effect before publishing stream

keyFrameInterval

keyFrameInterval
public int keyFrameInterval
  • Required: No.
  • Default value: 2 seconds.
  • Value range: [2, 5].
  • Caution: The setting is only valid before pushing.

Methods

ZegoVideoConfig

ZegoVideoConfig
Create video configuration with preset enumeration values
Declared in ZegoDefine.cs

ZegoVideoConfig

ZegoVideoConfig
public void ZegoVideoConfig : this(ZegoVideoConfigPreset.Preset360P)
Create default video configuration(360p, 15fps, 600000bps)
Declared in ZegoDefine.cs

360p, 15fps, 600kbps

ZegoVideoFrameParam

Object for video frame fieldeter.

Details

Including video frame format, width and height, etc.

Declared in ZegoDefine.cs

Properties

format

format
public ZegoVideoFrameFormat format

Video frame format

strides

strides
public int[] strides

Number of bytes per line (for example: BGRA only needs to consider strides [0], I420 needs to consider strides [0,1,2])

width

width
public int width

Video frame width. When use custom video capture, the video data meeting the 32-bit alignment can obtain the maximum performance. Taking BGRA as an example, width * 4 is expected to be multiple of 32.

height

height
public int height

Video frame height

rotation

rotation
public int rotation

The rotation direction of the video frame, the SDK rotates clockwise

ZegoVocalRangeParam

Vocal range configuration.

Declared in ZegoDefine.cs

Properties

min

min
public float min

The minimum distance at which the 3D sound effect starts to have attenuation effect, the value needs to be >= 0 and <= max, the default value is 0.

max

max
public float max

The maximum range of the sound, the value needs to be >= min, the default value is 0.

Methods

ZegoVocalRangeParam

ZegoVocalRangeParam
public void ZegoVocalRangeParam()
Declared in ZegoDefine.cs

ZegoVoiceChangerParam

Voice changer parameter.

Details

Developer can use the built-in presets of the SDK to change the parameters of the voice changer.

Declared in ZegoDefine.cs

Properties

pitch

pitch
public float pitch

Pitch parameter, value range [-12.0, 12.0], the larger the value, the sharper the sound, set it to 0.0 to turn off. that on v2.18.0 and older version, the value range is [-8.0, 8.0].

Methods

ZegoVoiceChangerParam

ZegoVoiceChangerParam
public void ZegoVoiceChangerParam()
Declared in ZegoDefine.cs

ZegoWatermark

Watermark object.

Details

Configure a watermark image URL and the layout of the watermark in the screen.

Declared in ZegoDefine.cs

Properties

imageURL

imageURL
public string imageURL

The path of the watermark image. Support local file absolute path (file://xxx). The format supports png, jpg. The maximum length is less than 512 bytes.

layout

layout
public ZegoRect layout

Watermark image layout

Previous

Interface

Next

Enum

On this page

Back to top