@tencent-rtc/mcp 1.2.8 → 1.3.0

package/resource/doc/trtc/iOS/TRTCCloudDef.md

@@ -0,0 +1,3730 @@
+# TRTC Real-Time Communication (TRTC SDK) Documentation
+## Overview
+`TRTCCloudDef.h` provides type definitions for TRTC Real-Time Communication (TRTC SDK) on iOS.
+
+
+## Struct Type
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Function List</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCParams](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Room entry parameters</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCVideoEncParam](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Video encoding parameters</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCNetworkQosParam](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Network flow control (Qos) parameter set</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCRenderParams](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Rendering parameters for video footage</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCQualityInfo](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Network quality</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCVolumeInfo](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Volume level</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCSpeedTestParams](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Speed Test Parameters</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCSpeedTestResult](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Network speed test results</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCVideoFrame](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Video frame information</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCAudioFrame](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Audio frame data</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCMixUser](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Description information of each screen in Cloud Mixed Streaming</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCTranscodingConfig](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Layout and Transcoding Parameters of Cloud Mixed Streaming</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCPublishCDNParam](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >The relay parameters to be set when publishing audio and video streams to non-Tencent Cloud CDN</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCAudioRecordingParams](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Local audio file recording parameters</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCLocalRecordingParams](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Local media file recording parameters</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCAudioEffectParam](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Audio Effect Parameters (Deprecated)</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCSwitchRoomConfig](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Room switching parameters</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCAudioFrameDelegateFormat](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Audio self Definition callback format parameters</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCScreenCaptureSourceInfo](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Target information for screen sharing (only applicable to desktop systems)</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCAudioParallelParams](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Parameters of the intelligent concurrent playback strategy for remote audio streams</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCUser](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >User information related to media stream publishing settings</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCPublishCdnUrl](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >URL configuration required when publishing audio and video streams to Tencent or third-party CDNs</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCPublishTarget](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Target Streaming Configuration</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCVideoLayout](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Transcoding Video Layout</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCWatermark](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Watermark Layout</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCStreamEncoderParam](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Media Stream Encoding Output Parameters</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCStreamMixingConfig](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Media Stream Transcoding Configuration Parameters</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCPayloadPrivateEncryptionConfig](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Private media stream encryption configuration</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCAudioVolumeEvaluateParams](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Volume assessment and related parameter settings</td>
+</tr>
+</table>
+
+
+## Enumeration Types
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCVideoResolution](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Video Resolution</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCVideoResolutionMode](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Video aspect ratio mode</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCVideoStreamType](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Video stream type</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCVideoFillMode](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Video fill mode</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCVideoRotation](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Video rotation direction</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCBeautyStyle](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Beauty Filter (Skin Smoothing) algorithm</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCVideoPixelFormat](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Video pixel format</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCVideoBufferType](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Video data transfer method</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCVideoMirrorType](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Video mirroring type</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCSnapshotSourceType](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Data source for local video screenshot</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCAppScene](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Use Cases</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCRoleType](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Roles</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCQosControlMode](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Traffic control mode (deprecated)</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCVideoQosPreference](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Image quality preference</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCQuality](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Network quality</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCAVStatusType](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Audio/Video status type</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCAVStatusChangeReason](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Audio/Video status change reason type</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCAudioSampleRate](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Audio sample rate</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCAudioQuality](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Sound quality</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCAudioRoute](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Audio routing (i.e., the sound playback mode)</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCReverbType](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Sound Reverb Mode</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCVoiceChangerType](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Voice Changing Type</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCSystemVolumeType](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >System Volume Type (Only applicable to mobile devices)</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCAudioFrameOperationMode](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Audio Callback Data Read/Write Mode</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCLogLevel](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Log Level</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCGSensorMode](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Gravity Sensor Switch (Only applicable to mobile devices)</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCScreenCaptureSourceType](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Target Type for Screen Sharing (Only applicable to desktop devices)</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCTranscodingConfigMode](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Layout Mode for Cloud Mixed Streaming</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCRecordType](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Media Recording Type</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCMixInputType](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Mixed Streaming Input Type</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCAudioRecordingContent](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Audio Recording Content Type</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCPublishMode](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Media Stream Publication Mode</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCEncryptionAlgorithm](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Encryption Algorithm</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCSpeedTestScene](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Speed Test Scenario</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >[TRTCGravitySensorAdaptiveMode](https://write.woa.com/document/87029873782558720)</td>
+
+<td rowspan="1" colSpan="1" >Set Adaptation Mode for Gravity Sensor (Only applicable to mobile devices)</td>
+</tr>
+</table>
+
+
+## TRTCVideoResolution
+
+
+
+#### Video Resolution
+
+Only Definition is in landscape resolution (e.g., 640 × 360). To use portrait resolution (e.g., 360 × 640), you also need to set TRTCVideoResolutionMode to Portrait.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoResolution_120_120</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Aspect Ratio 1:1; Resolution 120x120; Suggested Bitrate (VideoCall) 80kbps; Suggested Bitrate (LIVE) 120kbps.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoResolution_160_160</td>
+
+<td rowspan="1" colSpan="1" >3</td>
+
+<td rowspan="1" colSpan="1" >Aspect Ratio 1:1; Resolution 160x160; Suggested Bitrate (VideoCall) 100kbps; Suggested Bitrate (LIVE) 150kbps.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoResolution_270_270</td>
+
+<td rowspan="1" colSpan="1" >5</td>
+
+<td rowspan="1" colSpan="1" >Aspect Ratio 1:1; Resolution 270x270; Suggested Bitrate (VideoCall) 200kbps; Suggested Bitrate (LIVE) 300kbps.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoResolution_480_480</td>
+
+<td rowspan="1" colSpan="1" >7</td>
+
+<td rowspan="1" colSpan="1" >Aspect Ratio 1:1; Resolution 480x480; Suggested Bitrate (VideoCall) 350kbps; Suggested Bitrate (LIVE) 500kbps.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoResolution_160_120</td>
+
+<td rowspan="1" colSpan="1" >50</td>
+
+<td rowspan="1" colSpan="1" >Aspect Ratio 4:3; Resolution 160x120; Suggested Bitrate (VideoCall) 100kbps; Suggested Bitrate (LIVE) 150kbps.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoResolution_240_180</td>
+
+<td rowspan="1" colSpan="1" >52</td>
+
+<td rowspan="1" colSpan="1" >Aspect Ratio 4:3; Resolution 240x180; Suggested Bitrate (VideoCall) 150kbps; Suggested Bitrate (LIVE) 250kbps.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoResolution_280_210</td>
+
+<td rowspan="1" colSpan="1" >54</td>
+
+<td rowspan="1" colSpan="1" >Aspect Ratio 4:3; Resolution 280x210; Suggested Bitrate (VideoCall) 200kbps; Suggested Bitrate (LIVE) 300kbps.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoResolution_320_240</td>
+
+<td rowspan="1" colSpan="1" >56</td>
+
+<td rowspan="1" colSpan="1" >Aspect Ratio 4:3; Resolution 320x240; Suggested Bitrate (VideoCall) 250kbps; Suggested Bitrate (LIVE) 375kbps.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoResolution_400_300</td>
+
+<td rowspan="1" colSpan="1" >58</td>
+
+<td rowspan="1" colSpan="1" >Aspect Ratio 4:3; Resolution 400x300; Suggested Bitrate (VideoCall) 300kbps; Suggested Bitrate (LIVE) 450kbps.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoResolution_480_360</td>
+
+<td rowspan="1" colSpan="1" >60</td>
+
+<td rowspan="1" colSpan="1" >Aspect Ratio 4:3; Resolution 480x360; Suggested Bitrate (VideoCall) 400kbps; Suggested Bitrate (LIVE) 600kbps.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoResolution_640_480</td>
+
+<td rowspan="1" colSpan="1" >62</td>
+
+<td rowspan="1" colSpan="1" >Aspect Ratio 4:3; Resolution 640x480; Suggested Bitrate (VideoCall) 600kbps; Suggested Bitrate (LIVE) 900kbps.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoResolution_960_720</td>
+
+<td rowspan="1" colSpan="1" >64</td>
+
+<td rowspan="1" colSpan="1" >Aspect Ratio 4:3; Resolution 960x720; Suggested Bitrate (VideoCall) 1000kbps; Suggested Bitrate (LIVE) 1500kbps.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoResolution_160_90</td>
+
+<td rowspan="1" colSpan="1" >100</td>
+
+<td rowspan="1" colSpan="1" >Aspect Ratio 16:9; Resolution 160x90; Suggested Bitrate (VideoCall) 150kbps; Suggested Bitrate (LIVE) 250kbps.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoResolution_256_144</td>
+
+<td rowspan="1" colSpan="1" >102</td>
+
+<td rowspan="1" colSpan="1" >Aspect Ratio 16:9; Resolution 256x144; Suggested Bitrate (VideoCall) 200kbps; Suggested Bitrate (LIVE) 300kbps.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoResolution_320_180</td>
+
+<td rowspan="1" colSpan="1" >104</td>
+
+<td rowspan="1" colSpan="1" >Aspect Ratio 16:9; Resolution 320x180; Suggested Bitrate (VideoCall) 250kbps; Suggested Bitrate (LIVE) 400kbps.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoResolution_480_270</td>
+
+<td rowspan="1" colSpan="1" >106</td>
+
+<td rowspan="1" colSpan="1" >Aspect Ratio 16:9; Resolution 480x270; Suggested Bitrate (VideoCall) 350kbps; Suggested Bitrate (LIVE) 550kbps.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoResolution_640_360</td>
+
+<td rowspan="1" colSpan="1" >108</td>
+
+<td rowspan="1" colSpan="1" >Aspect Ratio 16:9; Resolution 640x360; Suggested Bitrate (VideoCall) 500kbps; Suggested Bitrate (LIVE) 900kbps.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoResolution_960_540</td>
+
+<td rowspan="1" colSpan="1" >110</td>
+
+<td rowspan="1" colSpan="1" >Aspect Ratio 16:9; Resolution 960x540; Suggested Bitrate (VideoCall) 850kbps; Suggested Bitrate (LIVE) 1300kbps.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoResolution_1280_720</td>
+
+<td rowspan="1" colSpan="1" >112</td>
+
+<td rowspan="1" colSpan="1" >Aspect Ratio 16:9; Resolution 1280x720; Suggested Bitrate (VideoCall) 1200kbps; Suggested Bitrate (LIVE) 1800kbps.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoResolution_1920_1080</td>
+
+<td rowspan="1" colSpan="1" >114</td>
+
+<td rowspan="1" colSpan="1" >Aspect Ratio 16:9; Resolution 1920x1080; Suggested Bitrate (VideoCall) 2000kbps; Suggested Bitrate (LIVE) 3000kbps.</td>
+</tr>
+</table>
+
+
+## TRTCVideoResolutionMode
+
+
+
+#### Video aspect ratio mode
+
+In TRTCVideoResolution, only landscape resolution (e.g., 640 × 360) is defined. To use portrait resolution (e.g., 360 × 640), you also need to set TRTCVideoResolutionMode to Portrait.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoResolutionModeLandscape</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Landscape resolution, e.g., TRTCVideoResolution_640_360 + TRTCVideoResolutionModeLandscape = 640 × 360.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoResolutionModePortrait</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Portrait resolution, e.g., TRTCVideoResolution_640_360 + TRTCVideoResolutionModePortrait = 360 × 640.</td>
+</tr>
+</table>
+
+
+## TRTCVideoStreamType
+
+
+
+#### Video stream type
+
+There are three different video streams in TRTC:
+-  HD large screen: Generally used for transmitting video data from the camera.
+
+-  Low-definition small picture: The content of the small picture is the same as the large picture, but the resolution and bitrate are lower than those of the large picture, resulting in lower clarity.
+
+-  Auxiliary stream picture: Generally used for screen sharing. Only one user can publish auxiliary stream video in the same room at the same time. Other users must wait until the current user stops before they can publish their own auxiliary stream.
+
+
+> **Note**
+> 
+
+> Low-definition small picture cannot be enabled independently. The small picture must rely on the large picture, and the SDK will automatically set the resolution and bitrate of the low-definition small picture.
+> 
+
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoStreamTypeBig</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >HD large screen: Generally used for transmitting video data from the camera.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoStreamTypeSmall</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Low-definition small picture: The content of the small picture is the same as the large picture, but the resolution and bitrate are lower than those of the large picture, resulting in lower clarity.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoStreamTypeSub</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >Auxiliary stream picture: Generally used for screen sharing. Only one user can publish auxiliary stream video in the same room at the same time. Other users must wait until the current user stops before they can publish their own auxiliary stream.</td>
+</tr>
+</table>
+
+
+## TRTCVideoFillMode
+
+
+
+#### Video fill mode
+
+When the aspect ratio of the video display area is not equal to the aspect ratio of the video content, you need to specify the fill mode.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoFillMode_Fill</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Fill mode: The content is scaled to fill the entire display area while maintaining the aspect ratio. The parts that exceed the display area will be cropped, so the image may be incomplete.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoFillMode_Fit</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Adaptive mode: The image is scaled according to the long side to fit the display area. The short sides will be filled with black bars, so the image will be complete but may have black bars.</td>
+</tr>
+</table>
+
+
+## TRTCVideoRotation
+
+
+
+#### Video rotation direction
+
+TRTC provides APIs for setting the rotation angle of local and remote video. The angles listed below are in a clockwise direction.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoRotation_0</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >No rotation.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoRotation_90</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Rotate clockwise by 90 degrees.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoRotation_180</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >Rotate clockwise by 180 degrees.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoRotation_270</td>
+
+<td rowspan="1" colSpan="1" >3</td>
+
+<td rowspan="1" colSpan="1" >Rotate clockwise by 270 degrees.</td>
+</tr>
+</table>
+
+
+## TRTCBeautyStyle
+
+
+
+#### Beauty Filter (Skin Smoothing) algorithm
+
+TRTC offers various skin smoothing algorithms. You can choose the one that best fits your product positioning.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCBeautyStyleSmooth</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Smooth: This aggressive algorithm results in a more pronounced skin smoothing effect, suitable for show live streaming.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCBeautyStyleNature</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Natural: This algorithm retains more facial details, resulting in a more natural smoothing effect, suitable for most live streaming scenarios.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCBeautyStylePitu</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >YouTu: Provided by YouTu Laboratory, this algorithm balances between smooth and natural, retaining more skin details than smooth and providing more smoothing than natural.</td>
+</tr>
+</table>
+
+
+## TRTCVideoPixelFormat
+
+
+
+#### Video pixel format
+
+TRTC provides custom data collection and custom rendering features for video:
+-  In the custom data collection feature, you can use the following enumeration values to describe the pixel format of your captured video.
+
+-  In the custom rendering feature, you can specify the pixel format you expect the SDK to call back.
+
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoPixelFormat_Unknown</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Undefined format.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoPixelFormat_I420</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >YUV420P (I420) format.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoPixelFormat_Texture_2D</td>
+
+<td rowspan="1" colSpan="1" >7</td>
+
+<td rowspan="1" colSpan="1" >OpenGL 2D texture format.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoPixelFormat_32BGRA</td>
+
+<td rowspan="1" colSpan="1" >6</td>
+
+<td rowspan="1" colSpan="1" >BGRA format</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoPixelFormat_NV12</td>
+
+<td rowspan="1" colSpan="1" >5</td>
+
+<td rowspan="1" colSpan="1" >YUV420SP (NV12) format.</td>
+</tr>
+</table>
+
+
+## TRTCVideoBufferType
+
+
+
+#### Video data transfer method
+
+In custom data collection and custom rendering features, you need to use the following enumerated values to specify how you want to transmit video data:
+-  Option 1: Transmit video data using Memory Buffer. This method is efficient on iOS, but less efficient on Android, and Windows currently only supports Memory Buffer transmission.
+
+-  Option 2: Transmit video data using Texture. This method is highly efficient on both iOS and Android, but not supported on Windows. A certain level of OpenGL programming knowledge is required.
+
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoBufferType_Unknown</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Undefined transmission method.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoBufferType_PixelBuffer</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Transmit video data using Memory Buffer, iOS: PixelBuffer; Android: Direct Buffer for JNI layer; Win: Memory Data Block.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoBufferType_NSData</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >Transmit video data using Memory Buffer, iOS: More compact NSData type memory block after an extra rearrangement; Android: byte[] for JAVA layer.<br>This transmission method is the least efficient of all the options.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoBufferType_Texture</td>
+
+<td rowspan="1" colSpan="1" >3</td>
+
+<td rowspan="1" colSpan="1" >Transmit video data using OpenGL texture.</td>
+</tr>
+</table>
+
+
+## TRTCVideoMirrorType
+
+
+
+#### Video mirroring type
+
+Video mirroring refers to flipping the video content horizontally, especially for the local camera preview video. Enabling mirroring can provide the host with a familiar "mirror" experience.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoMirrorTypeAuto</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Automatic Mode: If using the front-facing camera, enable mirroring; if using the rear-facing camera, disable mirroring (only applicable to mobile devices).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoMirrorTypeEnable</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Force On mirroring, regardless of whether the current camera is front-facing or rear-facing.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoMirrorTypeDisable</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >Force Off mirroring, regardless of whether the current camera is front-facing or rear-facing.</td>
+</tr>
+</table>
+
+
+## TRTCSnapshotSourceType
+
+
+
+#### Data source for local video screenshot
+
+The SDK supports capturing images from the following two data sources and saving them as local files:
+-  Video Stream: Capture native video content from the video stream. The captured content is not controlled by the rendering controls.
+
+-  Rendering Layer: Capture the displayed video content from the rendering controls, achieving a What You See Is What You Get (WYSIWYG) effect. However, if the display area is too small, the captured image will also be small.
+
+-  Capture Layer: Capture the video content collected by the capture controls, allowing for the extraction of high-definition screenshots.
+
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCSnapshotSourceTypeStream</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Capture native video content from the video stream. The captured content is not controlled by the rendering controls.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCSnapshotSourceTypeView</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Capture the displayed video content from the rendering controls, achieving a What You See Is What You Get (WYSIWYG) effect. However, if the display area is too small, the captured image will also be small.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCSnapshotSourceTypeCapture</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >Capture the video content collected by the capture controls, allowing for the extraction of high-definition screenshots.</td>
+</tr>
+</table>
+
+
+## TRTCAppScene
+
+
+
+#### Use Cases
+
+TRTC has optimized for common audio and video application scenarios to meet the differentiated requirements of various vertical scenarios. The main scenarios can be categorized into two types:
+-  Live Streaming (LIVE) Scenario: Includes LIVE and VoiceChatRoom. The former is audio + video, while the latter is audio only.
+
+
+In the live streaming scenario, users are divided into two roles: "Anchors" and "Audience." A single room can support up to 100,000 people online simultaneously, making it suitable for live streaming scenarios with a large audience.
+-  Real-Time (RTC) Scenario: Includes VideoCall and AudioCall. The former is audio + video, while the latter is audio only.
+
+
+In the real-time scenario, there is no role differentiation among users, but a single room can support up to 300 people online simultaneously, making it suitable for small-scale real-time communication.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAppSceneVideoCall</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Video call scenario, supports 720p and 1080p HD quality, each room can have up to 300 concurrent users, with a maximum of 50 users speaking simultaneously.<br>Applicable to [One-to-one video call], [300-person video conference], [Online consultation], [Educational small class], [Remote interview], and other business scenarios.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAppSceneLIVE</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Video interactive live streaming, supports smooth mic switching without waiting, anchor delay less than 300 ms; supports up to 100,000 concurrent viewers, with playback latency as low as 1,000 ms.<br>Applicable to [Low-latency interactive live streaming], [Large class], [Host PK], [Video blind dating], [Online interactive classroom], [Remote training], [Large-scale conferences], and other business scenarios.<br>**Note**<br>In this scenario, you must specify the current user's role through the role field in TRTCParams.<br></td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAppSceneAudioCall</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >Voice call scenario, default uses SPEECH quality, each room can have up to 300 concurrent users, with a maximum of 50 users speaking simultaneously.<br>Applicable to [One-to-one voice call], [300-person voice conference], [Voice chat], [Voice conference], [Online Werewolf Game], and other business scenarios.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAppSceneVoiceChatRoom</td>
+
+<td rowspan="1" colSpan="1" >3</td>
+
+<td rowspan="1" colSpan="1" >Voice interactive live streaming, supports smooth mic switching without waiting, anchor delay less than 300 ms; supports up to 100,000 concurrent viewers, with playback latency as low as 1,000 ms.<br>Applicable to [Voice club], [Online KTV room], [Music live broadcast room], [FM radio station], and other business scenarios.<br>**Note**<br>In this scenario, you must specify the current user's role through the role field in TRTCParams.<br></td>
+</tr>
+</table>
+
+
+## TRTCRoleType
+
+
+
+#### Roles
+
+Only applicable to live streaming scenarios (i.e., TRTCAppSceneLIVE and TRTCAppSceneVoiceChatRoom), distinguishing users into two different identities:
+-  Anchors: Can publish their own audio and video streams at any time, but the number of anchors is limited. A maximum of 50 anchors can publish their audio and video streams simultaneously in the same room.
+
+-  Audience: Can only watch other users' audio and video streams. To publish audio and video streams, they need to switch their role to anchor using [switchRole](https://write.woa.com/document/87029727163494400). A single room can accommodate up to 100,000 audience members.
+
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCRoleAnchor</td>
+
+<td rowspan="1" colSpan="1" >20</td>
+
+<td rowspan="1" colSpan="1" >Anchors: Can publish their own audio and video streams at any time, but the number of anchors is limited. A maximum of 50 anchors can publish their audio and video streams simultaneously in the same room.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCRoleAudience</td>
+
+<td rowspan="1" colSpan="1" >21</td>
+
+<td rowspan="1" colSpan="1" >Audience: Can only watch other users' audio and video streams. To publish audio and video streams, they need to switch their role to anchor using [switchRole](https://write.woa.com/document/87029727163494400). A single room can accommodate up to 100,000 audience members.</td>
+</tr>
+</table>
+
+
+## TRTCQosControlMode(Deprecated)
+
+
+
+#### Traffic control mode (deprecated)
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCQosControlModeClient</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Local Control, used for SDK development internal debugging, please do not use for customers.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCQosControlModeServer</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Cloud Control, the default mode, is recommended.</td>
+</tr>
+</table>
+
+
+## TRTCVideoQosPreference
+
+
+
+#### Image quality preference
+
+TRTC offers two adjustment modes under a weak network environment: "Prioritize Clear Picture" or "Prioritize Smooth Picture". Both modes will primarily ensure audio data transmission.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoQosPreferenceSmooth</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Smooth Priority: When the current network is insufficient to transmit both clear and smooth images, it prioritizes the smoothness of the picture, which results in a blurrier image with more mosaics.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVideoQosPreferenceClear</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >Clarity Priority (default): When the current network is insufficient to transmit both clear and smooth images, it prioritizes the clarity of the picture, which results in more stuttering.</td>
+</tr>
+</table>
+
+
+## TRTCQuality
+
+
+
+#### Network quality
+
+TRTC evaluates the current network quality every two seconds, with six evaluation levels: Excellent indicating the best, and Down indicating the worst.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCQuality_Unknown</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Undefined.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCQuality_Excellent</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >The current network is excellent.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCQuality_Good</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >The current network is good.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCQuality_Poor</td>
+
+<td rowspan="1" colSpan="1" >3</td>
+
+<td rowspan="1" colSpan="1" >The current network is average.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCQuality_Bad</td>
+
+<td rowspan="1" colSpan="1" >4</td>
+
+<td rowspan="1" colSpan="1" >The current network is poor.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCQuality_Vbad</td>
+
+<td rowspan="1" colSpan="1" >5</td>
+
+<td rowspan="1" colSpan="1" >The current network is very poor.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCQuality_Down</td>
+
+<td rowspan="1" colSpan="1" >6</td>
+
+<td rowspan="1" colSpan="1" >The current network does not meet the minimum requirements of TRTC.</td>
+</tr>
+</table>
+
+
+## TRTCAVStatusType
+
+
+
+#### Audio/Video status type
+
+This enumeration type is used for audio status change callback interfaces ([onRemoteAudioStatusUpdated](https://write.woa.com/document/87029742770499584)) and video status change callback interfaces ([onRemoteVideoStatusUpdated](https://write.woa.com/document/87029742770499584)) to specify the current audio or video status.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAVStatusStopped</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Stops playback.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAVStatusPlaying</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Playing.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAVStatusLoading</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >Loading.</td>
+</tr>
+</table>
+
+
+## TRTCAVStatusChangeReason
+
+
+
+#### Audio/Video status change reason type
+
+This enumeration type is used for audio status change callback interfaces ([onRemoteAudioStatusUpdated](https://write.woa.com/document/87029742770499584)) and video status change callback interfaces ([onRemoteVideoStatusUpdated](https://write.woa.com/document/87029742770499584)) to specify the reason for the current audio or video status change.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAVStatusChangeReasonInternal</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Default value.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAVStatusChangeReasonBufferingBegin</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Network buffering.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAVStatusChangeReasonBufferingEnd</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >End buffering.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAVStatusChangeReasonLocalStarted</td>
+
+<td rowspan="1" colSpan="1" >3</td>
+
+<td rowspan="1" colSpan="1" >Locally starts playing the audio or video stream.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAVStatusChangeReasonLocalStopped</td>
+
+<td rowspan="1" colSpan="1" >4</td>
+
+<td rowspan="1" colSpan="1" >Locally stops playing the audio or video stream.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAVStatusChangeReasonRemoteStarted</td>
+
+<td rowspan="1" colSpan="1" >5</td>
+
+<td rowspan="1" colSpan="1" >Starts (or resumes) the remote audio or video stream.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAVStatusChangeReasonRemoteStopped</td>
+
+<td rowspan="1" colSpan="1" >6</td>
+
+<td rowspan="1" colSpan="1" >Stops (or interrupts) the remote audio or video stream.</td>
+</tr>
+</table>
+
+
+## TRTCAudioSampleRate
+
+
+
+#### Audio sample rate
+
+The audio sampling rate is used to measure sound fidelity. The higher the sampling rate, the better the fidelity. If your application scenario involves music, it is recommended to use TRTCAudioSampleRate48000.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAudioSampleRate16000</td>
+
+<td rowspan="1" colSpan="1" >16000</td>
+
+<td rowspan="1" colSpan="1" >16k Sampling Rate.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAudioSampleRate32000</td>
+
+<td rowspan="1" colSpan="1" >32000</td>
+
+<td rowspan="1" colSpan="1" >32k Sampling Rate.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAudioSampleRate44100</td>
+
+<td rowspan="1" colSpan="1" >44100</td>
+
+<td rowspan="1" colSpan="1" >44.1k Sampling Rate.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAudioSampleRate48000</td>
+
+<td rowspan="1" colSpan="1" >48000</td>
+
+<td rowspan="1" colSpan="1" >48k Sampling Rate</td>
+</tr>
+</table>
+
+
+## TRTCAudioQuality
+
+
+
+#### Sound quality
+
+TRTC provides three carefully calibrated modes to meet the diverse pursuit of audio quality in various vertical scenarios:
+-  Vocal Mode (Speech): Suitable for applications focused on voice communication. This mode offers strong audio transmission resistance, ensuring optimal smoothness in weak network environments through various voice processing techniques.
+
+-  Music Mode (Music): Suitable for scenarios with high vocal demands. This mode transmits a large amount of audio data, ensuring high-fidelity detail reproduction of music signals across all frequency bands through various technologies.
+
+-  Default Mode (Default): Positioned between Speech and Music, this mode offers better music reproduction than the Vocal Mode but transmits much less data than the Music Mode. It is well-suited for various scenarios.
+
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAudioQualitySpeech</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Vocal Mode: Sampling Rate: 16k; Mono; Encoding Bitrate: 16kbps; Offers the strongest network resistance among the modes, suitable for voice-focused scenarios such as online meetings and voice calls.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAudioQualityDefault</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >Default Mode: Sampling Rate: 48k; Mono; Encoding Bitrate: 50kbps; A tier between Speech and Music, the default level of the SDK, recommended.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAudioQualityMusic</td>
+
+<td rowspan="1" colSpan="1" >3</td>
+
+<td rowspan="1" colSpan="1" >Music Mode: Sampling Rate: 48k; Full-band Stereo; Encoding Bitrate: 128kbps; Suitable for scenarios requiring high-fidelity music transmission, such as online karaoke and music live streaming.</td>
+</tr>
+</table>
+
+
+## TRTCAudioRoute
+
+
+
+#### Audio routing (i.e., the sound playback mode)
+
+Audio routing, that is, whether the sound is played through the phone's speaker or earpiece. Therefore, this interface is only applicable to mobile devices.
+
+A mobile phone has two speakers: one is the earpiece located at the top of the phone, and the other is the stereo speaker located at the bottom.
+-  When the audio routing is set to the earpiece, the sound is relatively low, and you need to bring your ear close to hear it clearly, ensuring better privacy. It is suitable for phone calls.
+
+-  When the audio routing is set to the speaker, the sound is relatively loud. You can hear it clearly without holding the phone to your face, thus enabling the "hands-free" feature.
+
+-  Audio routing to wired headphones.
+
+-  Audio routing to Bluetooth headphones.
+
+-  Audio routing to USB professional sound card device.
+
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAudioModeUnknown</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Unknown: The default routing device.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAudioModeSpeakerphone</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Speakerphone: Play sound through the speaker (i.e., "hands-free"), which is located at the bottom of the phone. The volume tends to be loud, suitable for playing music out loud.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAudioModeEarpiece</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Earpiece: Plays through the earpiece, the earpiece is located at the top of the phone, the sound is small, suitable for privacy-protected call scenarios.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAudioModeWiredHeadset</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >WiredHeadset: Plays through wired headphones.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAudioModeBluetoothHeadset</td>
+
+<td rowspan="1" colSpan="1" >3</td>
+
+<td rowspan="1" colSpan="1" >BluetoothHeadset: Plays through Bluetooth headphones.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAudioModeSoundCard</td>
+
+<td rowspan="1" colSpan="1" >4</td>
+
+<td rowspan="1" colSpan="1" >SoundCard: Plays through USB sound card.</td>
+</tr>
+</table>
+
+
+## TRTCReverbType
+
+
+
+#### Sound Reverb Mode
+
+This enumeration value is used to set the reverb mode in live streaming scenarios and is commonly used in live shows.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCReverbType_0</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Disable Reverb.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCReverbType_1</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >KTV.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCReverbType_2</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >Small room.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCReverbType_3</td>
+
+<td rowspan="1" colSpan="1" >3</td>
+
+<td rowspan="1" colSpan="1" >Great Hall.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCReverbType_4</td>
+
+<td rowspan="1" colSpan="1" >4</td>
+
+<td rowspan="1" colSpan="1" >Deep.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCReverbType_5</td>
+
+<td rowspan="1" colSpan="1" >5</td>
+
+<td rowspan="1" colSpan="1" >Loud and Clear.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCReverbType_6</td>
+
+<td rowspan="1" colSpan="1" >6</td>
+
+<td rowspan="1" colSpan="1" >Metallic Sound.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCReverbType_7</td>
+
+<td rowspan="1" colSpan="1" >7</td>
+
+<td rowspan="1" colSpan="1" >Magnetic.</td>
+</tr>
+</table>
+
+
+## TRTCVoiceChangerType
+
+
+
+#### Voice Changing Type
+
+This enumeration value is used to set the voice change mode in live streaming scenarios and is commonly used in live shows.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVoiceChangerType_0</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Disable Voice Change.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVoiceChangerType_1</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Mischievous Child.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVoiceChangerType_2</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >Lolita.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVoiceChangerType_3</td>
+
+<td rowspan="1" colSpan="1" >3</td>
+
+<td rowspan="1" colSpan="1" >Uncle.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVoiceChangerType_4</td>
+
+<td rowspan="1" colSpan="1" >4</td>
+
+<td rowspan="1" colSpan="1" >Heavy Metal.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVoiceChangerType_5</td>
+
+<td rowspan="1" colSpan="1" >5</td>
+
+<td rowspan="1" colSpan="1" >Cold.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVoiceChangerType_6</td>
+
+<td rowspan="1" colSpan="1" >6</td>
+
+<td rowspan="1" colSpan="1" >Foreigner.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVoiceChangerType_7</td>
+
+<td rowspan="1" colSpan="1" >7</td>
+
+<td rowspan="1" colSpan="1" >Trapped Beast.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVoiceChangerType_8</td>
+
+<td rowspan="1" colSpan="1" >8</td>
+
+<td rowspan="1" colSpan="1" >Fat Kid.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVoiceChangerType_9</td>
+
+<td rowspan="1" colSpan="1" >9</td>
+
+<td rowspan="1" colSpan="1" >Strong electric current.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVoiceChangerType_10</td>
+
+<td rowspan="1" colSpan="1" >10</td>
+
+<td rowspan="1" colSpan="1" >Heavy machinery.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCVoiceChangerType_11</td>
+
+<td rowspan="1" colSpan="1" >11</td>
+
+<td rowspan="1" colSpan="1" >Ethereal voice.</td>
+</tr>
+</table>
+
+
+## TRTCSystemVolumeType
+
+
+
+#### System Volume Type (Only applicable to mobile devices)
+
+Modern smartphones generally have two types of system volume: "Call Volume" and "Media Volume".
+-  Call Volume: This type of volume is specifically designed for making and receiving calls. It includes a built-in Echo Cancellation (AEC) feature and supports audio pickup through the microphone of a Bluetooth headset. However, the sound quality is generally average. If you lower the phone volume using the side volume buttons and cannot turn it to zero (i.e., mute it completely), it indicates that your phone is currently in call volume mode.
+
+-  Media Volume: This type of volume is specifically designed for music scenarios. It does not support the system's AEC feature and cannot use the Bluetooth headset's microphone for audio pickup, but it provides better music playback quality. If you lower the phone volume using the side volume buttons and can turn it to silence completely, it indicates that your phone is currently in media volume mode.
+
+
+The SDK currently offers three control modes for system volume types: Automatic Switching Mode, Full Call Volume Mode, Full Media Volume Mode.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCSystemVolumeTypeAuto</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Automatic Switching Mode:<br>Also known as "Call Volume during Mic On, Media Volume during Mic Off". It uses call volume when the host is on the mic and media volume when the audience is off the mic, suitable for online live streaming scenarios.<br>If you choose the TRTCAppSceneLIVE or TRTCAppSceneVoiceChatRoom scenario when entering the room, the SDK will automatically use this mode.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCSystemVolumeTypeMedia</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Full Media Volume:<br>Using media volume throughout the call is not a commonly used volume type; it is suitable for music scenarios with stringent sound quality requirements.<br>If most of your users use external devices (such as external sound cards), you can use this mode; otherwise, please use it cautiously.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCSystemVolumeTypeVOIP</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >Full call volume:<br>The advantage of this solution is that the audio module does not need to switch operation modes when users join/leave the mic, achieving seamless mic transitions. It is suitable for applications where users need to join/leave the mic frequently.<br>If you choose TRTCAppSceneVideoCall or TRTCAppSceneAudioCall when entering the room, the SDK will automatically use this mode.</td>
+</tr>
+</table>
+
+
+## TRTCAudioFrameOperationMode
+
+
+
+#### Audio Callback Data Read/Write Mode
+
+TRTC provides two operation modes for audio callback data.
+-  Read-Write Mode: You can retrieve and modify the callback audio data. This is the default mode.
+
+-  Read-Only Mode: You can only retrieve the audio data from the callback.
+
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAudioFrameOperationModeReadWrite</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Read-Write Mode: You can retrieve and modify the callback audio data.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAudioFrameOperationModeReadOnly</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Read-Only Mode: You can only retrieve the audio data from the callback.</td>
+</tr>
+</table>
+
+
+## TRTCLogLevel
+
+
+
+#### Log Level
+
+Different log levels define different levels of detail and log quantities. It is recommended to set the log level to TRTCLogLevelInfo under normal circumstances.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCLogLevelVerbose</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Output all levels of logs.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCLogLevelDebug</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Output DEBUG, INFO, WARNING, ERROR, and FATAL levels of logs.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCLogLevelInfo</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >Output INFO, WARNING, ERROR, and FATAL levels of logs.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCLogLevelWarn</td>
+
+<td rowspan="1" colSpan="1" >3</td>
+
+<td rowspan="1" colSpan="1" >Output WARNING, ERROR, and FATAL levels of logs.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCLogLevelError</td>
+
+<td rowspan="1" colSpan="1" >4</td>
+
+<td rowspan="1" colSpan="1" >Output ERROR and FATAL levels of logs.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCLogLevelFatal</td>
+
+<td rowspan="1" colSpan="1" >5</td>
+
+<td rowspan="1" colSpan="1" >Output only FATAL level logs.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCLogLevelNone</td>
+
+<td rowspan="1" colSpan="1" >6</td>
+
+<td rowspan="1" colSpan="1" >Do not output any SDK logs.</td>
+</tr>
+</table>
+
+
+## TRTCGSensorMode
+
+
+
+#### Gravity Sensor Switch (Only applicable to mobile devices)
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCGSensorMode_Disable</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >No gravity sensing adaptation. This mode is the default on the Desktop Platform. In this mode, the video published by the current user is not affected by changes in gravity sensing direction.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCGSensorMode_UIAutoLayout</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Adapt gravity sensing. This mode is the default on the Mobile Platform. In this mode, the video published by the current user will adjust according to the gravity sensing direction of the device, while the local preview screen remains unchanged.<br>One adaptation mode currently supported by the SDK is: when the phone or Pad is upside down, to ensure that the remote user sees the correct direction, the SDK will automatically rotate the published screen 180 degrees. If your app's interface layer has gravity sensing auto-adaptation enabled, it is recommended to use UIFixLayout mode.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCGSensorMode_UIFixLayout</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >Adapt gravity sensing<br>In this mode, the video published by the current user will adjust according to the gravity sensing direction of the device, and the local preview screen will also rotate accordingly.<br>One feature currently supported is that when the phone or Pad is upside down, to ensure that the remote user sees the correct direction, the SDK will automatically rotate the published screen 180 degrees.<br>If your app's interface layer does not support gravity sensing auto-adaptation and you want the SDK's video to adapt to gravity sensing direction, it is recommended to use UIFixLayout mode.<br>@deprecated From version v11.5, TRTCGSensorMode_UIFixLayout is no longer supported, only the above two modes are supported.</td>
+</tr>
+</table>
+
+
+## TRTCScreenCaptureSourceType
+
+
+
+#### Target Type for Screen Sharing (Only applicable to desktop devices)
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCScreenCaptureSourceTypeUnknown</td>
+
+<td rowspan="1" colSpan="1" >-1</td>
+
+<td rowspan="1" colSpan="1" >Undefined.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCScreenCaptureSourceTypeWindow</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >The share target is a window of an application.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCScreenCaptureSourceTypeScreen</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >The share target is the screen of a monitor.</td>
+</tr>
+</table>
+
+
+## TRTCTranscodingConfigMode
+
+
+
+#### Layout Mode for Cloud Mixed Streaming
+
+TRTC's cloud mixed streaming service can combine multiple audio and video streams in a room into one stream. Therefore, you need to specify a layout plan for the screen. We offer the following layout modes.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCTranscodingConfigMode_Unknown</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Undefined.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCTranscodingConfigMode_Manual</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Fully Manual Layout Mode.<br>In this mode, you need to specify the exact layout position for each screen. This mode offers the highest degree of freedom but is the least user-friendly:<br>-  You need to fill in all parameters in TRTCTranscodingConfig, including the position coordinates for each screen (TRTCMixUser).<br>-  You need to monitor the onUserVideoAvailable() and onUserAudioAvailable() event callbacks in TRTCCloudDelegate and constantly adjust the mixUsers parameters based on the audio and video status of each user in the room.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCTranscodingConfigMode_Template_PureAudio</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >Pure Audio Mode.<br>This mode is suitable for voice call (AudioCall) and voice chat room (VoiceChatRoom) audio-only applications.<br>-  After entering the room, you only need to set up the mixing configuration once through the setMixTranscodingConfig interface. The SDK will then automatically mix the audio of all on-mic users in the room into the current user's live stream.<br>-  You don't need to set the mixUsers parameters in TRTCTranscodingConfig. Just set the audioSampleRate, audioBitrate, and audioChannels parameters.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCTranscodingConfigMode_Template_PresetLayout</td>
+
+<td rowspan="1" colSpan="1" >3</td>
+
+<td rowspan="1" colSpan="1" >Pre-layout Mode.<br>The most popular layout mode because it supports pre-setting the positions of each screen using placeholders, and then the SDK will automatically adapt and adjust based on the number of screens in the room.<br>In this mode, you still need to set the mixUsers parameters, but you can set the userId to "Placeholder". The available placeholders are:<br>-  "$PLACE_HOLDER_REMOTE$"     :  Represents the remote user's screen. Multiple instances can be set.<br>-  "$PLACE_HOLDER_LOCAL_MAIN$" : Represents the local camera screen. Only one instance is allowed.<br>-  "$PLACE_HOLDER_LOCAL_SUB$"  :  Represents the local screen sharing. Only one instance is allowed.<br>In this mode, you do not need to listen to the onUserVideoAvailable and onUserAudioAvailable callbacks in TRTCCloudDelegate for real-time adjustment. Just call setMixTranscodingConfig once after entering the room successfully, and the SDK will automatically fill the real userId into the placeholders you set.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCTranscodingConfigMode_Template_ScreenSharing</td>
+
+<td rowspan="1" colSpan="1" >4</td>
+
+<td rowspan="1" colSpan="1" >Screen Sharing Mode.<br>Suitable for online education scenarios and other screen sharing-centric applications, this mode is only supported on Windows and Mac SDKs.<br>In this mode, the SDK will first build a canvas based on the target resolution you set via the videoWidth and videoHeight parameters,<br>-  If the teacher does not activate the screen sharing, the SDK will proportionally stretch and draw the teacher's camera feed onto the canvas;<br>-  When the teacher activates screen sharing, the SDK will draw the screen sharing feed onto the same canvas.<br>The purpose of this layout is to ensure that the output resolution of the stream mixing module is consistent, avoiding screen tearing issues during course playback and web viewing (web players do not support variable resolutions).<br>Additionally, the students' audio will be mixed into the teacher's audio and video stream by default.<br>Since video content in teaching mode is primarily screen sharing, simultaneously transmitting the camera feed and the screen sharing feed is very bandwidth-intensive.<br>The recommended approach is to directly render the camera feed onto the current screen via the setLocalVideoRenderCallback interface.<br>In this mode, you don't need to set the mixUsers parameters in TRTCTranscodingConfig. The SDK will not mix the students' screens to prevent interference with the screen sharing effect.<br>You can set the width x height in TRTCTranscodingConfig to 0px × 0px. The SDK will automatically calculate a suitable resolution based on the user's current screen aspect ratio<br>-  If the teacher's current screen width is <= 1920px, the SDK will use the actual resolution of the teacher's current screen.<br>-  If the teacher's current screen width is > 1920px, the SDK will choose one of the three resolutions based on the current screen aspect ratio: 1920x1080 (16:9), 1920x1200 (16:10), or 1920x1440 (4:3).</td>
+</tr>
+</table>
+
+
+## TRTCRecordType
+
+
+
+#### Media Recording Type
+
+This enumeration type is used for the local media recording interface [startLocalRecording](https://write.woa.com/document/87029727163494400) to specify whether to record audio and video files or pure audio files.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCRecordTypeAudio</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Audio recording only.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCRecordTypeVideo</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Video recording only.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCRecordTypeBoth</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >Record both audio and video.</td>
+</tr>
+</table>
+
+
+## TRTCMixInputType
+
+
+
+#### Mixed Streaming Input Type
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCMixInputTypeUndefined</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Default value. Considering compatibility with older versions, if you specify the inputType as Undefined, the SDK will determine the mixed input type based on the value of another parameter, pureAudio.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCMixInputTypeAudioVideo</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Mix both audio and video.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCMixInputTypePureVideo</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >Mix video only.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCMixInputTypePureAudio</td>
+
+<td rowspan="1" colSpan="1" >3</td>
+
+<td rowspan="1" colSpan="1" >Mix audio only.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCMixInputTypeWatermark</td>
+
+<td rowspan="1" colSpan="1" >4</td>
+
+<td rowspan="1" colSpan="1" >Mix watermarks. In this case, you do not need to specify the userId field but need to specify the image field. Using png format images is recommended.</td>
+</tr>
+</table>
+
+
+## TRTCAudioRecordingContent
+
+
+
+#### Audio Recording Content Type
+
+This enumeration type is used for the audio recording interface [startAudioRecording](https://write.woa.com/document/87029727163494400) to specify the content of the audio to be recorded.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAudioRecordingContentAll</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Record all local and remote audio.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAudioRecordingContentLocal</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Record local audio only.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCAudioRecordingContentRemote</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >Record remote audio only.</td>
+</tr>
+</table>
+
+
+## TRTCPublishMode
+
+
+
+#### Media Stream Publication Mode
+
+This enumeration type is used for the media stream publishing interface [startPublishMediaStream](https://write.woa.com/document/87029727163494400). TRTC's media stream publishing service can mix multiple audio and video streams in the room into one stream and publish it to a CDN or push it back to the room. You can also publish your current audio and video stream to Tencent or a third-party CDN. Therefore, you need to specify the publishing mode of the corresponding media stream. We provide the following modes.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCPublishModeUnknown</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Undefined.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCPublishBigStreamToCdn</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >You can set this parameter to publish the main stream ([TRTCVideoStreamTypeBig](https://write.woa.com/document/87029873782558720)) in your room to Tencent or third-party live streaming CDN services (only supports standard RTMP protocol).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCPublishSubStreamToCdn</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >You can set this parameter to publish the substream ([TRTCVideoStreamTypeSub](https://write.woa.com/document/87029873782558720)) in your room to Tencent or third-party live streaming CDN services (only supports standard RTMP protocol).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCPublishMixStreamToCdn</td>
+
+<td rowspan="1" colSpan="1" >3</td>
+
+<td rowspan="1" colSpan="1" >You can set this parameter, together with encoding output parameters ([TRTCStreamEncoderParam](https://write.woa.com/document/87029873782558720)) and mix stream transcoding parameters ([TRTCStreamMixingConfig](https://write.woa.com/document/87029873782558720)), to transcode and publish your specified multiple audio and video streams to Tencent or third-party live streaming CDN services (only supports standard RTMP protocol).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCPublishMixStreamToRoom</td>
+
+<td rowspan="1" colSpan="1" >4</td>
+
+<td rowspan="1" colSpan="1" >You can set this parameter, together with media stream encoding output parameters ([TRTCStreamEncoderParam](https://write.woa.com/document/87029873782558720)) and mix stream transcoding parameters ([TRTCStreamMixingConfig](https://write.woa.com/document/87029873782558720)), to transcode and publish your specified multiple audio and video streams into your specified room.<br>-  Specify the robot information for the pushback room through [TRTCPublishTarget](https://write.woa.com/document/87029873782558720) TRTCUser.</td>
+</tr>
+</table>
+
+
+## TRTCEncryptionAlgorithm
+
+
+
+#### Encryption Algorithm
+
+This enumeration type is used for the selection of the private encryption algorithm for media streams.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCEncryptionAlgorithmAes128Gcm</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >AES GCM 128.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCEncryptionAlgorithmAes256Gcm</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >AES GCM 256.</td>
+</tr>
+</table>
+
+
+## TRTCSpeedTestScene
+
+
+
+#### Speed Test Scenario
+
+This enumeration type is used for selecting the speed test scenario.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCSpeedTestScene_DelayTesting</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Latency test.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCSpeedTestScene_DelayAndBandwidthTesting</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >Latency and bandwidth test.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCSpeedTestScene_OnlineChorusTesting</td>
+
+<td rowspan="1" colSpan="1" >3</td>
+
+<td rowspan="1" colSpan="1" >Online chorus test.</td>
+</tr>
+</table>
+
+
+## TRTCGravitySensorAdaptiveMode
+
+
+
+#### Set Adaptation Mode for Gravity Sensor (Only applicable to mobile devices)
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration</td>
+
+<td rowspan="1" colSpan="1" >Value</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCGravitySensorAdaptiveMode_Disable</td>
+
+<td rowspan="1" colSpan="1" >0</td>
+
+<td rowspan="1" colSpan="1" >Turn off gravity sensing. Based on the current captured resolution and the set encoding resolution, if they are inconsistent, rotate by 90 degrees to ensure the maximum frame size.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCGravitySensorAdaptiveMode_FillByCenterCrop</td>
+
+<td rowspan="1" colSpan="1" >1</td>
+
+<td rowspan="1" colSpan="1" >Enable gravity sensing. Always ensure the remote screen image is correct. When there is a resolution inconsistency, use the centered cropping mode.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >TRTCGravitySensorAdaptiveMode_FitWithBlackBorder</td>
+
+<td rowspan="1" colSpan="1" >2</td>
+
+<td rowspan="1" colSpan="1" >Enable gravity sensing. Always ensure the remote screen image is correct. When there is a resolution inconsistency, use the black border overlay mode.</td>
+</tr>
+</table>
+
+
+## TRTCParams
+
+
+
+#### Room entry parameters
+
+As an entry parameter for the TRTC SDK, only if this parameter is filled in correctly can you successfully enter the audio and video room specified by roomId or strRoomId.
+
+Due to historical reasons, TRTC supports two types of room numbers, numeric and string, which are roomId and strRoomId respectively.
+
+Please note: Do not mix roomId and strRoomId, as they are not interchangeable. For example, the number 123 and the string "123" are considered two completely different rooms in TRTC.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >bussInfo</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Business data field (optional). This field is required for some advanced features.<br>[Recommended Value] Please do not set this field yourself.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >privateMapKey</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Permission ticket used for permission control (optional). If you want only specific userIds to enter a room, you need to use privateMapKey for permission protection.<br>[Recommended Value] Only recommended for customers with high-level security requirements. For more details, please refer to [Room Entry Permission Protection](https://cloud.tencent.com/document/product/647/32240).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >role</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Role in live streaming scenarios, only applicable to live streaming scenarios ([TRTCAppSceneLIVE](https://write.woa.com/document/87029873782558720) and [TRTCAppSceneVoiceChatRoom](https://write.woa.com/document/87029873782558720)). Specifying this parameter in a calling scenario is ineffective.<br>[Recommended Value] Default value: Anchor ([TRTCRoleAnchor](https://write.woa.com/document/87029873782558720)).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >roomId</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Numeric room number, where users (userId) in the same room can see each other and make audio and video calls.<br>[Recommended Value] Value range: 1 - 4294967294.<br>[Special Explanation] roomId and strRoomId are mutually exclusive. If you choose strRoomId, roomId must be set to 0. If both are filled, the SDK will prioritize roomId.<br>[Please note] Do not mix roomId and strRoomId as they are not interchangeable. For example, the number 123 and the string `123` are considered two entirely different rooms in TRTC.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >sdkAppId</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Application Identifier (Required). Tencent Cloud uses sdkAppId for billing statistics.<br>[Recommended Value] This ID can be obtained from the account information page after creating an application in the [TRTC Console](https://console.cloud.tencent.com/rav/).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >strRoomId</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] String room number, where users (userId) in the same room can see each other and make audio and video calls.<br>[Special Explanation] roomId and strRoomId are mutually exclusive. If you choose strRoomId, roomId must be set to 0. If both are filled, the SDK will prioritize roomId.<br>[Please note] Do not mix roomId and strRoomId as they are not interchangeable. For example, the number 123 and the string `123` are considered two entirely different rooms in TRTC.<br>[Recommended Value] Length limit is 64 bytes. The following character set range is supported (a total of 89 characters):<br>-  Upper and lowercase English letters (a-zA-Z);<br>-  Numbers (0-9);<br>-  Space,` ! `,` # `,` $ `,` % `,` & `,` ( `,` ) `,` + `,` - `,` : `,` ; `,` < `,` = `,` . `,` > `,` ? `,` @ `,` [ `,` ] `,` ^ `,` _ `,` { `,` } `,` \| `,` ~ `,` , `.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >streamId</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Used to specify the streamId on the Tencent CSS platform (optional). Once set, you can play the user's audio and video streams on the Tencent CSS CDN through the standard pull streaming scheme (FLV or HLS).<br>[Recommended Value] Length limit is 64 bytes and can be left blank. A recommended scheme is to use ` sdkappid_roomid_userid_main ` as the streamId. This naming convention is easy to identify and will not conflict with your multiple applications.<br>[Special Note] To use Tencent CSS CDN, you need to first enable the "Automatic Bypass Live Streaming" switch on the feature configuration page in the [console](https://console.cloud.tencent.com/trtc/).<br>[Reference Document][CDN Bypass Live Streaming](https://cloud.tencent.com/document/product/647/16826).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >userDefineRecordId</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Cloud recording switch (optional). Used to specify whether to record this user's audio and video streams in the cloud.<br>[Reference Document][Cloud Recording](https://cloud.tencent.com/document/product/647/16823).<br>[Recommended Value] Length limit is 64 bytes. Only uppercase and lowercase English letters (a-zA-Z), numbers (0-9), underscores, and hyphens are allowed.<br>Scheme 1: Manual Recording Scheme:<br>1. Enable Cloud Recording in the [Console](https://console.cloud.tencent.com/trtc)>Application Management>Cloud Recording Configuration.<br>2. Set the ` recording mode ` to ` manual recording `.<br>3. After setting manual recording, only users who set the userDefineRecordId parameter in a TRTC room will have recorded video files on the cloud. Users who do not specify this parameter will not be recorded.<br>4. The cloud will name the recorded files in the format "userDefineRecordId_start time_end time".<br>Scheme 2: Automatic Recording Scheme:<br>1. Enable Cloud Recording in the [Console](https://console.cloud.tencent.com/trtc)>Application Management>Cloud Recording Configuration.<br>2. Set the ` recording mode ` to ` automatic recording `.<br>3. After setting automatic recording, any user with audio/video uplink in a TRTC room will have recorded video files on the cloud.<br>4. The files will be named in the format ` userDefineRecordId_start time_end time `. If userDefineRecordId is not specified, the files will be named in the format ` streamId_start time_end time `.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >userId</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] User Identification (Required). The current user's userId, equivalent to username, using UTF-8 encoding.<br>[Recommended Value] If a user's ID in your account system is "mike", then userId can be set to "mike".</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >userSig</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] User Signature (Required). The verification signature corresponding to the current userId, equivalent to using the cloud service's login password.<br>[Recommended Value] For the specific calculation method, please see [How to Calculate UserSig](https://cloud.tencent.com/document/product/647/17275).</td>
+</tr>
+</table>
+
+
+## TRTCVideoEncParam
+
+
+
+#### Video encoding parameters
+
+This setting determines the picture quality seen by remote users and also the picture quality of the video files recorded on the cloud.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >enableAdjustRes</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Whether to allow dynamic resolution adjustment (enabling this will impact cloud recording).<br>[Recommended Value] This feature is suitable for scenarios where cloud recording is not needed. When enabled, the SDK will intelligently select an appropriate resolution based on the current network conditions to avoid inefficient encoding modes like "high resolution + low bitrate".<br>[Special Note] Default value: Disabled. If you need cloud recording, do not enable this feature because if the video resolution changes, the recorded MP4 on the cloud cannot be played properly on regular players.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >minVideoBitrate</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Minimum video bitrate. The SDK will actively lower the video bitrate when the network is poor to maintain smoothness, with the minimum lowered to the value set by minVideoBitrate.<br>[Special Note] Default value: 0, in which case the minimum bitrate will be automatically calculated by the SDK based on the resolution you specified.<br>[Recommended Value] You can set both videoBitrate and minVideoBitrate parameters simultaneously to constrain the SDK's video bitrate adjustment range:<br>-  If you pursue ` allowing stuttering under weak networks but maintaining clarity `, you can set minVideoBitrate to 60% of videoBitrate.<br>-  If you pursue ` allowing blurriness under weak networks but maintaining smoothness `, you can set minVideoBitrate to a lower value (e.g., 100kbps).<br>-  If you set videoBitrate and minVideoBitrate to the same value, it is equivalent to disabling the SDK's adaptive video bitrate adjustment capability.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >resMode</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Resolution Mode (horizontal resolution or vertical resolution).<br>[Recommended Value] For mobile platforms (iOS, Android), it is recommended to choose Portrait. For desktop platforms (Windows, Mac), it is recommended to choose Landscape.<br>[Special Note] If you need to use vertical resolution, specify resMode as Portrait, e.g., 640 × 360 + Portrait = 360 × 640.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >videoBitrate</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Target video bitrate. The SDK will encode according to the target bitrate and will only actively lower the video bitrate in weak network environments.<br>[Recommended Value] Please refer to the optimal bitrate annotations for each level in TRTCVideoResolution, which can also be appropriately increased. For example, TRTCVideoResolution_1280_720 corresponds to a target bitrate of 1200kbps, but you can set it to 1500kbps for better visual clarity.<br>[Special Note] You can set both videoBitrate and minVideoBitrate parameters simultaneously to constrain the SDK's video bitrate adjustment range:<br>-  If you prefer "allowing stuttering under weak network conditions but maintaining clarity," you can set minVideoBitrate to 60% of videoBitrate.<br>-  If you prefer "allowing blurring under weak network conditions but maintaining smoothness," you can set minVideoBitrate to a lower value (e.g., 100kbps).<br>-  If you set videoBitrate and minVideoBitrate to the same value, it is equivalent to disabling the SDK's adaptive video bitrate adjustment capability.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >videoFps</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Video capture frame rate.<br>[Recommended Value] 15fps or 20fps. Below 5fps, lag sensation is noticeable. Below 10fps, there will be slight lag. Above 20fps, it will waste bandwidth (the frame rate of movies is 24fps).<br>[Special Note] Some Android phones' front-facing cameras do not support a capture frame rate above 15fps. The capture frame rate of the front-facing camera of some Android phones with a beauty feature may be below 10fps.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >videoResolution</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Video resolution.<br>[Special Note] If you need to use vertical resolution, specify resMode as Portrait, e.g., 640 × 360 + Portrait = 360 × 640.<br>[Recommended Values]<br>-  Mobile video call: It is recommended to choose 360 × 640 or lower resolution, with resMode set to Portrait (vertical resolution).<br>-  Mobile online live streaming: It is recommended to choose 540 × 960, with resMode set to Portrait (vertical resolution).<br>-  Desktop platform (Win + Mac): It is recommended to choose 640 × 360 or higher resolution, with resMode set to Landscape (horizontal resolution).</td>
+</tr>
+</table>
+
+
+## TRTCNetworkQosParam
+
+
+
+#### Network flow control (Qos) parameter set
+
+Network traffic control parameters, this setting determines the SDK's adjustment strategy in poor network conditions (for example: "Clarity Priority" or "Smoothness Priority").
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >controlMode</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Flow control mode (deprecated).<br>[Recommended Values] Cloud Control.<br>[Special Note] Please set it to Cloud Control mode (TRTCQosControlModeServer).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >preference</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Clarity Priority or Smooth Priority.<br>[Recommended Values] Clarity Priority.<br>[Special Note] This parameter mainly affects TRTC's audio and video performance in poor network environments:<br>-  Smooth Priority: When the current network is insufficient to transmit both clear and smooth images, it prioritizes the smoothness of the picture, which results in a blurrier image with more mosaics. See [TRTCVideoQosPreferenceSmooth](https://write.woa.com/document/87029873782558720)<br>-  Clarity Priority (default): When the current network is insufficient to transmit both clear and smooth images, it prioritizes the clarity of the picture, which results in more stuttering. See [TRTCVideoQosPreferenceClear](https://write.woa.com/document/87029873782558720)</td>
+</tr>
+</table>
+
+
+## TRTCRenderParams
+
+
+
+#### Rendering parameters for video footage
+
+You can control the screen's rotation angle, fill mode, and left-right mirror mode by setting this parameter.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >fillMode</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Screen Fill Mode.<br>[Recommended Values] Fill (the screen may be stretched or cropped) or Fit (the screen may have black edges), Default: [TRTCVideoFillMode_Fill](https://write.woa.com/document/87029873782558720).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >mirrorType</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Screen Mirror Mode.<br>[Recommended Values] Default value: [TRTCVideoMirrorTypeAuto](https://write.woa.com/document/87029873782558720).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >rotation</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Clockwise rotation angle of the image.<br>[Recommended Values] Supports 90, 180, and 270-degree rotation angles, Default: [TRTCVideoRotation_0](https://write.woa.com/document/87029873782558720).</td>
+</tr>
+</table>
+
+
+## TRTCQualityInfo
+
+
+
+#### Network quality
+
+Represents the quality of the network. This value can be used to display each user's network quality on the user interface.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >quality</td>
+
+<td rowspan="1" colSpan="1" >Network quality</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >userId</td>
+
+<td rowspan="1" colSpan="1" >User ID</td>
+</tr>
+</table>
+
+
+## TRTCVolumeInfo
+
+
+
+#### Volume level
+
+Represents the evaluation value of voice volume. This value can be used to display each user's volume on the user interface.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >pitch</td>
+
+<td rowspan="1" colSpan="1" >The voice frequency of the local user (in Hz), range [0 - 4000]. For remote users, this value is always 0.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >spectrumData</td>
+
+<td rowspan="1" colSpan="1" >Audio spectrum data represents the distribution of audio data in the frequency domain, divided into 256 frequency bands. The spectrumData records the energy value of each frequency band, each energy value ranges from [-300, 0], in dBFS.<br>**Note**<br>Local spectrum is calculated using the audio data before encoding, affected by local collection volume and BGM, etc. Remote spectrum is calculated using received audio data, and local adjustments to remote playback volume will not affect it.<br></td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >userId</td>
+
+<td rowspan="1" colSpan="1" >The userId of the speaker. If the userId is empty, it represents the current user.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >vad</td>
+
+<td rowspan="1" colSpan="1" >Detect vocals or not, 0: Non-vocals, 1: Vocals.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >volume</td>
+
+<td rowspan="1" colSpan="1" >The speaker's volume. Value range: [0-100].</td>
+</tr>
+</table>
+
+
+## TRTCSpeedTestParams
+
+
+
+#### Speed test parameters
+
+You can test the network speed before the user enters the room through the [startSpeedTest](https://write.woa.com/document/87029727163494400) interface (Note: Do not call during a call).
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >expectedDownBandwidth</td>
+
+<td rowspan="1" colSpan="1" >Expected downstream bandwidth (kbps, value range: 10–5000, 0 means not to test).<br>**Note**<br>When the parameter scene is set to TRTCSpeedTestScene_OnlineChorusTesting, to obtain more accurate RTT/jitter information, the value range is limited to 10–1000.<br></td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >expectedUpBandwidth</td>
+
+<td rowspan="1" colSpan="1" >Expected upstream bandwidth (kbps, value range: 10–5000, 0 means not to test).<br>**Note**<br>When the parameter scene is set to TRTCSpeedTestScene_OnlineChorusTesting, to obtain more accurate RTT/jitter information, the value range is limited to 10–1000.<br></td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >scene</td>
+
+<td rowspan="1" colSpan="1" >Speed Testing Scenario.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >sdkAppId</td>
+
+<td rowspan="1" colSpan="1" >Application identifier, please refer to the relevant instructions in [TRTCParams](https://write.woa.com/document/87029873782558720).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >userId</td>
+
+<td rowspan="1" colSpan="1" >User identifier, please refer to the relevant instructions in [TRTCParams](https://write.woa.com/document/87029873782558720).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >userSig</td>
+
+<td rowspan="1" colSpan="1" >User signature, please refer to the relevant instructions in [TRTCParams](https://write.woa.com/document/87029873782558720).</td>
+</tr>
+</table>
+
+
+## TRTCSpeedTestResult
+
+
+
+#### Network speed test results
+
+You can test the network speed before the user enters the room through the [startSpeedTest](https://write.woa.com/document/87029727163494400) interface (Note: Do not call during a call).
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >availableDownBandwidth</td>
+
+<td rowspan="1" colSpan="1" >Downstream bandwidth (kbps, -1: invalid value).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >availableUpBandwidth</td>
+
+<td rowspan="1" colSpan="1" >Uplink bandwidth (kbps, -1: invalid value).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >downJitter</td>
+
+<td rowspan="1" colSpan="1" >Downlink packet jitter (ms), indicating the stability of data communication in the user's current network environment. The smaller the value, the better. The normal value range is 0ms to 100ms. -1 means that the speed test did not obtain a valid value. Generally, WiFi networks have slightly higher jitter than 4G/5G environments.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >downLostRate</td>
+
+<td rowspan="1" colSpan="1" >Downlink packet loss rate, the value range is [0 - 1.0]. For example, 0.2 means that out of every 10 packets received from the server, 2 might be lost mid-transmission.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >errMsg</td>
+
+<td rowspan="1" colSpan="1" >Bandwidth test error information.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >ip</td>
+
+<td rowspan="1" colSpan="1" >Server IP address.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >quality</td>
+
+<td rowspan="1" colSpan="1" >Internal evaluation algorithm calculates the network quality. For more information, please refer to [TRTCQuality](https://write.woa.com/document/87029873782558720).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >rtt</td>
+
+<td rowspan="1" colSpan="1" >Latency (ms), representing the round-trip network time between the current device and the TRTC server. The smaller the value, the better. The normal value range is 10ms to 100ms.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >success</td>
+
+<td rowspan="1" colSpan="1" >Test success or failure.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >upJitter</td>
+
+<td rowspan="1" colSpan="1" >Uplink packet jitter (ms), indicating the stability of data communication in the user's current network environment. The smaller the value, the better. The normal value range is 0ms to 100ms. -1 means that the speed test did not obtain a valid value. Generally, WiFi networks have slightly higher jitter than 4G/5G environments.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >upLostRate</td>
+
+<td rowspan="1" colSpan="1" >Uplink packet loss rate, the value range is [0 - 1.0]. For example, 0.3 means that out of every 10 packets sent to the server, 3 might be lost mid-transmission.</td>
+</tr>
+</table>
+
+
+## TRTCVideoFrame
+
+
+
+#### Video frame information
+
+TRTCVideoFrame describes the raw data of a video frame, which is the video frame data before encoding or after decoding.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >bufferType</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Video data structure type.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >data</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Video data when bufferType is [TRTCVideoBufferType_NSData](https://write.woa.com/document/87029873782558720), containing a memory data block of NSData type.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >height</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Video height.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >pixelBuffer</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Video data when bufferType is [TRTCVideoBufferType_PixelBuffer](https://write.woa.com/document/87029873782558720), containing PixelBuffer exclusive to the iOS platform.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >pixelFormat</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Pixel format of the video.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >rotation</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Clockwise rotation angle of video pixels.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >textureId</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Video Texture ID, video data when bufferType is [TRTCVideoBufferType_Texture](https://write.woa.com/document/87029873782558720), containing texture data for OpenGL rendering.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >timestamp</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Timestamp of the video frame, in milliseconds.<br>[Recommended values] Can be set to 0 when capturing Definition video. If this parameter is 0, the SDK will automatically populate the timestamp field, but please control the intervals of sendCustomVideoData calls "evenly".</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >width</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Video width.</td>
+</tr>
+</table>
+
+
+## TRTCAudioFrame
+
+
+
+#### Audio frame data
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >channels</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Number of channels.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >data</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Audio data.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >extraData</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Extra audio data. The data written by the remote user through ` onLocalProcessedAudioFrame ` will be callbacked via this field.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >sampleRate</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Sample rate.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >timestamp</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Timestamp, in milliseconds.</td>
+</tr>
+</table>
+
+
+## TRTCMixUser
+
+
+
+#### Description information of each stream in Cloud Mixed Streaming
+
+TRTCMixUser is used to specify the position, size, layer, stream type, etc., of each video screen in Cloud Mixed Streaming.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >image</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Placeholder Image or Watermark Image<br>-  A placeholder image refers to an image displayed in the mixed screen when the corresponding userId's mixed content is pure audio.<br>-  A watermark image refers to a semi-transparent image pasted on the mixed screen, always covering the mixed screen.<br>-  When you specify inputType as TRTCMixInputTypePureAudio, the image is a placeholder image, and you need to specify the userId.<br>-  When you specify inputType as TRTCMixInputTypeWatermark, the image is a watermark image, and you do not need to specify the userId.<br>[Recommended Values] Default: empty, which means no placeholder image or watermark image is set.<br>[Special Note]<br>-  You can set the image to an asset ID found in the console. This requires you to click the [Add Image] button to upload it beforehand in "[Console](https://console.cloud.tencent.com/trtc) => Application Management => Feature Configuration => Asset Management".<br>-  Upon successful upload, you will receive a corresponding "image ID". Convert the "image ID" into a string and set it to the image field accordingly (e.g., if the "image ID" is 63, you can set image to @"63").<br>-  You can also set the image to a URL address, and Tencent Cloud's backend server will mix the image specified by the URL into the final screen.<br>-  The URL length is limited to 512 bytes. The size of the image must not exceed 2MB.<br>-  Supported image formats include png, jpg, jpeg, and bmp. It is recommended to use semi-transparent png images as watermarks.<br>-  The image is only effective when inputType is set to TRTCMixInputTypePureAudio or TRTCMixInputTypeWatermark.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >inputType</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Specifies the mixed content of the stream (only audio, only video, mixed audio and video, watermarking).<br>[Default Value] Default: TRTCMixInputTypeUndefined.<br>[Special Note]<br>-  When inputType is set to TRTCMixInputTypeUndefined and pureAudio is set to YES, it is equivalent to setting inputType to TRTCMixInputTypePureAudio.<br>-  When inputType is set to TRTCMixInputTypeUndefined and pureAudio is set to NO, it is equivalent to setting inputType to TRTCMixInputTypeAudioVideo.<br>-  When inputType is set to TRTCMixInputTypeWatermark, you do not need to specify the userId field but must specify the image field.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >pureAudio</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Specifies whether the stream is audio-only.<br>[Recommended Values] Default: NO.<br>[Special Note] Deprecated. It is recommended to use the newly introduced field inputType starting from version 8.5.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >rect</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Specifies the coordinate area of the screen (unit: pixels).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >renderMode</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] The display mode of the screen during output.<br>[Recommended Values] Default: for video streams, 0.0 for cropping, 1 for scaling, and 2 for scaling with a black background.<br>[Special Note] The watermark image and placeholder image currently do not support setting renderMode. Default forced stretching is applied.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >roomID</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] The room number of the audio and video stream (setting it to an empty value represents the room number of the current user).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >soundLevel</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] The volume level of the audio participating in the mix (range: 0 - 100).<br>[Default Value] Default: 100.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >streamType</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies whether this video stream is a main stream ([TRTCVideoStreamTypeBig](https://write.woa.com/document/87029873782558720)) or a sub-stream ([TRTCVideoStreamTypeSub](https://write.woa.com/document/87029873782558720)).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >userId</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] User ID</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >zOrder</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the level of the screen (Range: 1 - 15, unique).</td>
+</tr>
+</table>
+
+
+## TRTCTranscodingConfig
+
+
+
+#### Layout and transcoding parameters for Cloud Mixed Streaming
+
+For specifying the layout position and encoding parameters of each screen during mix streaming and on-cloud transcoding.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >appId</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] AppID of Tencent CSS service.<br>[Recommended Value] Please click in sequence in the [TRTC console](https://console.cloud.tencent.com/trtc) [Application Management]=>[Application Information], and obtain the appid from [CDN Live Streaming Info].</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >audioBitrate</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the target audio bitrate for cloud transcoding.<br>[Recommended Value] Default: 64kbps, range: [32,192].</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >audioChannels</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the number of audio channels for cloud transcoding.<br>[Recommended Value] Default: 1, representing mono. The allowable values are: 1 - mono, 2 - stereo.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >audioCodec</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the output stream audio encoding type for cloud transcoding.<br>[Recommended Value] Default: 0, representing LC-AAC. The allowable values are: 0 - LC-AAC, 1 - HE-AAC, 2 - HE-AACv2.<br>[Special Explanation] HE-AAC and HE-AACv2 support output stream audio sample rates of [48000, 44100, 32000, 24000, 16000].<br>[Special Explanation] When audio encoding is set to HE-AACv2, only stereo output is supported.<br>[Special Note] HE-AAC and HE-AACv2 values only take effect when the output stream is the additional streamId you set.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >audioSampleRate</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the target audio sampling rate for cloud transcoding.<br>[Recommended Values] Default: 48000Hz. Supports 12000Hz, 16000Hz, 22050Hz, 24000Hz, 32000Hz, 44100Hz, 48000Hz.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >backgroundColor</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the background color of the mixed-screen.<br>[Recommended Values] Default: 0x000000 represents black. The format is a hexadecimal number, e.g., "0x61B9F1" represents RGB values as (97,158,241).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >backgroundImage</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the background image of the mixed-screen.<br>[Recommended Values] Default: empty, meaning no background image is set.<br>[Special Note]<br>-  You can set the image to an asset ID found in the console. This requires you to click the [Add Image] button to upload it beforehand in "[Console](https://console.cloud.tencent.com/trtc) => Application Management => Feature Configuration => Asset Management".<br>-  Upon successful upload, you will receive a corresponding "image ID". Convert the "image ID" into a string and set it to the image field accordingly (e.g., if the "image ID" is 63, you can set image to @"63").<br>-  You can also set the image to a URL address, and Tencent Cloud's backend server will mix the image specified by the URL into the final screen.<br>-  The URL length is limited to 512 bytes. The size of the image must not exceed 2MB.<br>-  Supported image formats include png, jpg, jpeg, and bmp.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >bizId</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] bizid of Tencent CSS service.<br>[Recommended Value] Please click in sequence in the [ TRTC Console](https://console.cloud.tencent.com/trtc) [Application Management] => [Application Information], and obtain the bizid from [CDN Live Streaming Info].</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >mixUsers</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the position, size, layer, and stream type information for each video screen in the cloud mix.<br>[Recommended Values] This field is an array of TRTCMixUser type. Each element in the array represents the information for each screen.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >mode</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Layout mode.<br>[Recommended Values] Please choose according to your business scenario requirements. Pre-layout mode is a well-suited option.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >streamId</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Live stream ID for output to CDN.<br>[Recommended Value] Default: Null Value, meaning that the multiple audio and video streams in the room will ultimately be mixed into the interface caller's audio and video stream.<br>-  If this parameter is not set, the SDK will execute the default logic, meaning the multiple audio and video streams in the room will be mixed into the interface caller's audio and video stream, i.e., A + B => A.<br>-  If you set this parameter, the SDK will mix the multiple audio and video streams in the room into the live stream you specified, i.e., A + B => C (C represents the streamId you specified).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >videoBitrate</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the target video bitrate (kbps) for cloud transcoding.<br>[Recommended Value] If set to 0, TRTC will estimate a reasonable bitrate based on videoWidth and videoHeight. You can also refer to the bitrate value recommended in the video resolution enum Definition (see the comment section).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >videoFramerate</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the target video frame rate (FPS) for cloud transcoding.<br>[Recommended Value] Default: 15fps, range: (0,30].</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >videoGOP</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the target video keyframe interval (GOP) for cloud transcoding.<br>[Recommended Value] Default: 2 seconds, range: [1,8].</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >videoHeight</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the target resolution (height) for cloud transcoding.<br>[Recommended Value] Unit: Pixel Value. Recommended value: 640. If you are only mixing audio streams, set both width and height to 0, otherwise, the mixed transcoding live stream will have a black background.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >videoSeiParams</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Stream Mixing SEI Parameters. Not specified by default.<br>[Special Note] Parameters are passed in as a JSON String. Example:<br>`{`<br>`  "payLoadContent":"xxx",`<br>`  "payloadType":5,`<br>`  "payloadUuid":"1234567890abcdef1234567890abcdef",`<br>`  "interval":1000,`<br>`  "followIdr":false`<br>`}`<br>Supported fields and their meanings:<br>-  payloadContent: Required. The payload content of the transparent SEI; cannot be empty<br>-  payloadType: Required. The type of SEI message, with a range of values: 5, or integers within [100, 254] (excluding 244, which is an internal self-definition timestamp SEI);<br>-  payloadUuid: Required when payloadType is 5, otherwise this value is ignored. This value must be a 32-character hexadecimal number;<br>-  interval: Optional, default is 1000. The sending interval of SEI, in milliseconds;<br>-  followIdr: Optional, default is false. When set to true, SEI will be ensured with keyframes, otherwise, it will not be ensured.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >videoWidth</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the target resolution (width) for cloud transcoding.<br>[Recommended Value] Unit: Pixel Value. Recommended value: 360. If you are only mixing audio streams, set both width and height to 0, otherwise, the mixed transcoding live stream will have a black background.</td>
+</tr>
+</table>
+
+
+## TRTCPublishCDNParam
+
+
+
+#### Retweet parameters when publishing audio and video streams to non-Tencent Cloud CDN
+
+The TRTC backend service supports publishing audio and video streams to third-party live streaming CDN service providers using the standard RTMP protocol.
+
+If you are using Tencent CSS CDN Service, you can disregard this parameter and use the [startPublish](https://write.woa.com/document/87029727163494400) interface directly.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >appId</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] AppID of Tencent CSS service.<br>[Recommended Value] Please click in sequence in the [TRTC console](https://console.cloud.tencent.com/trtc) [Application Management]=>[Application Information], and obtain the appid from [CDN Live Streaming Info].</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >bizId</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] bizid of Tencent CSS service.<br>[Recommended Value] Please click in sequence in the [ TRTC Console](https://console.cloud.tencent.com/trtc) [Application Management] => [Application Information], and obtain the bizid from [CDN Live Streaming Info].</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >streamId</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] The streamId that needs to be relayed.<br>[Recommended Value] Default value: empty. If not filled, the default relay is the bidder's bypass stream.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >url</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the streaming address (RTMP format) of the audio and video stream on the third-party live streaming service provider.<br>[Recommended Value] The rules for the streaming address vary greatly between service providers. Please fill in a valid streaming URL according to the requirements of the target service provider. The TRTC backend server will publish the standard format audio and video streams to the third-party provider according to the URL you filled in.<br>[Special Instructions] The streaming URL must be in RTMP format and comply with your target live streaming service provider's specifications, otherwise, the target service provider will reject push-stream requests from the TRTC backend services.</td>
+</tr>
+</table>
+
+
+## TRTCAudioRecordingParams
+
+
+
+#### Recording parameters for local audio files
+
+This parameter is used to specify recording parameters in the audio recording interface [startAudioRecording](https://write.woa.com/document/87029727163494400).
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >filePath</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] The save path of the recording file (required).<br>[Special Instructions] This path must include the file name and format suffix, as the suffix determines the format of the recording file. The currently supported formats are PCM, WAV, and AAC.<br>For example: If you specify the path as "mypath/record/audio.aac", it means you want the SDK to generate an AAC format audio recording file.<br>Please specify a legal path with read and write permissions, otherwise the recording file cannot be generated.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >maxDurationPerFile</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] maxDurationPerFile recording file split duration, unit: milliseconds, minimum value: 10000. The default value is 0, which means no splitting.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >recordingContent</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Audio recording content type.<br>[Special Instructions] By default, all local and remote audio is recorded.</td>
+</tr>
+</table>
+
+
+## TRTCLocalRecordingParams
+
+
+
+#### Recording parameters for local media files
+
+This parameter is used to specify recording-related parameters in the local media file recording interface [startLocalRecording](https://write.woa.com/document/87029727163494400).
+
+The interface startLocalRecording is an enhanced version of the interface startAudioRecording. The former can record video files, while the latter can only record audio files.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >filePath</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] The address of the recording file (required). Please ensure the path has read and write permissions and is legal, otherwise the recording file cannot be generated.<br>[Special Instructions] This path must be precise to the file name and format suffix. The suffix determines the format of the recorded file. Currently, the only supported format is MP4.<br>For example: If you specify the path as "mypath/record/test.mp4", it means you want the SDK to generate a local video file in MP4 format.<br>Please specify a legal path with read and write permissions, otherwise the recording file cannot be generated.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >interval</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] interval recording information update frequency, unit: milliseconds, valid range: 1000-10000. Default value is -1, meaning no callback.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >maxDurationPerFile</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] maxDurationPerFile recording file split duration, unit: milliseconds, minimum value: 10000. The default value is 0, which means no splitting.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >recordType</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Media recording type, default value: TRTCRecordTypeBoth, meaning to record both audio and video simultaneously.</td>
+</tr>
+</table>
+
+
+## TRTCSwitchRoomConfig
+
+
+
+#### Room Switching Parameters
+
+This parameter is used for the room switching interface [switchRoom](https://write.woa.com/document/87029727163494400), allowing users to quickly switch from one room to another.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >privateMapKey</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Permission ticket used for permission control (optional). If you want only specific userIds to enter a room, you need to use privateMapKey for permission protection.<br>[Recommended Value] Only recommended for customers with high-level security requirements. For more details, please refer to [Room Entry Permission Protection](https://cloud.tencent.com/document/product/647/32240).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >roomId</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Numeric room number [optional], users in the same room can see each other and have audio and video calls.<br>[Recommended Value] Value range: 1 - 4294967294.<br>[Special Note] roomId and strRoomId must and can only fill one. If both are filled, roomId is preferred.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >strRoomId</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] String room number [optional], users in the same room can see each other and have audio and video calls.<br>[Special Note] roomId and strRoomId must and can only fill one. If both are filled, roomId is preferred.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >userSig</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] User signature [optional], the verification signature corresponding to the current userId, equivalent to a log-in password.<br>If you do not specify a newly calculated userSig when switching rooms, the SDK will continue using the userSig specified when you entered the room (enterRoom).<br>You must ensure the old userSig is within its valid period when switching rooms; otherwise, the room switch will fail.<br>[Recommended Value] For the specific calculation method, please see [How to Calculate UserSig](https://cloud.tencent.com/document/product/647/17275).</td>
+</tr>
+</table>
+
+
+## TRTCAudioFrameDelegateFormat
+
+
+
+#### Format parameters for audio custom callback
+
+This parameter is used in the audio self Definition callback related interfaces to set the format of the audio data retrieved by the SDK callback (including sampling rate, number of channels, etc.).
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >channels</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Number of channels.<br>[Recommended Value] Default: 1, representing mono. The allowable values are: 1 - mono, 2 - stereo.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >mode</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Callback data read/write mode<br>[Recommended Values] TRTCAudioFrameOperationModeReadOnly: only retrieve audio data from the callback. The available modes are TRTCAudioFrameOperationModeReadOnly and TRTCAudioFrameOperationModeReadWrite.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >sampleRate</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Sample rate.<br>[Recommended Values] Default: 48000Hz. Supports 16000, 32000, 44100, 48000.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >samplesPerCall</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Number of sampling points.<br>[Recommended Values] The value must be an integer multiple of sampleRate/100.</td>
+</tr>
+</table>
+
+
+## TRTCScreenCaptureSourceInfo
+
+
+
+#### Target information for screen sharing (only applicable to desktop systems)
+
+When users are sharing a screen, they can choose to capture the entire desktop or just a specific program window.
+
+TRTCScreenCaptureSourceInfo describes the target information to be shared, including ID, name, thumbnail, etc. The field information in this structure is read-only.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >extInfo</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Extended information of the window.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >icon</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Icon of the shared window.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >sourceId</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] The ID of the capture source: for a window, this field represents the window ID; for a screen, this field represents the monitor ID.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >sourceName</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Capturing source name (encoded in UTF8).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >thumbnail</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Thumbnail of the shared window.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >type</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Collection source type (Is it sharing the entire screen or a specific window?).</td>
+</tr>
+</table>
+
+
+## TRTCAudioParallelParams
+
+
+
+#### Parameters for Intelligent Concurrent Playback Strategy of Remote Audio Stream
+
+This parameter is used to set the intelligent concurrent playback strategy for remote audio streams.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >includeUsers</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Designated users who will definitely be able to play concurrently.<br>[Special note] List of user IDs for guaranteed concurrent playback. These users are not part of the intelligent selection.<br>The number of includeUsers must be less than maxCount, otherwise, the concurrent playback setting is invalid.<br>includeUsers is only effective when maxCount > 0. When includeUsers is effective, the maximum number of concurrent intelligent selections = maxCount - the number of effective includeUsers.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >maxCount</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Maximum number of concurrent playbacks. Default value: 0.<br>-  If maxCount > 0 and the actual number of users > maxCount, SDK will intelligently select maxCount streams for playback in real-time, significantly reducing performance consumption.<br>-  If maxCount = 0, SDK will not limit the number of concurrent playbacks, which might cause performance issues in rooms with a high number of participants.</td>
+</tr>
+</table>
+
+
+## TRTCUser
+
+
+
+#### User information on media stream publishing configuration
+
+You can set this parameter, along with media stream target publishing parameters ([TRTCPublishTarget](https://write.woa.com/document/87029873782558720)) and stream mixing transcoding parameters ([TRTCStreamMixingConfig](https://write.woa.com/document/87029873782558720)), to transcode multiple audio and video streams you specify and publish them to the target publishing address you provide
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >intRoomId</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Numeric room number, which needs to match the room number type in your join room parameters ([TRTCParams](https://write.woa.com/document/87029873782558720)).<br>[Recommended Value] Value range: 1 - 4294967294.<br>[Special Note] intRoomId and strRoomId are mutually exclusive. If you choose strRoomId in your room entry parameters, then intRoomId needs to be set to 0. If both are filled, the SDK will prioritize intRoomId.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >strRoomId</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] String room number, which needs to match the room number type in your join room parameters ([TRTCParams](https://write.woa.com/document/87029873782558720)).<br>[Special Note] intRoomId and strRoomId are mutually exclusive. If you choose roomId in your room entry parameters, then strRoomId does not need to be filled. If both are filled, the SDK will prioritize intRoomId.<br>[Recommended Value] Length limit is 64 bytes. The following character set range is supported (a total of 89 characters):<br>-  Upper and lowercase English letters (a-zA-Z);<br>-  Numbers (0-9);<br>-  Space,` ! `,` # `,` $ `,` % `,` & `,` ( `,` ) `,` + `,` - `,` : `,` ; `,` < `,` = `,` . `,` > `,` ? `,` @ `,` [ `,` ] `,` ^ `,` _ `,` { `,` } `,` \| `,` ~ `,` , `.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >userId</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] User identifier, the current user's userId, equivalent to username, using UTF-8 encoding.<br>[Recommended Value] If a user's ID in your account system is "mike", then userId can be set to "mike".</td>
+</tr>
+</table>
+
+
+## TRTCPublishCdnUrl
+
+
+
+#### URL configuration for publishing audio and video streams to Tencent or third-party CDN
+
+This configuration is for the target streaming configuration ([TRTCPublishTarget](https://write.woa.com/document/87029873782558720)) in the media stream publishing interface [startPublishMediaStream](https://write.woa.com/document/87029727163494400)
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >isInternalLine</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies whether the audio and video stream is published to Tencent Cloud.<br>[Recommended Values] Default: true.<br>[Special Instructions] If your target live streaming service provider is Tencent, set this parameter to true. The backend billing system will not charge for the retweet service fee in this case.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >rtmpUrl</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the streaming address (RTMP format) of the audio and video stream on Tencent or third-party live streaming service providers.<br>[Recommended Value] The rules for the streaming address vary greatly between service providers. Please fill in a valid streaming URL according to the requirements of the target service provider. The TRTC backend server will publish the standard format audio and video streams to the third-party provider according to the URL you filled in.<br>[Special Instructions] The streaming URL must be in RTMP format and comply with your target live streaming service provider's specifications, otherwise, the target service provider will reject push-stream requests from the TRTC backend services.</td>
+</tr>
+</table>
+
+
+## TRTCPublishTarget
+
+
+
+#### Target Push Configuration
+
+This configuration is for the media stream publishing interface [startPublishMediaStream](https://write.woa.com/document/87029727163494400).
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >cdnUrlList</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] The streaming address (RTMP format) for publishing to Tencent or third-party live streaming service providers.<br>[Special Instructions] If your mode is set to TRTCPublishMixStreamToRoom, you do not need to set this parameter.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >mixStreamIdentity</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Push-back Room Robot Information.<br>[Special Instructions] You need to set this parameter only if your mode is set to TRTCPublishMixStreamToRoom.<br>[Special Instructions] After setting, the transcoded audio and video data will be pushed back to your specified room. It is recommended to set a special userId to avoid confusion between the push-back robot and the host using the TRTC SDK to join the room.<br>[Special Instructions] Users involved in stream mixing cannot subscribe to the transcoded stream.<br>[Special Note] When the subscription mode you set before entering the room ([setDefaultStreamRecvMode](https://write.woa.com/document/87029727163494400)) is set to manual, you will need to manage the audio and video streams you wish to pull yourself (typically, when you pull the transcoding stream of the room, you should unsubscribe from the corresponding audio and video single streams involved in transcoding).<br>[Special Explanation] If the subscription mode you set before entering the room ([setDefaultStreamRecvMode](https://write.woa.com/document/87029727163494400)) is automatic, users not participating in transcoding will automatically receive the transcoded stream sent by the backend and will no longer receive the audio and video single streams involved in transcoding. Unless you explicitly unsubscribe ([muteRemoteVideoStream](https://write.woa.com/document/87029727163494400) and [muteRemoteAudio](https://write.woa.com/document/87029727163494400)), the transcoded stream data will continue to be sent.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >mode</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Media Stream Publishing Mode.<br>[Recommended Values] Please choose according to your business scenario requirements. TRTC supports relay, transcoding, and rollback to RTC room modes.<br>[Special Explanation] If your business scenario requires multiple publishing modes, you can call the media stream publishing interface ([startPublishMediaStream](https://write.woa.com/document/87029727163494400)) multiple times and set different TRTCPublishTargets separately.<br>[Special Explanation] For the same mode, please correspond to a media stream publishing interface ([startPublishMediaStream](https://write.woa.com/document/87029727163494400)), and use updatePublishCDNStream for updates when adjustments are needed later.</td>
+</tr>
+</table>
+
+
+## TRTCVideoLayout
+
+
+
+#### Transcode Video Layout
+
+This configuration is for the transcoding settings ([TRTCStreamMixingConfig](https://write.woa.com/document/87029873782558720)) in the media stream publishing interface ([startPublishMediaStream](https://write.woa.com/document/87029727163494400)).
+
+For specifying the position, size, layer, and stream type of each video screen in the transcoded stream.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >backgroundColor</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the background color of the mixed-screen.<br>[Recommended Values] Default: 0x000000 represents black. The format is a hexadecimal number, e.g., "0x61B9F1" represents RGB values as (97,158,241).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >fillMode</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Screen Fill Mode.<br>[Recommended Values] Fill (the screen may be stretched or cropped) or Fit (the screen may have black edges), Default: [TRTCVideoFillMode_Fill](https://write.woa.com/document/87029873782558720).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >fixedVideoStreamType</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies whether this video stream is a main stream ([TRTCVideoStreamTypeBig](https://write.woa.com/document/87029873782558720)) or a sub-stream ([TRTCVideoStreamTypeSub](https://write.woa.com/document/87029873782558720)).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >fixedVideoUser</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] User Information Participating in Transcoding.<br>[Special Note] User information ([TRTCUser](https://write.woa.com/document/87029873782558720)) can be left unfilled (i.e., userId, intRoomId, and strRoomId are all left blank). In this case, when there is an anchor streaming audio and video data in the room initiating the stream mix, the TRTC back-end server will automatically populate the corresponding anchor's audio and video into your specified layout.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >placeHolderImage</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Placeholder image URL, i.e., when the specified user is temporarily only sending audio, Tencent Cloud's back-end server will mix the image specified by this URL into the final screen.<br>[Recommended Values] Default: empty, which means no placeholder image is set.<br>[Special Note] At this time, you need to specify the user information for fixedVideoUser's userId.<br>[Special Note]<br>-  The URL length is limited to 512 bytes. The size of the image must not exceed 2MB.<br>-  Supported image formats include png, jpg, jpeg, and bmp. It is recommended to use semi-transparent png images as placeholders.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >rect</td>
+
+<td rowspan="1" colSpan="1" >[Field meaning] Specifies the coordinate area of the screen (unit: pixels).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >zOrder</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the level of the screen (Range: 0 - 15, unique).</td>
+</tr>
+</table>
+
+
+## TRTCWatermark
+
+
+
+#### Watermark Layout
+
+This configuration is used in the Transcoding Configuration ([TRTCStreamMixingConfig](https://write.woa.com/document/87029873782558720)) of the Media Stream Publishing Interface ([startPublishMediaStream](https://write.woa.com/document/87029727163494400))
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >rect</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the coordinate area of the watermark screen (unit: pixels).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >watermarkUrl</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Watermark URL, Tencent Cloud's back-end server will mix the image specified by this URL into the final screen.<br>[Special Note]<br>-  The URL length is limited to 512 bytes. The size of the image must not exceed 2MB.<br>-  Supported image formats include png, jpg, jpeg, and bmp. It is recommended to use semi-transparent png images as watermarks.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >zOrder</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the level of the watermark screen (Range: 0 - 15, unique).</td>
+</tr>
+</table>
+
+
+## TRTCStreamEncoderParam
+
+
+
+#### Media Stream Encoding Output Parameters
+
+[Field Meaning] This configuration is used in the Media Stream Publishing Interface ([startPublishMediaStream](https://write.woa.com/document/87029727163494400)).
+
+[Special Note] When the mode configuration in your publishing target ([TRTCPublishTarget](https://write.woa.com/document/87029873782558720)) is set to TRTCPublish_MixStream_ToCdn or TRTCPublish_MixStream_ToRoom, this parameter is required.
+
+[Special Explanation] When you use the retweet service (mode is TRTCPublish_BigStream_ToCdn or TRTCPublish_SubStream_ToCdn), to ensure better stability and CDN play compatibility, it is also recommended that you fill in the specific parameters of this configuration.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >audioEncodedChannelNum</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the target audio channel count for the media publish stream.<br>[Recommended Value] Default: 1, representing mono. The allowable values are: 1 - mono, 2 - stereo.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >audioEncodedCodecType</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the target audio encoding type for the media publish stream.<br>[Recommended Value] Default: 0, representing LC-AAC. The allowable values are: 0 - LC-AAC, 1 - HE-AAC, 2 - HE-AACv2.<br>[Special Explanation] HE-AAC and HE-AACv2 support output stream audio sample rates of [48000, 44100, 32000, 24000, 16000].<br>[Special Explanation] When audio encoding is set to HE-AACv2, only stereo output is supported.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >audioEncodedKbps</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the target audio bitrate (kbps) for the media publish stream.<br>[Recommended Value] Default: 50kbps, range: [32,192].</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >audioEncodedSampleRate</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the target audio sampling rate for the media publish stream.<br>[Recommended Value] Default: 48000Hz. Values are [48000, 44100, 32000, 24000, 16000, 8000], unit is Hz.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >videoEncodedCodecType</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the target video encoding type for the media publish stream.<br>[Recommended Value] Default: 0, representing H264. The allowable values are: 0 - H264, 1 - H265.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >videoEncodedFPS</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the target video frame rate (FPS) for the media publish stream.<br>[Recommended Value] Recommended value: 20fps, range: (0,30].</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >videoEncodedGOP</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the target video keyframe interval (GOP) for the media publish stream.<br>[Recommended Value] Recommended value: 3 seconds, range: [1,5].</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >videoEncodedHeight</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the target resolution (height) for the media publish stream.<br>[Recommended Value] Unit: Pixel Value. Recommended value: 640. If you are only mixing audio streams, set both width and height to 0, otherwise, the mixed transcoding live stream will have a black background.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >videoEncodedKbps</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the target video bitrate (kbps) for the media publish stream.<br>[Recommended Values] If set to 0, TRTC will estimate a reasonable bitrate based on videoEncodedWidth and videoEncodedHeight. You can also refer to the bitrate value recommended in the video resolution enum Definition (see the comment section).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >videoEncodedWidth</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the target resolution (width) for the media publish stream.<br>[Recommended Values] Unit: Pixel Value. Recommended value: 368. If you are only mixing audio streams, set both width and height to 0, otherwise, the mixed transcoding live stream will have a black background.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >videoSeiParams</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Stream Mixing SEI Parameters. Not specified by default.<br>[Special Note] Parameters are passed in as a JSON String. Example:<br>`{`<br>`  "payLoadContent":"xxx",`<br>`  "payloadType":5,`<br>`  "payloadUuid":"1234567890abcdef1234567890abcdef",`<br>`  "interval":1000,`<br>`  "followIdr":false`<br>`}`<br>Supported fields and their meanings:<br>-  payloadContent: Required. The payload content of the transparent SEI; cannot be empty<br>-  payloadType: Required. The type of SEI message, with a range of values: 5, or integers within [100, 254] (excluding 244, which is an internal self-definition timestamp SEI);<br>-  payloadUuid: Required when payloadType is 5, otherwise this value is ignored. This value must be a 32-character hexadecimal number;<br>-  interval: Optional, default is 1000. The sending interval of SEI, in milliseconds;<br>-  followIdr: Optional, default is false. When set to true, SEI will be ensured with keyframes, otherwise, it will not be ensured.</td>
+</tr>
+</table>
+
+
+## TRTCStreamMixingConfig
+
+
+
+#### Media Stream Transcoding Configuration Parameters
+
+This configuration is used for the media stream publish interface ([startPublishMediaStream](https://write.woa.com/document/87029727163494400)).
+
+For specifying the layout position information of each screen and the input audio information during transcoding.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >audioMixUserList</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the information of each input audio stream in the transcoding stream.<br>[Recommended Values] This field is an array of TRTCUser type. Each element in the array represents information for each input audio stream.<br>[Special Note] User information can be left blank (i.e., audioMixUserList is empty). In this case, if the audio-related encoding output parameters in TRTCStreamEncoderParam are set, the TRTC backend server will automatically mix the audio of all hosts (currently supports up to 16 audio and video inputs).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >backgroundColor</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the background color of the mixed-screen.<br>[Recommended Values] Default: 0x000000 represents black. The format is a hexadecimal number, e.g., "0x61B9F1" represents RGB values as (97,158,241).</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >backgroundImage</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the background image URL for the mixed screen. Tencent Cloud's backend server will mix the image specified by the URL into the final screen.<br>[Recommended Values] Default: empty, meaning no background image is set.<br>[Special Note]<br>-  The URL length is limited to 512 bytes. The size of the image must not exceed 2MB.<br>-  Supported image formats include png, jpg, jpeg, and bmp. It is recommended to use semi-transparent png images as background images.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >videoLayoutList</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the position, size, layer, and stream type information for each video screen in the mixed picture.<br>[Recommended Values] This field is an array of TRTCVideoLayout type. Each element in the array represents the information for each screen.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >watermarkList</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Specifies the position, size, layer, etc., information for each watermarked screen in the mixed picture.<br>[Recommended Values] This field is an array of TRTCWatermark type. Each element in the array represents the information for each watermark.</td>
+</tr>
+</table>
+
+
+## TRTCPayloadPrivateEncryptionConfig
+
+
+
+#### Media Stream Private Encryption Configuration
+
+This configuration is used to set the algorithm and key for private media stream encryption.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >encryptionAlgorithm</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Encryption algorithm, default is TRTCEncryptionAlgorithmAes128Gcm.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >encryptionKey</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Encryption key, string type.<br>[Recommended Values] If the encryption algorithm is TRTCEncryptionAlgorithmAes128Gcm, the key length needs to be 16 bytes; if the encryption algorithm is TRTCEncryptionAlgorithmAes256Gcm, the key length needs to be 32 bytes.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >encryptionSalt</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Salt, initial vector for encryption.<br>[Recommended Values] Ensure that the array filled in for this parameter is not empty, not all zeros, and the data length is 32 bytes.</td>
+</tr>
+</table>
+
+
+## TRTCAudioVolumeEvaluateParams
+
+
+
+#### Volume Assessment and related parameter settings
+
+This setting is used to enable voice detection and sound spectrum calculation.
+<table>
+<tr>
+<td rowspan="1" colSpan="1" >Enumeration Types</td>
+
+<td rowspan="1" colSpan="1" >Description</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >enablePitchCalculation</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Whether to enable local voice frequency calculation</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >enableSpectrumCalculation</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Whether to enable sound spectrum calculation.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >enableVadDetection</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Whether to enable local voice detection.<br>[Please Note] It takes effect only when called before startLocalAudio.</td>
+</tr>
+
+<tr>
+<td rowspan="1" colSpan="1" >interval</td>
+
+<td rowspan="1" colSpan="1" >[Field Meaning] Sets the trigger interval for the onUserVoiceVolume callback, in milliseconds. The minimum interval is 100ms. If the value is less than or equal to 0, the callback will be disabled.<br>[Recommended Value] Recommended value: 300 milliseconds.<br>[Special Instruction] When the interval is greater than 0, the volume prompt will be enabled by default without additional settings.</td>
+</tr>
+</table>