Call Events

There are multiple events that you can listen to during a call. You can use them to update the UI, show notifications, or log the call events. You can listen to them via callEvents stream in the Call object.

Here are some of the events you can listen to:

Call Event	Description
General Call Events
`StreamCallCreatedEvent`	Triggered when a call is created.
`StreamCallJoinedEvent`	Triggered when a user joins a call.
`StreamCallEndedEvent`	Triggered when the call ends.
`StreamCallUpdatedEvent`	Triggered when the call metadata are updated.
Participant Events
`StreamCallParticipantJoinedEvent`	Triggered when a participant joins the call.
`StreamCallParticipantLeftEvent`	Triggered when a participant leaves the call.
`StreamCallDominantSpeakerChangedEvent`	Triggered when the dominant speaker changes.
Quality and Control Events
`StreamCallConnectionQualityChangedEvent`	Triggered when connection quality changes for participants.
`StreamCallAudioLevelChangedEvent`	Triggered when audio levels change for participants.
`StreamCallPermissionRequestEvent`	Triggered when there is a permission request for a call.
`StreamCallPermissionsUpdatedEvent`	Triggered when permissions for a call are updated.
Call Ringing Events
`StreamCallRingingEvent`	Triggered when the call is ringing.
`StreamCallAcceptedEvent`	Triggered when the call is accepted.
`StreamCallRejectedEvent`	Triggered when the call is rejected.
Media Events
`StreamCallRecordingStartedEvent`	Triggered when recording starts for a call.
`StreamCallRecordingStoppedEvent`	Triggered when recording stops for a call.
`StreamCallBroadcastingStartedEvent`	Triggered when broadcasting starts for a call.
`StreamCallBroadcastingStoppedEvent`	Triggered when broadcasting stops for a call.
Session Events
`StreamCallSessionStartedEvent`	Triggered when a new session starts for a call.
`StreamCallSessionEndedEvent`	Triggered when a session ends for a call.
`StreamCallSessionParticipantJoinedEvent`	Triggered when a participant joins the call session.
`StreamCallSessionParticipantLeftEvent`	Triggered when a participant leaves the call session.
Other Events
`StreamCallUserBlockedEvent`	Triggered when a user is blocked in a call.
`StreamCallUserUnblockedEvent`	Triggered when a user is unblocked in a call.
`StreamCallReactionEvent`	Triggered when someone sends a reaction during a call.

Custom event

Stream Video also supports custom events. This is a real-time layer that you can broadcast your own events to.

Sending custom events

You can use the sendCustomEvent method of the Call instance to send custom events:

call.sendCustomEvent(
    eventType: 'my-custom-event',
    custom: {
      'key': 'value',
    },
);

Receiving custom events

You can listen to custom events by listening to the StreamCallCustomEvent event via the same callEvents stream:

call.callEvents.on<StreamCallCustomEvent>((event) { });

Call Statistics

Initial call configuration