Recording

Use CometChat Calls SDK v5 recording on Flutter to start, stop, access, and manage recordings for supported call sessions.

Record call sessions for later playback. Recordings are stored server-side and can be accessed through call logs or the CometChat Dashboard.

Recording is enabled by default on all CometChat apps. Start it automatically with enableAutoStartRecording(true), or let users start it from the recording button. Recordings are available in the Dashboard under Calls → Call Logs, through Call Logs, and via the Call Logs API.

Start Recording

Start recording during an active call session:

await CallSession.getInstance()?.startRecording();

All participants are notified when recording starts.

Stop Recording

Stop an active recording:

await CallSession.getInstance()?.stopRecording();

Auto-Start Recording

Configure calls to automatically start recording when the session begins:

SessionSettings sessionSettings = SessionSettingsBuilder()
    .enableAutoStartRecording(true)
    .build();

A recording runs until it is stopped. Whether it was started manually or automatically through enableAutoStartRecording, it keeps running until someone stops it. If nobody does, it stops on its own when either:

• Everyone leaves the session — the recording ends about a minute later.
• Everyone in the session stays muted for 10 minutes.

Hide Recording Button

Hide the recording button from the default call UI:

SessionSettings sessionSettings = SessionSettingsBuilder()
    .hideRecordingButton(true)
    .build();

Listen for Recording Events

Monitor recording state changes using MediaEventListeners:

class _MediaEventListener extends MediaEventListeners {
  @override
  void onRecordingStarted() {
    debugPrint("Recording started");
    showRecordingIndicator();
  }

  @override
  void onRecordingStopped() {
    debugPrint("Recording stopped");
    hideRecordingIndicator();
  }
  // every other callback already defaults to a no-op on the abstract class —
  // override only what you need (onAudioMuted, onAudioUnMuted, onVideoPaused, onVideoResumed, …).
}

CallSession? callSession = CallSession.getInstance();

callSession?.addMediaEventsListener(_MediaEventListener());

Track Participant Recording

Monitor when other participants start or stop recording using ParticipantEventListeners:

class _ParticipantEventListener extends ParticipantEventListeners {
  @override
  void onParticipantStartedRecording(Participant participant) {
    debugPrint("${participant.name} started recording");
  }

  @override
  void onParticipantStoppedRecording(Participant participant) {
    debugPrint("${participant.name} stopped recording");
  }
}

CallSession? callSession = CallSession.getInstance();

callSession?.addParticipantEventListener(_ParticipantEventListener());

Access Recordings

Recordings are available after the call ends. You can access them in two ways:

1. CometChat Dashboard: Navigate to Calls > Call Logs in your CometChat Dashboard to view and download recordings.

2. Programmatically: Fetch recordings through Call Logs:

CallLogRequest callLogRequest =
    (CallLogRequestBuilder()..hasRecording = true).build();

callLogRequest.fetchNext(
  onSuccess: (List<CallLog> callLogs) {
    for (CallLog callLog in callLogs) {
      callLog.recordings?.forEach((recording) {
        debugPrint("Recording URL: ${recording.recordingUrl}");
        debugPrint("Duration: ${recording.duration} seconds");
        debugPrint("Start Time: ${recording.startTime}");
        debugPrint("End Time: ${recording.endTime}");
      });
    }
  },
  onError: (CometChatCallsException e) {
    debugPrint("Error: ${e.message}");
  },
);

Recording Object

Property	Type	Description
rid	String	Unique recording identifier
recordingUrl	String	URL to download/stream the recording
startTime	int	Timestamp when recording started
endTime	int	Timestamp when recording ended
duration	double	Recording duration in seconds