HLS

HLS streaming provides better buffering than WebRTC, at the cost having a slight delay in your livestreams.

Start and stop HLS broadcast

There are two ways to start/stop HLS broadcast:

JavaScript

call.startHLSBroadcasting();

// to end broadcasting
call.stopHLSBroadcasting();

Python

call.start_hls_broadcasting()

# to end broadcasting
call.start_hls_broadcasting()

cURL

curl -X POST "https://video.stream-io-api.com/api/v2/video/call/${CALL_TYPE}/${CALL_ID}/start_broadcasting?api_key=${API_KEY}" \
    -H "Authorization: ${TOKEN}" \
    -H "stream-auth-type: jwt"

Or, if you're using backstage mode, you can do that when going live:

JavaScript

call.goLive();

// optionally start HLS broadcast and/or recording
call.goLive({ start_hls: true, start_recording: true });

Python

call.go_live(start_hls=True, start_recording=True)

cURL

curl -X POST "https://video.stream-io-api.com/api/v2/video/call/livestream/${CALL_ID}/go_live?api_key=${API_KEY}" \
  -H "Authorization: ${TOKEN}" \
  -H "stream-auth-type: jwt"

# optionally start HLS broadcast and/or recording
curl -X POST "https://video.stream-io-api.com/api/v2/video/call/livestream/${CALL_ID}/go_live?api_key=${API_KEY}" \
  -H "Authorization: ${TOKEN}" \
  -H "stream-auth-type: jwt" \
  -H "Content-Type: application/json" \
  -d '{ "start_hls": true, "start_recording": true }'

Once the live ended, the HLS broadcast will be stopped as well.

User permissions

To perform these operations, users need the following capabilities:

• start-broadcast-call
• stop-broadcast-call

Broadcast state

You can check if the call is being broadcasted like this:

JavaScript

const resp = await call.getOrCreate();
const isBroadcasting = resp.call.egress.broadcasting;

Python

response = call.get()
print(f"broadcasting: {response.data.call.egress.broadcasting}")

cURL

# Broadcasting state: resp.call.egress.broadcasting
curl -X GET "https://video.stream-io-api.com/api/v2/video/call/livestream/${CALL_ID}?api_key=${API_KEY}" \
  -H "Authorization: ${TOKEN}" \
  -H "stream-auth-type: jwt"

Events

These events are sent to users connected to the call and your webhook/SQS:

• call.broadcasting_started
• call.broadcasting_stopped
• call.broadcasting_failed

Consuming HLS broadcast

Users don't need to join the call to consume the HLS broadcast, but they need to have the URL of the broadcast:

JavaScript

const resp = await call.getOrCreate();
const URL = resp.call.egress.hls?.playlist_url;

Python

response = call.get()

# the URL of the HLS stream
response.data.call.egress.hls.playlist_url

cURL

# Broadcasting URL: resp.call.egress.hls.playlist_url
curl -X GET "https://video.stream-io-api.com/api/v2/video/call/livestream/${CALL_ID}?api_key=${API_KEY}" \
  -H "Authorization: ${TOKEN}" \
  -H "stream-auth-type: jwt"