CallControls

CallControls allows users to execute actions during the call(for example, mute/unmute audio/video, reactions, hang-up calls, etc.). We provide a built-in CallControls component that displays all relevant call controls during a call.

Preview of the CallControls component.

General Usage

The CallControls component displays the available controls for the call.

import {
  Call,
  CallContent,
  CallControls,
  StreamCall,
} from '@stream-io/video-react-native-sdk';

const VideoCallUI = () => {
  let call: Call;

  return (
    <StreamCall call={call}>
      <CallControls />
    </StreamCall>
  );
};

Props

onHangupCallHandler

Handler to be called when the call is left using the hangup call button in call controls.

Type
() => void | undefined

landscape

Applies the landscape mode styles to the component, if true.

Type
boolean | undefined

Built-in call controls

Each call control is available as a separate UI component.

AcceptCallButton

This component is used in the Incoming Call component to accept an incoming call.

TypeTypeDescription
onPressHandler() => void | undefinedHandler to be called when the accept call button is pressed. Used to override the default behaviour.
onAcceptCallHandler() => void | undefinedHandler to be called after the incoming call is accepted.

HangupCallButton

This component is used to hangup/leave an active call/outgoing call.

TypeTypeDescription
onPressHandler() => void | undefinedHandler to be called when the hang up call button is pressed. Used to override the default behaviour.
onHangupCallHandler() => void | undefinedHandler to be called after the call is hanged up.

RejectCallButton

This component is used in the Incoming Call component to reject an incoming call.

TypeTypeDescription
onPressHandler() => void | undefinedHandler to be called when the reject call button is pressed. Used to override the default behaviour.
onRejectCallHandler() => void | undefinedHandler to be called after the incoming call is rejected.

ToggleAudioPreviewButton

This component is used to toggle audio mute/unmute status before joining the call.

TypeTypeDescription
onPressHandler() => void | undefinedHandler to be called when the audio preview button is pressed. Used to override the default behaviour.

ToggleVideoPreviewButton

This component is used to toggle video mute/unmute status before joining the call.

TypeTypeDescription
onPressHandler() => void | undefinedHandler to be called when the video preview button is pressed. Used to override the default behaviour.

ToggleAudioPublishingButton

This component is used to toggle audio mute/unmute status while in the call.

TypeTypeDescription
onPressHandler() => void | undefinedHandler to override the default behaviour of the audio publishing button..

ToggleVideoPublishingButton

This component is used to toggle video mute/unmute status while in the call.

TypeTypeDescription
onPressHandler() => void | undefinedHandler to override the default behaviour of the video publishing button.

ToggleCameraFaceButton

This component is used to toggle camera face(front/back) when in the call.

TypeTypeDescription
onPressHandler() => void | undefinedHandler to override the default behaviour of the toggle camera face button.

ReactionsButton

This component is used to display the list of Reactions supported in the call. It can also be used to send reactions.

The following reactions are supported by default:

  • like 👍
  • raise hand ✋
  • fireworks 🎉
TypeTypeDescription
onPressHandler() => void | undefinedHandler to override the default behaviour when the reactions button is pressed.

ChatButton

This component is used to display/open the chat window while in the call.

TypeTypeDescription
onPressHandler() => void | undefinedHandler to override the default behaviour when the chat button is pressed.
unreadBadgeCountnumber | undefinedThe count of the current unread message to be displayed above on the Chat button.

Customization

You can create your own custom component using the built-in call controls as building blocks.

If you want to create custom call controls, follow the Call Controls UI Cookbook guide for more information.

© Getstream.io, Inc. All Rights Reserved.