Skip to main content
Version: 0.1.x

Interactive Livestream (HLS) - React Native

Interactive live streaming (HLS) refers to a type of live streaming where viewers can actively engage with the content being streamed and with other viewers in real-time.

In an interactive live stream (HLS), viewers can participate in various activities, such as live polling, Q&A sessions, and even sending virtual gifts to the content creator or each other.

​ VideoSDK enables you to configure the interactive livestream layout in various ways, either by setting different prebuilt layouts in the configuration or by providing your own custom template for livestreaming according to your layout choice.

This guide provides an overview of how to implement starting and stopping Interactive Live Streaming (HLS).

important

To initiate automatic Interactive live streaming (HLS) at the beginning of a session, simply provide the autoStartConfig feature hls during room creation. For more information on configuring the autoStartConfig, please refer to the provided documentation here.

startHls()

The startHls() method, accesible from the useMeeting hook, is used to initiate interactive livestream of a meeting. This method accepts the following parameter:

  • config (optional): This parameter defines how the interactive livestream layout should look like. ​
    const config = {
    // Layout Configuration
    layout: {
    type: "GRID", // "SPOTLIGHT" | "SIDEBAR", Default : "GRID"
    priority: "SPEAKER", // "PIN", Default : "SPEAKER"
    gridSize: 4, // MAX : 25
    },

    // Theme of interactive livestream layout
    theme: "DARK", // "LIGHT" | "DEFAULT"

    // `mode` is used to either interactive livestream video & audio both or only audio.
    mode: "video-and-audio", // "audio", Default : "video-and-audio"

    // Quality of interactive livestream and is only applicable to `video-and-audio` type mode.
    quality: "high", // "low" | "med", Default : "med"

    // This mode refers to orientation of interactive livestream.
    // landscape : Start interactive livestream of the meeting in horizontally
    // portrait : Start interactive livestream of the meeting in vertically (Best for mobile view)
    orientation: "portrait", // "portrait", Default : "landscape"
    };

    startHls(config);

stopHls()

  • The stopHls() method, accesible from the useMeeting hook, is used to stop the interactive livestream of a meeting.

Example

import { useMeeting } from "@videosdk.live/react-native-sdk";
import { TouchableOpacity, Text } from "react-native";

const MeetingView = () => {
const { startHls, stopHls } = useMeeting();

const handleStartHls = () => {
// Start Hls
startHls({
layout: {
type: "GRID",
priority: "SPEAKER",
gridSize: 4,
},
theme: "DARK",
mode: "video-and-audio",
quality: "high",
orientation: "portrait",
});
};

const handleStopHls = () => {
// Stop Hls
stopHls();
};

return (
<>
<TouchableOpacity
onPress={() => {
handleStartLivestream();
}}
>
<Text>Start Hls</Text>
</TouchableOpacity>

<TouchableOpacity
onPress={() => {
handleStopHls();
}}
>
<Text>Stop Hls</Text>
</TouchableOpacity>
</>
);
};
tip

If you want to learn more about the Interactive Livestream and how to implement it on your own platform, you can checkout this guide.

Event associated with HLS

  • onHlsStateChanged - The onHlsStateChanged() event is triggered whenever the state of meeting HLS changes.

  • You can get the downstreamUrl of the HLS to play on the Viewer side when the state changes to Constants.hlsEvents.HLS_STARTED.

import { Constants, useMeeting } from "@videosdk.live/react-native-sdk";

function onHlsStateChanged(data) {
const { status } = data;

if (status === Constants.hlsEvents.HLS_STARTING) {
console.log("Meeting Hls is starting");
} else if (status === Constants.hlsEvents.HLS_STARTED) {
// on hlsStateChanged you will receive downstreamUrl
const { downstreamUrl } = data;
console.log("Meeting Hls is started");
} else if (status === Constants.hlsEvents.HLS_STOPPING) {
console.log("Meeting Hls is stopping");
} else if (status === Constants.hlsEvents.HLS_STOPPED) {
console.log("Meeting Hls is stopped");
} else {
//
}
}

const {
meetingId
...
} = useMeeting({
onHlsStateChanged,
...
});

API Reference

The API references for all the methods utilised in this guide are provided below.

Got a Question? Ask us on discord