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

Monitoring Call Status

This article describes how to use call status callbacks with the TUICallKit component.
Call State Monitoring
If your business requires monitoring call status, such as the start and end of a call, and other events during the call, you can refer to the following code:
Android(Kotlin)
Android(Java)
iOS(Swift)
iOS(Objective-C)
Flutter(Dart)
import com.tencent.qcloud.tuikit.TUICommonDefine
import com.tencent.qcloud.tuikit.tuicallengine.TUICallDefine
import com.tencent.qcloud.tuikit.tuicallengine.TUICallEngine
import com.tencent.qcloud.tuikit.tuicallengine.TUICallObserver
﻿
private val observer: TUICallObserver = object : TUICallObserver() {
    override fun onCallBegin(roomId: TUICommonDefine.RoomId?, callMediaType: TUICallDefine.MediaType?, callRole: TUICallDefine.Role?) {
    }
    override fun onCallEnd(roomId: TUICommonDefine.RoomId?, callMediaType: TUICallDefine.MediaType?, callRole: TUICallDefine.Role?, totalTime: Long) {
    }   
    override fun onUserNetworkQualityChanged(networkQualityList: MutableList<TUICommonDefine.NetworkQualityInfo>?) {    
    }
}
private fun initData() {
    TUICallEngine.createInstance(context).addObserver(observer)
}
import com.tencent.qcloud.tuikit.TUICommonDefine;
import com.tencent.qcloud.tuikit.tuicallengine.TUICallDefine;
import com.tencent.qcloud.tuikit.tuicallengine.TUICallEngine;
import com.tencent.qcloud.tuikit.tuicallengine.TUICallObserver;
﻿
private TUICallObserver observer = new TUICallObserver() {
    @Override
    public void onCallBegin(TUICommonDefine.RoomId roomId, TUICallDefine.MediaType callMediaType, TUICallDefine.Role callRole) {
    }
    @Override
    public void onCallEnd(TUICommonDefine.RoomId roomId, TUICallDefine.MediaType callMediaType,TUICallDefine.Role callRole, long totalTime) {
    }
    @Override
    public void onUserNetworkQualityChanged(List<TUICommonDefine.NetworkQualityInfo> networkQualityList) {
    }
};
﻿
private void initData(){
    TUICallEngine.createInstance(context).addObserver(observer);
}
import TUICallEngine
﻿
TUICallEngine.createInstance().addObserver(self)
﻿
func onCallBegin(roomId: TUIRoomId, callMediaType: TUICallMediaType, callRole: TUICallRole) {
﻿
}
﻿
func onCallEnd(roomId: TUIRoomId, callMediaType: TUICallMediaType, callRole: TUICallRole, totalTime: Float) {
﻿
}
﻿
func onUserNetworkQualityChanged(networkQualityList: [TUINetworkQualityInfo]) {
﻿
}
#import <TUICallEngine/TUICallEngine.h>
﻿
[[TUICallEngine createInstance] addObserver:self];
﻿
- (void)onCallBegin:(TUIRoomId *)roomId callMediaType:(TUICallMediaType)callMediaType callRole:(TUICallRole)callRole {
﻿
}
﻿
- (void)onCallEnd:(TUIRoomId *)roomId callMediaType:(TUICallMediaType)callMediaType callRole:(TUICallRole)callRole totalTime:(float)totalTime {
﻿
}
﻿
- (void)onUserNetworkQualityChanged:(NSArray<TUINetworkQualityInfo *> *)networkQualityList {
﻿
}
import 'package:tencent_calls_engine/tencent_calls_engine.dart';
﻿
TUICallObserver observer = TUICallObserver(
    onError: (int code, String message) {
      
    }, onCallBegin: (TUIRoomId roomId, TUICallMediaType callMediaType, TUICallRole callRole) {
      
    }, onCallEnd: (TUIRoomId roomId, TUICallMediaType callMediaType, TUICallRole callRole, double totalTime) {  
﻿
    }, onUserNetworkQualityChanged: (List<TUINetworkQualityInfo> networkQualityList) {
     
    }, onCallReceived: (String callerId, List<String> calleeIdList, String groupId, TUICallMediaType callMediaType) {
﻿
    }
))
﻿
void addObserver() {
    TUICallEngine.instance.addObserver(observer);
}
Note:
On the Android platform, when setting TUICallObserver to listen for callbacks, ensure that the class hosting the callback will not be cleared. For example, it is not recommended to add the observer in LoginActivity, as when LoginActivity is destroyed, the callback will also be cleared; it is suggested to observe in the application's Application class or the main application interface.

Call State Monitoring