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.

Resources