Service: SRT WHEP Bridge - EyevinnOSC/community GitHub Wiki
SRT WHEP Bridge
The SRT WHEP Bridge (serviceId eyevinn-srt-whep) ingests an MPEG-TS over SRT stream and outputs it as WebRTC using the WHEP signaling protocol. In Eyevinn Open Source Cloud (OSC) it is a long-running service instance. License: Apache-2.0. Source: Eyevinn/srt-whep.
What it can do
- Let a reporter or commentator in the field watch the program output in a standard web browser, without special hardware or software.
- Output low-latency WebRTC without transcoding the video.
- Combine with Open Source Cloud Intercom to get both four-wire communication and program output in a browser.
It is a bridge, not a service for distributing to a large audience.
Creating an instance
Have an SRT source in listener mode, with a known IP address (or hostname) and port. Call create-service-instance with serviceId: "eyevinn-srt-whep":
{ "name": "mybridge", "SourceIp": "203.0.113.10", "SourcePort": "9234" }
Verify with wait-for-service-ready or get-instance-status; describe-service-instance returns the bridge URL, for example https://eyevinnlab-guide.eyevinn-srt-whep.auto.prod-se.osaas.io.
Options
| Option | Required | Type | Meaning |
|---|---|---|---|
| name | Yes | string | Name of the bridge. Alphanumeric/underscore only (^\w+$), at most 20 characters. |
| SourceIp | Yes | string | IP address of the SRT stream. The SRT source must be in listener mode. Internal DNS names only resolve inside the same Kubernetes cluster as the bridge, so for your own source use its public IP or hostname. |
| SourcePort | Yes | string | Port of the SRT stream. |
Using the instance
Play it in a WebRTC player that implements WHEP, for example the open source WebRTC player at https://webrtc.player.eyevinn.technology/. Enter the bridge URL followed by /channel, for example https://eyevinnlab-guide.eyevinn-srt-whep.auto.prod-se.osaas.io/channel. Startup time varies, and latency is very low since the bridge does not transcode.
OSC CLI equivalents:
% osc create eyevinn-srt-whep test \
-o SourceIp="srt.osaas-testsrc" \
-o SourcePort=9234
% osc remove eyevinn-srt-whep test
In that example srt.osaas-testsrc is the internal DNS name (a ClusterIP Service named srt in the osaas-testsrc namespace) of a shared, always-on SRT test source. Such names only work because the test source and the bridge run in the same cluster.