- Release Notes and Announcements
- Release Notes
- 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
- 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)
- 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 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
- 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)
- 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
TUICallEngine APIs
TUICallEngine is an audio/video call component that does not include UI elements. If TUICallKit does not meet your requirements, you can use the APIs of TUICallEngine to customize your project.Overview
API | Description |
Creates a TUICallEngine instance (singleton mode). | |
Terminates a TUICallEngine instance (singleton mode). | |
Authenticates the basic audio/video call capabilities. | |
Registers an event listener. | |
Unregisters an event listener. | |
Makes a one-to-one call. | |
Makes a group call. | |
Accepts a call. | |
Rejects a call. | |
Ends a call. | |
Ignores a call. | |
Invites users to the current group call. | |
Joins a group call. | |
Changes the call type, for example, from video call to audio call. | |
Subscribes to the video stream of a remote user. | |
Unsubscribes from the video stream of a remote user. | |
Turns the camera on. | |
Turns the camera off. | |
Switches between the front and rear cameras. | |
Turns the mic on. | |
Turns the mic off. | |
Selects the audio playback device (receiver or speaker). | |
Sets the alias and profile photo. | |
Sets whether to enable multi-device login for TUICallEngine (supported by the premium package). | |
Set the rendering mode of video image. | |
Set the encoding parameters of video encoder. | |
Advanced features. | |
Set beauty level, support turning off default beauty. |
Details
createInstance
This API is used to create a
TUICallEngine singleton.TUICallEngine createInstance(Context context)
destroyInstance
This API is used to terminate a
TUICallEngine singleton.void destroyInstance();
Init
This API is used to initialize
TUICallEngine. Call it to authenticate the call service and perform other required actions before you call other APIs.void init(int sdkAppId, String userId, String userSig, TUICommonDefine.Callback callback)
The parameters are described below:
Parameter | Type | Description |
sdkAppId | int | |
userId | String | The ID of the current user, which is a string that can contain only letters (a-z and A-Z), digits (0-9), hyphens (-), and underscores (_). |
userSig | String | |
callback | TUICommonDefine.Callback | The initialization callback. onSuccess indicates initialization is successful. |
addObserver
This API is used to register an event listener to listen for
TUICallObserver events.void addObserver(TUICallObserver observer);
removeObserver
This API is used to unregister an event listener.
void removeObserver(TUICallObserver observer);
call
This API is used to make a (one-to-one) call.
void call(String userId, TUICallDefine.MediaType callMediaType,TUICallDefine.CallParams params, TUICommonDefine.Callback callback);
The parameters are described below:
Parameter | Type | Description |
userId | String | The target user ID. |
callMediaType | The call type, which can be video or audio. | |
params | An additional parameter, such as roomID, call timeout, offline push info,etc |
groupCall
This API is used to make a group call.
Notice：
Before making a group call, you need to create an IM group first.
void groupCall(String groupId, List<String> userIdList, TUICallDefine.MediaType callMediaType,TUICallDefine.CallParams params, TUICommonDefine.Callback callback);
The parameters are described below:
Parameter | Type | Description |
groupId | String | The group ID. |
userIdList | List | The target user IDs. |
callMediaType | The call type, which can be video or audio. | |
params | An additional parameter. such as roomID, call timeout, offline push info,etc |
accept
This API is used to accept a call. After receiving the
onCallReceived() callback, you can call this API to accept the call.void accept(TUICommonDefine.Callback callback);
reject
This API is used to reject a call. After receiving the
onCallReceived() callback, you can call this API to reject the call.void reject(TUICommonDefine.Callback callback);
ignore
This API is used to ignore a call. After receiving the
onCallReceived(), you can call this API to ignore the call. The caller will receive the onUserLineBusy callback.Note: If your project involves live streaming or conferencing, you can also use this API to implement the “in a meeting” or “on air” feature.
void ignore(TUICommonDefine.Callback callback);
hangup
This API is used to end a call.
void hangup(TUICommonDefine.Callback callback);
inviteUser
This API is used to invite users to the current group call.
This API is called by a participant of a group call to invite new users.
void inviteUser(List<String> userIdList, TUICallDefine.CallParams params,TUICommonDefine.ValueCallback callback);
The parameters are described below:
Parameter | Type | Description |
userIdList | List | The target user IDs. |
params | An additional parameter. such as roomID, call timeout, offline push info,etc |
joinInGroupCall
This API is used to join a group call.
This API is called by a group member to join the group’s call.
void joinInGroupCall(TUICommonDefine.RoomId roomId, String groupId,TUICallDefine.MediaType callMediaType, TUICommonDefine.Callback callback);
The parameters are described below:
Parameter | Type | Description |
roomId | The room ID. | |
groupId | String | The group ID. |
callMediaType | The call type, which can be video or audio. |
switchCallMediaType
This API is used to change the call type.
void switchCallMediaType(TUICallDefine.MediaType callMediaType);
The parameters are described below:
Parameter | Type | Description |
callMediaType | The call type, which can be video or audio. |
startRemoteView
This API is used to subscribe to the video stream of a remote user. For it to work, make sure you call it after
setRenderView.void startRemoteView(String userId, TUIVideoView videoView, TUICommonDefine.PlayCallback callback);
The parameters are described below:
Parameter | Type | Description |
userId | String | The target user ID. |
videoView | TUIVideoView | The view to be rendered. |
stopRemoteView
This API is used to unsubscribe from the video stream of a remote user.
void stopRemoteView(String userId);
The parameters are described below:
Parameter | Type | Description |
userId | String | The target user ID. |
openCamera
This API is used to turn the camera on.
void openCamera(TUICommonDefine.Camera camera, TUIVideoView videoView, TUICommonDefine.Callback callback);
The parameters are described below:
Parameter | Type | Description |
camera | The front or rear camera. | |
videoView | TUIVideoView | The view to be rendered. |
closeCamera
This API is used to turn the camera off.
void closeCamera();
switchCamera
This API is used to switch between the front and rear cameras.
void switchCamera(TUICommonDefine.Camera camera);
The parameters are described below:
Parameter | Type | Description |
camera | The front or rear camera. |
openMicrophone
This API is used to turn the mic on.
void openMicrophone(TUICommonDefine.Callback callback);
closeMicrophone
This API is used to turn the mic off.
void closeMicrophone();
selectAudioPlaybackDevice
This API is used to select the audio playback device (receiver or speaker). In call scenarios, you can use this API to turn on/off hands-free mode.
void selectAudioPlaybackDevice(TUICommonDefine.AudioPlaybackDevice device);
The parameters are described below:
Parameter | Type | Description |
device | The speaker or receiver. |
setSelfInfo
This API is used to set the alias and profile photo. The alias cannot exceed 500 bytes, and the profile photo is specified by a URL.
void setSelfInfo(String nickname, String avatar, TUICommonDefine.Callback callback);
The parameters are described below:
Parameter | Type | Description |
nickname | String | The alias. |
avatar | String | The URL of the profile photo. |
enableMultiDeviceAbility
This API is used to set whether to enable multi-device login for
TUICallEngine (supported by the premium package).void enableMultiDeviceAbility(boolean enable, TUICommonDefine.Callback callback);
setVideoRenderParams
Set the rendering mode of video image.
void setVideoRenderParams(String userId, TUICommonDefine.VideoRenderParams params, TUICommonDefine.Callback callback);
The parameters are described below:
Parameter | Type | Description |
userId | String | The target user ID. |
params | Video render parameters. |
setVideoEncoderParams
Set the encoding parameters of video encoder.
This setting can determine the quality of image viewed by remote users, which is also the image quality of on-cloud recording files.
void setVideoEncoderParams(TUICommonDefine.VideoEncoderParams params, TUICommonDefine.Callback callback);
The parameters are described below:
Parameter | Type | Description |
params | Video encoding parameters |
getTRTCCloudInstance
Advanced features.
TRTCCloud getTRTCCloudInstance();
setBeautyLevel
Set beauty level, support turning off default beauty.
void setBeautyLevel(float level, TUICommonDefine.Callback callback);
The parameters are described below:
Parameter | Type | Description |
level | float | Beauty level，range: 0 - 9； 0 means turning off the effect, 9 means the most obvious effect. |
Yes
No
Was this page helpful?