ringing-integration

name	ringing-integration
description	Implement ringing with dual SDK (Chat + Calls). Use when adding incoming/outgoing call screens, CometChat.initiateCall, accept/reject/cancel calls, or integrating Chat SDK signaling with Calls SDK sessions. Triggers on "ringing", "incoming call", "outgoing call", "initiateCall", "acceptCall", "rejectCall".
inclusion	manual

CometChat Calls SDK v5 — Ringing Integration (React Native)

Overview

Implement call ringing using both CometChat Chat SDK (signaling) and Calls SDK (session). The Chat SDK handles initiating, accepting, rejecting, and cancelling calls. The Calls SDK manages the actual call session after acceptance.

Key Imports

// Chat SDK — signaling
import { CometChat } from '@cometchat/chat-sdk-react-native';

// Calls SDK — session
import { CometChatCalls } from '@cometchat/calls-sdk-react-native';

Implementation

1. Initiate a Call (Caller Side)

const call = new CometChat.Call(
  receiverUID,
  CometChat.RECEIVER_TYPE.USER,
  CometChat.CALL_TYPE.VIDEO
);

const outgoingCall = await CometChat.initiateCall(call);
// Show outgoing call UI with outgoingCall.getSessionId()

2. Listen for Incoming Calls

const listenerID = 'CALL_LISTENER';

CometChat.addCallListener(listenerID, new CometChat.CallListener({
  onIncomingCallReceived: (call) => {
    // Show incoming call UI
    // call.getSessionId(), call.getSender().getName(), call.getType()
  },
  onOutgoingCallAccepted: (call) => {
    // Navigate to call screen
    navigateToCall(call.getSessionId(), call.getType());
  },
  onOutgoingCallRejected: (call) => {
    // Dismiss outgoing call UI
  },
  onIncomingCallCancelled: (call) => {
    // Dismiss incoming call UI
  },
}));

// Remove in cleanup
CometChat.removeCallListener(listenerID);

3. Accept a Call (Receiver Side)

const acceptedCall = await CometChat.acceptCall(sessionId);
navigateToCall(acceptedCall.getSessionId(), acceptedCall.getType());

4. Reject a Call

await CometChat.rejectCall(sessionId, CometChat.CALL_STATUS.REJECTED);

5. Cancel an Outgoing Call

await CometChat.rejectCall(sessionId, CometChat.CALL_STATUS.CANCELLED);

6. Call Screen Component

import React, { useEffect, useState } from 'react';
import { View, StyleSheet } from 'react-native';
import { CometChatCalls } from '@cometchat/calls-sdk-react-native';

function CallScreen({ sessionId, callType, onEnd }: {
  sessionId: string;
  callType: string;
  onEnd: () => void;
}) {
  const [callToken, setCallToken] = useState<string | null>(null);
  const isVoice = callType === CometChat.CALL_TYPE.AUDIO;

  useEffect(() => {
    CometChatCalls.generateToken(sessionId).then(({ token }) => {
      setCallToken(token);
    });
  }, [sessionId]);

  useEffect(() => {
    const unsub = CometChatCalls.addEventListener('onConnectionClosed', onEnd);
    return () => unsub();
  }, []);

  if (!callToken) return null;

  return (
    <View style={styles.container}>
      <CometChatCalls.Component
        callToken={callToken}
        sessionSettings={{
          sessionType: isVoice ? 'VOICE' : 'VIDEO',
          layout: isVoice ? 'SPOTLIGHT' : 'TILE',
          startVideoPaused: isVoice,
        }}
      />
    </View>
  );
}

const styles = StyleSheet.create({
  container: { flex: 1 },
});

7. Handle Leave Button

CometChatCalls.addEventListener('onLeaveSessionButtonClicked', () => {
  CometChatCalls.leaveSession();
});

Gotchas

• Cancel uses CometChat.rejectCall() with CometChat.CALL_STATUS.CANCELLED status
• Call type constants: CometChat.CALL_TYPE.VIDEO and CometChat.CALL_TYPE.AUDIO
• Remove call listeners on component unmount to prevent memory leaks
• Initialize and login to both SDKs before using ringing
• The Chat SDK handles signaling (ring/accept/reject); the Calls SDK handles the actual media session
• generateToken() requires the Calls SDK user to be logged in
• On React Native, consider using a push notification service (e.g., Firebase, APNs) for background call notifications