Skip to main content
Version: /v2

Start HLS Stream

This API lets you start an HLS stream by passing roomId and config object as body parameters.
Body Parameters
REQUIRED
The ID of the Room.
OPTIONAL
  • orientation - hls stream orientation will be set to "landscape" by default, if you pass portrait orientation then it will stream hls in portrait mode.
  • config:
    • layout:
      • type: "GRID" | "SPOTLIGHT" | "SIDEBAR"
      • priority: "SPEAKER" | "PIN"
      • gridSize: Number max 25
    • orientation: "landscape" | "portrait"
    • theme: "DARK" | "LIGHT" | "DEFAULT"
    • mode: "video-and-audio" | "audio"
    • quality: "low" | "med" | "high"
POST
|
https://api.videosdk.live/v2/hls/start
NodeJS
import fetch from 'node-fetch';
const options = {
	method: "POST",
	headers: {
		"Authorization": "$YOUR_TOKEN",
		"Content-Type": "application/json",
	},
	body: JSON.stringify({"roomId" : "xyz","templateUrl" : "https://www.example.com/?token=tooken&meetingId=74v5-v21l-n1ey&participantId=RECORDER_ID","config" : "configObj"}),
};
const url= `https://api.videosdk.live/v2/hls/start`;
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
RESPONSE
{
  "downstreamUrl": "https://cdn.videosdk.live/meetings-hls/2e200932-e00f-4e5f-b35d-73d3079e6bf5/index.m3u8"
}