please select
Docs Overview/
Call/
Android/
Basic Features/
Custom Ringtone/

Custom Ringtone

This article introduces how to replace the incoming call ringtone in TUICallKit. The incoming call ringtone includes application ringtone and offline push ringtone.

Setting the application ringtone

There are two methods to set the application ringtone:

1. Replace Audio File

If you integrate the TUICallKit component via source code dependency, you can replace the audio files in the tuicallkit-kt/src/main/res/raw folder to customize the ringtone.
File Name
Use
phone_dialing.mp3
Ringtone when initiating a call
phone_ringing.mp3
Ringtone when receiving a call

2. Call setCallingBell Interface

You can also customize the incoming call ringtone through the setCallingBell interface.
Kotlin
Java
TUICallKit.createInstance(context).setCallingBell(filePath)
TUICallKit.createInstance(context).setCallingBell(filePath);

Set Mute Mode

If you do not need the phone to ring, you can enable the mute mode using the enableMuteMode interface.
Kotlin
Java
TUICallKit.createInstance(context).enableMuteMode(true)
TUICallKit.createInstance(context).enableMuteMode(true);

Setting Offline Push Ringtone

For Offline Push Ringtone Settings, please refer to: FCM Offline Push customizes incoming call ringtone.