Type Definition
Last updated: 2023-10-30 10:55:29Download PDF
Enumeration Definition
TUIRoomDefine
Type | Description |
Room Type | |
Mic Control Mode | |
Room Media Device Type | |
TUIRole | Room Role Type |
Video Quality | |
Audio Quality | |
Video Stream Type | |
Change Reason (User audio and video status change operation reason: self-modification or modified by room owner/administrator) | |
Screen Sharing Capture Source Type | |
Request Type |
TUICommonDefine
Type | Description |
Network Quality |
Common Structure
TUIRoomDefine
Type | Description |
Room data | |
User Login Information | |
Room User Information | |
Room Seat Information | |
Lock Seat Operation Parameters | |
Room User Volume | |
Signaling Request | |
Screen Sharing Capture Source Information |
TUICommonDefine
Type | Description |
Network Quality Information | |
Message | |
Image Info |
TUIRoomType
Room Type
Enumeration | Value | Description |
kConference | 1 | Conference Type Room, suitable for conference and education scenarios, this room can enable free speech, apply for speech, go live and other modes. |
kLivingRoom | 2 | Live Type Room, suitable for live broadcast scenarios, this room can enable free speech, mic control mode, and the seats in this room are numbered. |
TUISpeechMode
Mic Control Mode
Enumeration | Value | Description |
kFreeToSpeak | 1 | Free speech mode. |
kApplyToSpeak | 2 | Apply to speak mode. (Only effective in conference type room) |
kApplySpeakAfterTakingSeat | 3 | Go Live mode. |
TUIMediaDevice
Room Media Device Type
Enumeration | Value | Description |
kMicrophone | 1 | Mic |
kCamera | 2 | Camera |
kApplyScreenSharing | 3 | Screen Sharing |
TUIRole
Room Role Types
Enumeration | Value | Description |
kRoomOwner | 0 | Room Owner, generally refers to the creator of the room, the highest authority holder in the room |
kAdministrator | 1 | Room Administrator |
kGeneralUser | 2 | General Member in the room |
TUIVideoQuality
Video Quality
Enumeration | Value | Description |
kVideoQuality_360P | 1 | Low-quality 360P |
kVideoQuality_540P | 2 | Standard Definition 540P |
kVideoQuality_720P | 3 | High Definition 720P |
kVideoQuality_1080P | 4 | Ultra-clear 1080P |
TUIAudioQuality
Audio Quality
Enumeration | Value | Description |
kAudioQualitySpeech | 0 | Speech Mode |
kAudioQualityDefault | 1 | Default Mode |
kAudioQualityMusic | 2 | Music Mode |
TUIVideoStreamType
Video Stream Type
Enumeration | Value | Description |
kCameraStream | 0 | High-quality Camera Video Stream |
kScreenStream | 1 | Screen Sharing Video Stream |
kCameraStreamLow | 2 | Low-quality Camera Video Stream |
TUIChangeReason
Change Reason (User audio and video status change operation reason: self-modification or modification by room owner/administrator)
Enumeration | Value | Description |
kChangedBySelf | 0 | Self-operation |
kChangedByAdmin | 1 | Room Owner or Administrator Operation |
TUICaptureSourceType
Screen Sharing Capture Source Type
Enumeration | Value | Description |
kUnknown | -1 | Undefined |
kWindow | 0 | Window |
kScreen | 1 | Screen |
TUIRequestAction
Request Type
Enumeration | Value | Description |
kInvalidAction | 0 | Invalid Request |
kRequestToOpenRemoteCamera | 1 | Request Remote User to Open Camera |
kRequestToOpenRemoteMicrophone | 2 | Request Remote User to Open Microphone |
kRequestToConnectOtherRoom | 3 | Request to Connect to Other Room |
kRequestToTakeSeat | 4 | Request to Go Live |
kRequestRemoteUserOnSeat | 5 | Request Remote User to Go Live |
kApplyToAdminToOpenLocalCamera | 6 | Request to Admin to Open Local Camera |
kApplyToAdminToOpenLocalMicrophone | 7 | Request to Admin to Open Local Microphone |
TUINetworkQuality
Network Quality
Enumeration | Value | Description |
kQualityUnknown | 0 | Undefined |
kQualityExcellent | 1 | Current Network is Excellent |
kQualityGood | 2 | Current Network is Good |
kQualityPoor | 3 | Current Network is Average |
kQualityBad | 4 | Current Network is Poor |
kQualityVeryBad | 5 | Current Network is Very Poor |
kQualityDown | 6 | Current Network Does Not Meet TRTC's Minimum Requirements |
TUIRoomInfo
Room Information
Field | Type | Description |
roomId | const char* | Room ID |
ownerId | const char* | Host ID, default is the room creator (read-only) |
roomType | Room Type | |
name | const char* | Room Name, default is the room ID |
speechMode | Mic Control Mode | |
isCameraDisableForAllUser | bool | Whether to Disable Opening Camera (optional when creating a room), default value: false |
isMicrophoneDisableForAllUser | bool | Whether to Disable Opening Microphone (optional when creating a room), default value: false |
isMessageDisableForAllUser | bool | Whether to Disable Sending Messages (optional when creating a room), default value: false |
maxSeatCount | int | Maximum Number of Mic Seats |
createTime | long | Room Creation Time (read-only) |
memberCountt | int | Number of Members in the Room (read-only) |
TUILoginUserInfo
User Login Information
Field | Type | Description |
userId | const char* | User ID |
userName | const char* | User Name |
avatarUrl | const char* | User Avatar URL |
TUIUserInfo
User Information in the Room
Field | Type | Description |
userId | const char* | User ID |
userName | const char* | User Name |
avatarUrl | const char* | User Avatar URL |
userRole | User Role Type | |
hasAudioStream | bool | Whether There is Audio Stream, default value: false |
hasVideoStream | bool | Whether There is Video Stream, default value: false |
hasScreenStream | bool | Whether There is Screen Sharing Stream, default value: false |
TUISeatInfo
Seat Information in the Room
Field | Type | Description |
index | int | Mic Seat Number |
userId | const char* | User ID |
isLocked | bool | Whether the Mic Seat is Locked, default false |
isVideoLocked | bool | Whether the Mic Seat is Prohibited from Opening Camera, default false |
isAudioLocked | bool | Whether the Mic Seat is Prohibited from Opening Microphone, default false |
TUISeatLockParams
Lock Seat Operation Parameters
Field | Type | Description |
lockSeat | bool | Lock Mic Seat, default false |
lockVideo | bool | Lock Mic Seat Camera, default false |
lockAudio | bool | Lock Mic Seat Microphone, default false |
TUIUserVoiceVolume
User Voice Volume in the Room
Field | Type | Description |
userId | const char* | User ID |
volume | int | Volume Size, Value range 0 - 100 |
TUIRequest
Signaling Request
Field | Type | Description |
requestId | uint32_t | Request ID |
requestAction | Request Type | |
userId | const char* | User ID |
content | const char* | Signaling Content |
timestamp | uint32_t | Timestamp |
TUIShareTarget
Screen Sharing Capture Source Information
Field | Type | Description |
id | TUISourceId | Capturing Source ID, for windows, this field represents the window ID; for screens, this field represents the display ID |
sourceType | Capturing Source Type | |
sourceName | const char* | Capturing Source Name |
thumbnailImage | Thumbnail | |
iconImage | Icon | |
isMinimized | bool | Whether to Minimize |
TUINetworkInfo
Network Quality Information
Field | Type | Description |
userId | const char* | User ID |
quality | Network Quality | |
upLoss | int | Upstream Packet Loss Rate |
downLoss | int | Downstream Packet Loss Rate |
delay | int | Network Delay |
TUIMessage
Message
Field | Type | Description |
messageId | const char* | Message ID |
message | const char* | Message Text |
timestamp | int64_t | Message Time |
userId | const char* | Message Sender |
userName | const char* | Message Sender Nickname |
avatarUrl | const char* | Message Sender Avatar |
TUIImageBuffer
Image Info
Field | Type | Description |
buffer | const char* | Image Data Cache Address |
length | uint32_t | Length |
width | uint32_t | Width |
height | uint32_t | Height |