What is an Endpoint?
Understanding Ingress and Egress URLs in Deep Live Hub for Sending and Receiving Streams
Endpoints are system-generated URLs that allow you to either send an audio or video signal to the Deep Live Hub system (ingress) or retrieve a stream from the system (egress). Once a workflow is created, both ingress and egress URLs are automatically generated. You can add or delete additional egress URLs and configure them in the "Outputs" tab of your workflow menu.
Endpoints URL Structure
Each endpoint URL consists of several components:
- Endpoint name (endpointname): Created by the system by appending a number to the "workflow name" chosen by the user.
- Language identifier (langID): Specifies the language of the input or output stream for example "de" or "en"
- Streamkey (UUID): The stream key is a unique identifier (UUID) assigned to each stream. It ensures that the correct audio or video signal is matched with the intended workflow.
- Base URL (baseURL): The foundational part of the URL that remains constant.
Ingress URLs
-
RTMP Ingress:
rtmp://baseURL/endpointname-langID/streamkey
-
WebRTC Ingress:
webrtc://baseURL/endpointname-langID/streamkey
Note:
You must specify the correct input language by adjusting the language identifier
(langID) according to the language of your source signal.
What is a Language Identifier?
The language identifier is a code added to your ingress URL that specifies the language of your stream. For example, "de" is for German, "en" for Englisch, "fr" for French,...
Make sure to use the correct identifier for the languages you want.
Egress URLs
-
SRT Stream for Subtitles (only transcription, no tranlation):
https://baseURL/export/subtitles/endpointname-streamkey.srt
-
SRT Stream for Translations (LangId at the end defines target language):
https://baseURL/export/subtitles/endpointname-streamkey-langID.srt
-
RTMP Egress:
rtmp://baseURL/endpointname-egress/streamkey
-
HLS Egress:
https://baseURL/endpointname-egress/streamkey.m3u8
-
HLS Realtime Egress:
https://baseURL/export/hls-rt/endpointname-egress/streamkey.m3u8