- Release Notes and Announcements
- Release Notes
- TRTC Live (TUILiveKit) Product Launch Announcement
- TRTC Conference Official Editions Launched
- The commercial version of Conference is coming soon
- Terms and Conditions Applicable to $9.9 Starter Package
- Rules for the "First Subscription $100 Discount" Promotion
- Announcement on the Start of Beta Testing for Multi-person Audio and Video Conference
- TRTC Call Official Editions Launched
- License Required for Video Playback in New Version of LiteAV SDK
- TRTC to Offer Monthly Packages
- Product Introduction
- Purchase Guide
- Billing Overview
- RTC-Engine Packages
- TRTC Call Monthly Packages
- TRTC Conference Monthly Packages
- TRTC Live Monthly Packages
- Pay-As-You-Go
- Billing Explanation for Subscription Package Duration
- Billing of On-Cloud Recording
- Billing of MixTranscoding and Relay to CDN
- Free Minutes
- FAQs
- Billing of Monitoring Dashboard
- Billing of Recording Delivery
- Overdue and Suspension Policy
- Refund Policies
- User Tutorial
- Free Demo
- Video Calling (Including UI)
- Overview (TUICallKit)
- Activate the Service（TUICallKit）
- Integration (TUICallKit)
- UI Customization (TUICallKit)
- Offline Call Push (TUICallKit)
- On-Cloud Recording (TUICallKit)
- Additional Features（TUICallKit）
- Server APIs (TUICallKit)
- Client APIs (TUICallKit)
- ErrorCode
- Release Notes (TUICallKit)
- FAQs(TUICallKit)
- Multi-Participant Conference (with UI)
- Overview (TUIRoomKit)
- Activate the Service (TUIRoomKit)
- Integration (TUIRoomKit)
- UI Customization (TUIRoomKit)
- Conference Control (TUIRoomKit)
- Cloud Recording (TUIRoomKit)
- API Documentation(TUIRoomKit)
- In-Conference Chat (TUIRoomKit)
- FAQs (TUIRoomKit)
- Error Code (TUIRoomKit)
- Live Streaming (Including UI)
- Voice Chat Room (with UI)
- Integration (No UI)
- SDK Download
- API Examples
- Integration Guide
- Client APIs
- Advanced Features
- Relay to CDN
- Enabling Advanced Permission Control
- RTMP Streaming with TRTC
- Utilizing Beautification Effects
- Testing Hardware Devices
- Testing Network Quality
- On-Cloud Recording
- Custom Capturing and Rendering
- Custom Audio Capturing and Playback
- Sending and Receiving Messages
- Event Callbacks
- Access Management
- How to push stream to TRTC room with OBS WHIP
- Server APIs
- Console Guide
- Solution
- FAQs
- Legacy Documentation
- Protocols and Policies
- TRTC Policy
- Glossary
- Release Notes and Announcements
- Release Notes
- TRTC Live (TUILiveKit) Product Launch Announcement
- TRTC Conference Official Editions Launched
- The commercial version of Conference is coming soon
- Terms and Conditions Applicable to $9.9 Starter Package
- Rules for the "First Subscription $100 Discount" Promotion
- Announcement on the Start of Beta Testing for Multi-person Audio and Video Conference
- TRTC Call Official Editions Launched
- License Required for Video Playback in New Version of LiteAV SDK
- TRTC to Offer Monthly Packages
- Product Introduction
- Purchase Guide
- Billing Overview
- RTC-Engine Packages
- TRTC Call Monthly Packages
- TRTC Conference Monthly Packages
- TRTC Live Monthly Packages
- Pay-As-You-Go
- Billing Explanation for Subscription Package Duration
- Billing of On-Cloud Recording
- Billing of MixTranscoding and Relay to CDN
- Free Minutes
- FAQs
- Billing of Monitoring Dashboard
- Billing of Recording Delivery
- Overdue and Suspension Policy
- Refund Policies
- User Tutorial
- Free Demo
- Video Calling (Including UI)
- Overview (TUICallKit)
- Activate the Service（TUICallKit）
- Integration (TUICallKit)
- UI Customization (TUICallKit)
- Offline Call Push (TUICallKit)
- On-Cloud Recording (TUICallKit)
- Additional Features（TUICallKit）
- Server APIs (TUICallKit)
- Client APIs (TUICallKit)
- ErrorCode
- Release Notes (TUICallKit)
- FAQs(TUICallKit)
- Multi-Participant Conference (with UI)
- Overview (TUIRoomKit)
- Activate the Service (TUIRoomKit)
- Integration (TUIRoomKit)
- UI Customization (TUIRoomKit)
- Conference Control (TUIRoomKit)
- Cloud Recording (TUIRoomKit)
- API Documentation(TUIRoomKit)
- In-Conference Chat (TUIRoomKit)
- FAQs (TUIRoomKit)
- Error Code (TUIRoomKit)
- Live Streaming (Including UI)
- Voice Chat Room (with UI)
- Integration (No UI)
- SDK Download
- API Examples
- Integration Guide
- Client APIs
- Advanced Features
- Relay to CDN
- Enabling Advanced Permission Control
- RTMP Streaming with TRTC
- Utilizing Beautification Effects
- Testing Hardware Devices
- Testing Network Quality
- On-Cloud Recording
- Custom Capturing and Rendering
- Custom Audio Capturing and Playback
- Sending and Receiving Messages
- Event Callbacks
- Access Management
- How to push stream to TRTC room with OBS WHIP
- Server APIs
- Console Guide
- Solution
- FAQs
- Legacy Documentation
- Protocols and Policies
- TRTC Policy
- Glossary
Common structures
TUICallDefine
Type | Description |
An additional parameter. | |
Offline push vendor configuration information. |
TUICommonDefine
Type | Description |
Room ID for audio and video in a call. | |
Network quality information | |
Video render parameters | |
Video encoding parameters |
Enum definition
TUICallDefine
Type | Description |
Media type in a call | |
Roles of individuals in a call. | |
The call status | |
The call scene | |
iOS offline push type |
TUICommonDefine
Type | Description |
Audio route | |
Camera type | |
Network quality | |
Video image fill mode | |
Video image rotation direction | |
Video aspect ratio mode | |
Video resolution |
CallParams
Call params
Value | Type | Description |
offlinePushInfo | Offline push vendor configuration information. | |
timeout | int | Call timeout period, default: 30s, unit: seconds. |
userData | String |
OfflinePushInfo
Value | Type | Description |
title | String | offlinepush notification title |
desc | String | offlinepush notification description |
ignoreIOSBadge | boolean | Ignore badge count for offline push (only for iOS), if set to true, the message will not increase the unread count of the app icon on the iOS receiver's side. |
iOSSound | String | Offline push sound setting (only for iOS). When sound = IOS_OFFLINE_PUSH_NO_SOUND, there will be no sound played when the message is received. When sound = IOS_OFFLINE_PUSH_DEFAULT_SOUND, the system sound will be played when the message is received. If you want to customize the iOSSound, you need to link the audio file into the Xcode project first, and then set the audio file name (with extension) to the iOSSound. |
androidSound | String | Offline push sound setting (only for Android, supported by IMSDK 6.1 and above). Only Huawei and Google phones support setting sound prompts. For Xiaomi phones, please refer to: Xiaomi custom ringtones. In addition, for Google phones, in order to set sound prompts for FCM push on Android 8.0 and above systems, you must call setAndroidFCMChannelIDto set the channelID for it to take effect. |
androidOPPOChannelID | String | Set the channel ID for OPPO phones with Android 8.0 and above systems. |
androidVIVOClassification | int | Classification of VIVO push messages (deprecated interface, VIVO push service will optimize message classification rules on April 3, 2023. It is recommended to use setAndroidVIVOCategory to set the message category). 0: Operational messages, 1: System messages. The default value is 1. |
androidXiaoMiChannelID | String | Set the channel ID for Xiaomi phones with Android 8.0 and above systems. |
androidFCMChannelID | String | Set the channel ID for google phones with Android 8.0 and above systems. |
androidHuaWeiCategory | String | |
isDisablePush | boolean | Whether to turn off push notifications (default is on). |
iOSPushType | iOS offline push type，default is APNs |
RoomId
Room ID for audio and video in a call.
Note：
(1)
intRoomId and strRoomId are mutually exclusive. If you choose to use strRoomId, intRoomId needs to be filled in as 0. If both are filled in, the SDK will prioritize intRoomId.(2) Do not mix
intRoomId and strRoomId because they are not interchangeable. For example, the number 123 and the string "123" represent two completely different rooms.Value | Type | Description |
intRoomId | int | Numeric room ID. range：1 - 2147483647(2^31-1) |
strRoomId | String | String room ID.
range： Limited to 64 bytes in length. The supported character set range is as follows (a total of 89 characters): Lowercase and uppercase English letters.（a-zA-Z）； Number（0-9）； Spaces、!、#、$、%、&、(、)、+、-、:、;、<、=、.、>、?、@、[、]、^、_、{、}、|、~、,。 |
Note：
Currently, string room number is only supported on Android and iOS platforms. Support for other platforms such as Web, Mini Programs, Flutter, and Uniapp will be available in the future. Please stay tuned!
NetworkQualityInfo
User network quality information
Value | Type | Description |
userId | String | user ID |
quality | network quality |
VideoRenderParams
Video render parameters
Value | Type | Description |
fillMode | Video image fill mode | |
rotation | Video image rotation direction |
VideoEncoderParams
Video encoding parameters
Value | Type | Description |
resolution | Video resolution | |
resolutionMode | Video aspect ratio mode |
MediaType
Call media type
Value | Type | Description |
Unknown | 0 | Unknown |
Audio | 1 | Audio call |
Video | 2 | Video call |
Role
Call role
Value | Type | Description |
None | 0 | Unknown |
Caller | 1 | Caller（inviter） |
Called | 2 | Callee（invitee） |
Status
Call status
Value | Type | Description |
None | 0 | Unknown |
Waiting | 1 | The call is currently waiting |
Accept | 2 | The call has been accepted |
Scene
Call scene
Value | Type | Description |
GROUP_CALL | 0 | Group call |
MULTI_CALL | 1 | Anonymous group calling (not supported at this moment, please stay tuned). |
SINGLE_CALL | 2 | one to one call |
IOSOfflinePushType
iOS offline push type
Type | Value | Description |
APNs | 0 | APNs |
VoIP | 1 | VoIP |
AudioPlaybackDevice
Audio route
Type | Value | Description |
Earpiece | 0 | Earpiece |
Speakerphone | 1 | Speakerphone |
Camera
Front/Back camera
Type | Value | Description |
Front | 0 | Front camera |
Back | 1 | Back camera |
NetworkQuality
Network quality
Type | Value | Description |
Unknown | 0 | Unknown |
Excellent | 1 | Excellent |
Good | 2 | Good |
Poor | 3 | Poor |
Bad | 4 | Bad |
Vbad | 5 | Vbad |
Down | 6 | Down |
FillMode
If the aspect ratio of the video display area is not equal to that of the video image, you need to specify the fill mode:
Type | Value | Description |
Fill | 0 | Fill mode: the video image will be centered and scaled to fill the entire display area, where parts that exceed the area will be cropped. The displayed image may be incomplete in this mode. |
Fit | 1 | Fit mode: the video image will be scaled based on its long side to fit the display area, where the short side will be filled with black bars. The displayed image is complete in this mode, but there may be black bars. |
Rotation
We provides rotation angle setting APIs for local and remote images. The following rotation angles are all clockwise.
Type | Value | Description |
Rotation_0 | 0 | No rotation |
Rotation_90 | 1 | Clockwise rotation by 90 degrees |
Rotation_180 | 2 | Clockwise rotation by 180 degrees |
Rotation_270 | 3 | Clockwise rotation by 0 degrees |
ResolutionMode
Video aspect ratio mode
Type | Value | Description |
Landscape | 0 | Landscape resolution, such as Resolution.Resolution_640_360 + ResolutionMode.Landscape = 640 × 360. |
Portrait | 1 | Portrait resolution, such as Resolution.Resolution_640_360 + ResolutionMode.Portrait = 360 × 640. |
Resolution
Video resolution
Type | Value | Description |
Resolution_640_360 | 108 | Aspect ratio: 16:9；resolution: 640x360；recommended bitrate: 500kbps |
Resolution_640_480 | 62 | Aspect ratio: 4:3；resolution: 640x480；recommended bitrate: 600kbps |
Resolution_960_540 | 110 | Aspect ratio: 16:9；resolution: 960x540；recommended bitrate: 850kbps |
Resolution_960_720 | 64 | Aspect ratio: 4:3；resolution: 960x720；recommended bitrate: 1000kbps |
Resolution_1280_720 | 112 | Aspect ratio: 16:9；resolution: 1280x720；recommended bitrate: 1200kbps |
Resolution_1920_1080 | 114 | Aspect ratio: 16:9；resolution: 1920x1080；recommended bitrate: 2000kbps |
Yes
No
Was this page helpful?