Meeting Rooms for WebSDK

Integrate real-time voice and text chat into your application using the StreamPixel SDK.

1. Overview

The Meeting Room feature in the Streampixel Web SDK allows multiple users to join the same live stream using SFU (Selective Forwarding Unit).

This setup follows a strict Host + Client model:

• ✅ Only one Host

• ✅ Multiple Clients (Guests)

• ✅ All users connect using the same streamerId

• ✅ SFU role is controlled via SDK parameters

Think of streamerId as the Meeting Room ID.

---

2. Core Rules (Must Read)

1. Exactly one Host must use sfuHost="true"

2. All Clients must use sfuPlayer="true"

3. Host and Clients must share the same streamerId

4. sfuHost and sfuPlayer must be strings, not booleans

---

3. Host SDK Initialization

const { appStream, pixelStreaming, queueHandler, UIControl } =
  await StreamPixelApplication({
    appId: projectId,
    streamerId: streamerId,
    sfuHost: "true"
  });

Explanation

• appId → Streampixel project ID

• streamerId → Unique Meeting Room identifier

• sfuHost: "true" → Enables SFU Host mode

• Only one user should ever initialize with sfuHost="true"

---

4. Client SDK Initialization

const { appStream, pixelStreaming, queueHandler, UIControl } =
  await StreamPixelApplication({
    appId: projectId,
    streamerId: streamerId,
    sfuPlayer: "true"
  });

Explanation

• Uses the same streamerId as the host

• sfuPlayer: "true" → Enables SFU Client (Guest) mode

• Any number of clients can join using this setup

---

5. How Host & Clients Join the Same Meeting

Parameter	Host	Client
appId	Same	Same
streamerId	Same	Same
sfuHost	"true"	❌
sfuPlayer	❌	"true"

As long as:

• streamerId matches

• Only one host exists

All users join the same Meeting Room.

---

streamerId Best Practices

• Generate a unique streamerId per meeting

• Generate it once (backend recommended)

• Share the same streamerId with host and all clients

Good Example

019c327b-c6d6-7723-9b38-89286c533faf

Bad Example

test-room