Skip to content
Platform docs
Auth, users, webhooks & more
Info:
This is beta documentation for Stream Video React Native SDK v2. For the latest stable version, see the latest version (v1).

CallControls

Execute call actions (mute/unmute, reactions, hang-up, etc.) with the built-in CallControls component.

Preview of the CallControls component.

General Usage

Display available call controls:

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

Callback invoked after leave attempt from the hangup call button in call controls. Receives an error on failure.

Type
(err?: Error) => 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.

Type Type Description
onPressHandler () => void | undefined Handler to be called when the accept call button is pressed. Used to override the default behaviour.
onAcceptCallHandler (err?: Error) => void | undefined Callback invoked after incoming call accept attempt. Receives an error on failure.

HangupCallButton

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

Type Type Description
onPressHandler () => void | undefined Handler to be called when the hang up call button is pressed. Used to override the default behaviour.
onHangupCallHandler (err?: Error) => void | undefined Callback invoked after hangup attempt. Receives an error on failure.

RejectCallButton

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

Type Type Description
onPressHandler () => void | undefined Handler to be called when the reject call button is pressed. Used to override the default behaviour.
onRejectCallHandler (err?: Error) => void | undefined Callback invoked after incoming call reject attempt. Receives an error on failure.

ToggleAudioPreviewButton

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

Type Type Description
onPressHandler () => void | undefined Handler 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.

Type Type Description
onPressHandler () => void | undefined Handler 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.

Type Type Description
onPressHandler () => void | undefined Handler 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.

Type Type Description
onPressHandler () => void | undefined Handler 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.

Type Type Description
onPressHandler () => void | undefined Handler 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:

  • rolling on the floor laughing 🤣
  • like 👍
  • rocket 🚀
  • dislike 👎
  • fireworks 🎉
  • raised hands 🙌
  • raised hand ✋
Type Type Description
onPressHandler () => void | undefined Handler to override the default behaviour when the reactions button is pressed.

Customization

Create custom components using built-in call controls as building blocks. See the Call Controls UI Cookbook guide.