Monitoring Call Quality - React Native

Monitor the local participant’s call quality to catch problems during the room. Changes in network conditions or device performance can directly affect audio and video quality. By subscribing to the onQualityLimitation event accessible from the useRoom hook, your app can detect these changes in real-time and provide immediate feedback to the participant.

Why It Matters

Even brief network congestion, low bandwidth, or high CPU usage can impact the room experience. Monitoring these limitations allows your app to:

• Notify the local participant of potential issues affecting audio or video quality.
• Let the participant take action, like switching networks or closing other heavy applications.

Example Usage

The callback receives one object with type, state, and timestamp. Refer to the Monitoring Network Quality guide for their values.

import { useRoom } from "@videosdk.live/react-native-sdk";

function onQualityLimitation(data) {
  const { type, state, timestamp } = data;
  console.log(`Quality limitation ${type} is ${state} at ${timestamp}`);
}

function RoomView() {
  const { roomId } = useRoom({
    onQualityLimitation,
  });

  return null;
}

API Reference

The API references for all the methods and events utilized in this guide are provided below.

• onQualityLimitation