0.13.[0-2]
WebRTC (Beta)
User can send video/audio from web browser to OvenMediaEngine via WebRTC without plug-in. Of course, you can use any encoder that supports WebRTC transmission as well as a browser.
Configuration
Bind
In order for OvenMediaEngine to receive streams through WebRTC, web socket-based signaling port and ICE candidate must be set. The ICE candidate can configure a TCP relay. WebRTC provider and WebRTC publisher can use the same port. Ports of WebRTC provider can be set in as follows.
1
<Bind>
2
<Providers>
3
...
4
<WebRTC>
5
<Signalling>
6
<Port>3333</Port>
7
</Signalling>
8
<IceCandidates>
9
<TcpRelay>*:3478</TcpRelay>
10
<IceCandidate>*:10006-10010/udp</IceCandidate>
11
</IceCandidates>
12
</WebRTC>
13
</Providers>
Copied!
Application
WebRTC input can be turned on/off for each application. As follows Setting enables the WebRTC input function of the application.
1
<Applications>
2
<Application>
3
<Name>app</Name>
4
<Providers>
5
<WebRTC />
Copied!
URL Pattern
The signaling url for WebRTC input uses the query string(?direction=send) as follows to distinguish it from the url for WebRTC playback.
ws[s]://<host>[:port]/<app name>/<stream name>?direction=send
When WebRTC transmission starts, a stream is created with under application.
WebRTC over TCP
WebRTC transmission is sensitive to packet loss because it affects all players who access the stream. Therefore, it is recommended to provide WebRTC transmission over TCP. OvenMediaEngine has a built-in TURN server for WebRTC/TCP, and receives or transmits streams using the TCP session that the player's TURN client connects to the TURN server as it is. To use WebRTC/TCP, use transport=tcp query string as in WebRTC playback. See WebRTC/tcp playback for more information.
ws[s]://<host>[:port]/<app name>/<stream name>?direction=send&transport=tcp
To use WebRTC/tcp, <TcpRelay> must be turned on in <Bind> setting.
WebRTC Producer
We provide a demo page so you can easily test your WebRTC input. You can access the demo page at the URL below.
OvenPlayer
The getUserMedia API to access the local device only works in a secure context. So, the WebRTC Input demo page can only work on the https site https://demo.ovenplayer.com/demo_input.html. This means that due to mixed content you have to install the certificate in OvenMediaEngine and use the signaling URL as wss to test this. If you can't install the certificate in OvenMediaEngine, you can temporarily test it by allowing the insecure content of the demo.ovenplayer.com URL in your browser.
Custom WebRTC Producer
To create a custom WebRTC Producer, you need to implement OvenMediaEngine's Signaling Protocol. The protocol is structured in a simple format and uses the same method as WebRTC Streaming.
When the player connects to ws[s]://host:port/app/stream?direction=send through a web socket and sends a request offer command, the server responds to the offer sdp. If transport=tcp exists in the query string of the URL, iceServers information is included in offer sdp, which contains the information of OvenMediaEngine's built-in TURN server, so you need to set this in RTCPeerConnection to use WebRTC/TCP. The player then setsRemoteDescription and addIceCandidate offer sdp, generates an answer sdp, and responds to the server.
Last modified 3mo ago
Export as PDF
Copy link