tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Tencent Real-Time Communication
    Documentation
    Download PDF

    iOS

    Last updated: 2024-04-03 17:23:11
    Download PDF
      This article explains how to replace the incoming call ringtone for TUICallKit, which includes application ringtone and offline push ringtone.

      Setting application Ringtone

      There are two ways to set the application ringtone: replace the ringtone audio, and call the Setting ringtone interface.

      1. Replace Audio File

      If you integrate the TUICallKit component via source code dependency, you can achieve the goal of replacing the ringtone by swapping out the three audio files under the Resources\\AudioFile folder:
      File Name
      Use
      phone_dialing.mp3
      Ringtone when initiating a call
      phone_hangup.mp3
      Ringtone when the call is disconnected
      phone_ringing.mp3
      Ringtone when receiving a call

      2. Set Ringtone Interface

      You can also set the incoming call ringtone via the setCallingBell interface.
      Swift
      Objective-C
      TUICallKit.createInstance().setCallingBell(filePath: " ")
      [[TUICallKit createInstance] setCallingBell:@" "];

      3. Setting Mute Mode

      If you do not require a ringtone, you can set the mute mode via enableMuteMode.
      Swift
      Objective-C
      TUICallKit.createInstance().setCallingBell(enable: true)
      [[TUICallKit createInstance] enableMuteMode: YES];

      Setting Offline Push Ringtone

      VoIP push does not support custom push ringtones. APNs push can be set by specifying the iOSSound field in the offlinePushInfo params when making a call via the Call Interface. iOSSound should be passed the audio file name.
      Note:
      Offline push sound settings (only effective for iOS), to customize iOSSound, you first need to link the audio file into the Xcode project, then set the audio file name (with extension) to iOSSound.
      Ringtone duration should be less than 30s.
      Objective-C
      Swift
      
      [[TUICallKit createInstance] call:@"mike's id" params:[self getCallParams] callMediaType:TUICallMediaTypeVideo];
      
      - (TUICallParams *)getCallParams {
          TUIOfflinePushInfo *offlinePushInfo = [self createOfflinePushInfo];
          TUICallParams *callParams = [TUICallParams new];
          callParams.offlinePushInfo = offlinePushInfo;
          callParams.timeout = 30;
          return callParams;
      }
      
      + (TUIOfflinePushInfo *)createOfflinePushInfo {
          TUIOfflinePushInfo *pushInfo = [TUIOfflinePushInfo new];
          pushInfo.title = @"";
          pushInfo.desc = TUICallingLocalize(@"TUICallKit.have.new.invitation");
          pushInfo.iOSPushType = TUICallIOSOfflinePushTypeAPNs;
          pushInfo.ignoreIOSBadge = NO;
          pushInfo.iOSSound = @"phone_ringing.mp3";
          pushInfo.AndroidSound = @"phone_ringing";
          // For OPPO, you must set the `ChannelID` to receive push messages. The `ChannelID` must be identical with that in the console.
          // OPPO must set a ChannelID to receive push messages. This channelID needs to be the same as the console.
          pushInfo.AndroidOPPOChannelID = @"tuikit";
          // FCM channel ID, you need change PrivateConstants.java and set "fcmPushChannelId"
          pushInfo.AndroidFCMChannelID = @"fcm_push_channel";
          // VIVO message type: 0-push message, 1-System message(have a higher delivery rate)
          pushInfo.AndroidVIVOClassification = 1;
          // HuaWei message type: https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/message-classification-0000001149358835
          pushInfo.AndroidHuaWeiCategory = @"IM";
          return pushInfo;
      }
      let params = TUICallParams()
      let pushInfo: TUIOfflinePushInfo = TUIOfflinePushInfo()
      pushInfo.title = "TUICallKit"
      pushInfo.desc = "TUICallKit.have.new.invitation"
      pushInfo.iOSPushType = .apns
      pushInfo.ignoreIOSBadge = false
      pushInfo.iOSSound = "phone_ringing.mp3"
      pushInfo.androidSound = "phone_ringing"
      // For OPPO, you must set the `ChannelID` to receive push messages. The `ChannelID` must be identical with that in the console.
      // OPPO must set a ChannelID to receive push messages. This channelID needs to be the same as the console.
      pushInfo.androidOPPOChannelID = "tuikit"
      // FCM channel ID, you need change PrivateConstants.java and set "fcmPushChannelId"
      pushInfo.androidFCMChannelID = "fcm_push_channel"
      // VIVO message type: 0-push message, 1-System message(have a higher delivery rate)
      pushInfo.androidVIVOClassification = 1
      // HuaWei message type: https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/message-classification-0000001149358835
      pushInfo.androidHuaWeiCategory = "IM"
      params.userData = "User Data"
      params.timeout = 30
      params.offlinePushInfo = pushInfo
      TUICallKit.createInstance().call(userId: "123456", callMediaType: .audio, params: params) {
      
      } fail: {
          code, message in 
      }

      

      Contact Us

      Contact our sales team or business advisors to help your business.

      Contact Us
      Technical Support

      Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

      Submit a Ticket
      7x24 Phone Support
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      Privacy PolicyLegalCookie Policy