Live Source
OvenMediaEngine currently supports live sources using RTMP, a real-time messaging protocol supported by most popular encoders such as OBS, XSplit, and others. Also, we are developing input protocols such as SRT and MPEG-TS so that OvenMediaEngine can support more encoders.
Providers ingests streams that comes from media source. OvenMediaEngine currently supports RTMP protocol. You can set it in the configuration as follows:
<Application><Providers><RTMP>...</RTMP>...</Providers><Application>
When a live source inputs to the <Application>, a stream is automatically created in the <Application>. Moreover, the generated stream is streaming through Encoder and Publisher.
If you set up a live stream using an RTMP-based encoder, you need to set the following in Server.xml:
<Application><Providers><RTMP><BlockDuplicateStreamName>true</BlockDuplicateStreamName></RTMP></Providers><Application>
<BlockDuplicateStreamName>is a policy for streams that are inputted as overlaps.
<BlockDuplicateStreamName> works with the following rules:
Value | Description |
true |
|
false | Accepts a new stream inputted as overlap and disconnects the existing stream. |
To allow duplicated stream name feature can cause several problems. When a new stream is input, the player may be disconnected. Most encoders has the ability to automatically reconnect when it is disconnected from the server. As a result, two encoders compete and disconnect each other, which can cause serious problems in playback.
If you want to publish the source stream, you need to set the following in the Encoder:
URLRTMP://<OvenMediaEngine IP>[:<RTMP Listen Port>]/<App Name]>Stream KeyStream Name
If you use the default configuration, the <RTMP><ListenPort> is 1935, which is the default port for RTMP. So it can be omitted. Also, since the Application named app is created by default in the default configuration, you can enter app in the [App Name]. You can define a Stream Key and use it in the Encoder, and the Streaming URL will change according to the Stream Key.
Moreover, some encoders can include a stream key in the URL, and if you use these encoders, you need to set it as follows:
URLRTMP://<OvenMediaEngine IP>[:<RTMP Listen Port>/<App Name>/<Stream Name>
If you use the default configuration, set the OBS as follows:
You can set the Stream Key to any name you like at any time.
If you use the default configuration, you can stream with the following streaming URLs when you start broadcasting to OBS:
WebRTCws://192.168.0.1:3333/app/stream_oHLShttp://192.168.0.1:8080/app/stream_o/playlist.m3u8MPEG-DASHhttp://192.168.0.1:8080/app/stream_o/manifest.mpd
