Service: Symphony Media Bridge WHEP Gateway - EyevinnOSC/community GitHub Wiki
Getting Started
The Symphony Media Bridge (SMB) is a media server application that handles audio, video, and screen sharing media streams in an RTC conference system. The SMB WHEP Gateway provides a WHEP (WebRTC-HTTP Egress Protocol) endpoint that lets any WHEP-compatible media player pull a video stream out of a Symphony Media Bridge conference. It is the egress counterpart to the Symphony Media Bridge WHIP Gateway.
Deploy it from the OSC dashboard.
Prerequisites
- An OSC account (sign up here)
- A running Symphony Media Bridge instance on OSC
Step 1: Note your SMB URL
Open your Symphony Media Bridge instance in the OSC dashboard and copy its URL. You will need it when creating the WHEP gateway.
Optionally note your SMB API key if your Symphony Media Bridge instance requires authentication.
Step 2: Create the WHEP gateway
Via web console
- Go to app.osaas.io/dashboard/service/eyevinn-wrtc-egress
- Click Create gateway
- Fill in the fields:
| Field | Value |
|---|---|
| name | A short identifier, e.g. myegress |
| SmbUrl | URL of your Symphony Media Bridge instance |
| SmbApiKey | API key for your SMB instance (optional) |
- Click Create and wait for the instance to show status Running
- Copy the instance URL — this is your WHEP endpoint base URL
Via CLI
npx -y @osaas/cli create eyevinn-wrtc-egress myegress \
-o SmbUrl="https://mysmb.eyevinn-docker-wrtc-sfu.auto.prod.osaas.io"
Step 3: Pull a stream via WHEP
With the WHEP gateway running, any WHEP-compatible player can subscribe to a conference stream. The WHEP endpoint URL follows this pattern:
https://myegress.eyevinn-wrtc-egress.auto.prod.osaas.io/api/v2/whep/<endpoint-id>
Replace myegress with your instance name and <endpoint-id> with the conference endpoint ID from your Symphony Media Bridge.
You can test playback with a WHEP player such as web.whep.eyevinn.technology.