Last updated: 2023-09-19 14:45:50Download PDF
This document describes how to customize the UI of
TUICallKitand provides two schemes for customization: slight UI adjustment and custom UI implementation.
Scheme 1. Slight UI Adjustment
You can adjust the UI of
TUICallKitby directly modifying the UI source code in the
iOS/TUICallKitfolder in tencentyun/TUICallKit.
Replacing icons: You can directly replace the icons in the
Resources\Calling.xcassetsfolder to customize the color tone and style of all the icons in your application. When you replace an icon, make sure the filename is the same as the original icon.
Replacing ringtones: You can replace ringtones by replacing the three audio files in the
The sound of making a call.
The sound of being hung up.
The ringtone for incoming calls.
Replacing text: You can modify the strings on the video call UI by modifying the
Scheme 2. Custom UI Implementation
The entire call feature of
TUICallKitis implemented based on the UI-less component
TUICallEngine. You can delete the
tuicallkitfolder and implement your own UIs based entirely on
TUICallEngineis the underlying API of the entire
TUICallKitcomponent. It provides key APIs such as APIs for making, answering, declining, and hanging up one-to-one audio/video and group calls and device operations.
Completes the authentication of basic audio/video call capabilities.
Registers an event listener.
Unregisters an event listener.
Makes a one-to-one call.
Makes a group call.
Answers a call.
Declines a call.
Hangs up a call.
Ignores a call.
Invites a user during a group call.
Joins the current group call actively.
Switches the call media type, such as from video call to audio call.
Subscribes to the video stream of a remote user.
Unsubscribes from the video stream of a remote user.
Enables the camera.
Disables the camera.
Switches between the front and rear cameras.
Enables the mic.
Disables the mic.
Selects the audio playback device (receiver/speaker).
Sets the user nickname and profile photo.
Enables/Disables the multi-device login mode of
TUICallObserveris the callback even class of
TUICallEngine. You can use it to listen on the desired callback events.
An error occurred during the call.
A call was received.
The call was canceled.
The call was connected.
The call ended.
The call media type changed.
A user declined the call.
A user didn't respond.
A user was busy.
A user joined the call.
A user left the call.
Whether a user had a video stream.
Whether a user had an audio stream.
The volume levels of all users.
The network quality of all users.
Definitions of key classes
The call media type. Enumeration: Video call and audio call.
The call role. Enumeration: Caller and callee.
The call status. Enumeration: Idle, waiting, and answering.
The audio/video room ID, which can be a number or string.
The camera type. Enumeration: Front camera and rear camera.
The audio playback device type. Enumeration: Speaker and receiver.
The information of the current network quality.