please select
Call
  • Web
    • Overview
      • Product Introduction
      • Activate the Service
      • Pricing
        • Free Minutes
        • Call Monthly Packages
        • Billing Explanation for Subscription Package Duration
    • Get Started
      • Run Sample Code
      • Integration (React)
      • Integration (Vue3)
      • Secure authentication with userSig
    • Basic Features
      • UI Customization
      • Configuring Nickname and Avatar
      • GroupCall
      • Floating Window
      • Custom Ringtone
      • Configure Resolution and Fill Mode
      • Monitoring Call Status
      • Language Settings
    • Advanced Features
      • Virtual Background
      • AI Noise Suppression
      • On-Cloud Recording
    • Client APIs
      • UIKit APIs
        • API Overview
        • TUICallKit
      • Engine APIs
        • TUICallEngine
        • TUICallEvent
    • Server APIs
      • Call Status Callback
        • Call Status Callback
        • Call Event Callback
        • Callback Configuration
          • API List for Callback Configuration
          • Establishing Callback Configuration
          • Retrieving Callback Configuration
          • Update Callback Configuration
          • Remove Callback Configuration
      • REST API
        • Introduction to REST API
        • Retrieve records via callId
        • Retrieve Records Based on Conditions
    • FAQs
      • All Platfroms
      • Web
      • ErrorCode
      • Release Notes
  • Android
    • Overview
      • Product Introduction
      • Activate the Service
      • Pricing
        • Free Minutes
        • Call Monthly Packages
        • Billing Explanation for Subscription Package Duration
    • Get Started
      • Run Sample Code
      • Integration
      • Secure authentication with userSig
    • Basic Features
      • UI Customization
      • Offline Call Push
      • Configuring Nicknames and Avatars
      • Group Call
      • Floating Window
      • Custom Ringtone
      • Monitoring Call Status
    • Advanced Features
      • Virtual Background
      • AI Noise Suppression
      • On-Cloud Recording
    • Client APIs
      • UIKit APIs
        • API Overview
        • TUICallKit
        • TUICallObserver
        • Type Definition
      • Engine APIs
        • TUICallEngine
    • Server APIs
      • Call Status Callback
        • Call Status Callback
        • Call Event Callback
        • Callback Configuration
          • API List for Callback Configuration
          • Establishing Callback Configuration
          • Retrieving Callback Configuration
          • Update Callback Configuration
          • Remove Callback Configuration
      • REST API
        • Introduction to REST API
        • Retrieve records via callId
        • Retrieve Records Based on Conditions
    • FAQs
      • All Platforms
      • Android
      • ErrorCode
      • Release Notes
  • iOS
    • Overview
      • Product Introduction
      • Activate the Service
      • Pricing
        • Free Minutes
        • Call Monthly Packages
        • Billing Explanation for Subscription Package Duration
    • Get Started
      • Run Sample Code
      • Integration
      • Secure authentication with userSig
    • Basic Features
      • UI Customization
      • Offline Call Push
        • VoIP
        • APNs
      • Configuring Nicknames and Avatars
      • Group Call
      • Floating Window
      • Custom Ringtone
      • Monitoring Call Status
    • Advanced Features
      • Virtual Background
      • AI Noise Suppression
      • On-Cloud Recording
    • Client APIs
      • UIKit APIs
        • API Overview
        • TUICallKit
        • TUICallObserver
        • Type Definition
      • Engine APIs
        • TUICallEngine
    • Server APIs
      • Call Status Callback
        • Call Status Callback
        • Call Event Callback
        • Callback Configuration
          • API List for Callback Configuration
          • Establishing Callback Configuration
          • Retrieving Callback Configuration
          • Update Callback Configuration
          • Remove Callback Configuration
      • REST API
        • Introduction to REST API
        • Retrieve records via callId
        • Retrieve Records Based on Conditions
    • FQAs
      • All Platform
      • iOS
      • ErrorCode
      • Release Notes
  • Flutter
    • Overview
      • Product Introduction
      • Activate the Service
      • Pricing
        • Free Minutes
        • Call Monthly Packages
        • Billing Explanation for Subscription Package Duration
    • Get Started
      • Run Sample Code
      • Integration
      • Secure authentication with userSig
    • Basic Features
      • UI Customization
      • offline Call Push
        • Notification
        • VoIP (Optional)
      • Configuring Nicknames and Avatars
      • Group Call
      • Floating Window
      • Custom Ringtone
      • Monitoring Call Status
    • Advanced Features
      • Virtual Background
      • AI Noise Suppression
      • On-Cloud Recording
      • Beauty Effects
    • Client APIs
      • API Overview
      • TUICallKit
      • TUICallEngine
      • TUICallObserver
      • Type Definition
    • Server APIs
      • Call Status Callback
        • Call Status Callback
        • Call Event Callback
        • Callback Configuration
          • API List for Callback Configuration
          • Establishing Callback Configuration
          • Retrieving Callback Configuration
          • Update Callback Configuration
          • Remove Callback Configuration
      • REST API
        • Introduction to REST API
        • Retrieve records via callId
        • Retrieve Records Based on Conditions
    • FQAs
      • All Platform
      • Flutter
      • ErrorCode
      • Upgrading
      • Release Notes
Call
Docs Overview/
Call/
Flutter/
FQAs/
Upgrading/

Upgrading

Upgrade Instructions

TUICallKit is a new audio and video calling UI component launched by Tencent Cloud. It is an upgraded version of TUICalling, which supports more functional features such as group calling and AI noise reduction, and supports calling between all platforms with greater stability. We welcome you to use the new TUICallKit component. Before upgrading, please note the following:
TUICalling and TUICallKit support mutual calling. Please keep the SDKAppID unchanged before and after the upgrade, otherwise it will affect mutual communication.
TUICallKit needs to be used with the IM audio and video calling capability package. You can click on the IM console, enter the Basic Configuration page of the corresponding SDKAppID application, and find the Call function area in the lower right corner of the page. Click Try now to open TUICallKit's 7-day free trial service. If you need to officially launch the application, click Purchase to enter the purchase page.



Note：
The IM audio and video calling capability provides differentiated paid versions for different business needs, and you can learn about the included features and purchase the version that suits you on the IM purchase page.

Upgrade Steps

TUICallKit was designed to accommodate the upgrade needs of TUICalling customers, and can be upgraded in just two simple steps, which is expected to take 20 minutes:

Upgrade the dependency to TUICallKit

Complete the dependency upgrade to TUICallKit in your project and set the configuration file pubspec.yaml for your project:
dependencies:
  # Remove the old dependency tim_ui_kit_calling_plugin and add the new dependency tencent_calls_uikit:
  tencent_calls_uikit:
After setting up, execute the command flutter pub get.
Note：
If you previously used it with IM components such as TUIChat and TUIContact, you can use TUICallKit normally after completing this step. The compatibility logic has been handled internally in the TUICallKit component.

2、Modify API usage

After completing the above steps, your project will not compile normally. You need to replace the TUICalling API with the new TUICallKit API. You can refer to the following API comparison information and search and replace it.
API meaning
TUICalling(tim_ui_kit_calling_plugin)
TUICallKit(tencent_calls_uikit)
Explanation
Create a TUICallKit instance
TUICalling.sharedInstance
TUICallKit.instance
Replace reference and name.
Set the user's nickname
TUICalling.setUserNickname
TUICallKit.setSelfInfo
Integrate the interface for setting avatar and nickname into the setSelfInfo interface.
Set the user's avatar
TUICalling.setUserAvatar
TUICallKit.setSelfInfo
Integrate the interface for setting avatar and nickname into the setSelfInfo interface.
Initiate a 1v1 call
TUICalling.call
TUICallKit.call
See TUICalling.call interface changes for details.
Initiate a group call
/
TUICallKit.groupCall
/
Actively join the current group call
/
TUICallKit.joinInGroupCall
/
Set custom ringtone
TUICalling.setCallingBell
TUICallKit.setCallingBell
Replace reference and name.
Enable/disable mute mode
TUICalling.enableMuteMode
TUICallKit.enableMuteMode
Replace reference and name.
Enable/disable floating window function
TUICalling.enableFloatWindow
TUICallKit.enableFloatWindow
Replace reference and name.
Set listener
TUICalling.registerListener
TUICallEngine.addObserver
See TUICalling.registerListener interface changes for details.
Here are the adaptation solutions for the two APIs with significant changes during this upgrade:

TUICalling.call Interface Changes

TUICalling Code Example:
// Original Interface
Future<void> call(String userId, CallingScenes type, [OfflinePushInfo? offlinePushInfo]);
TUICallKit Code Example:
// New Interface
Future<void> call(String userId, TUICallMediaType callMediaType, [TUICallParams? params]);

// New Calling Method
TUIOfflinePushInfo offlinePushInfo = TUIOfflinePushInfo();
offlinePushInfo.title = "Flutter TUICallKit";
offlinePushInfo.desc = "This is an incoming call from Flutter TUICallkit";
TUICallParams params = TUICallParams(offlinePushInfo: offlinePushInfo);
TUICallKit.instance.call(callUserId, TUICallMediaType.audio, params);

TUICallKit.setCallingListener Interface Changes

TUICalling Code Example:
TUICalling.sharedInstance().registerListener(TUICallingListener(
    onInvited: (params) {
    }
    onCallingCancel: () {
    }
    ……
));
TUICallKit Code Example:
TUICallEngine.instance.addObserver(TUICallObserver(
    onError:(int code, String message) {
    }, 
    onCallCancelled: (String callerId) {
    },
    onCallBegin:(TUIRoomId roomId, TUICallMediaType callMediaType, TUICallRole callRole) {
    },
    ……
));
After upgrading the above APIs, you can use the TUICallKit component normally.