Starts a WebRTC signalling client to an ERS (Evostream Rendezvous Server).
This will open the port in the given IP address and will open doors for the room ID which can be accessed using the evowrtcclient.html
API Parameter Table
Parameter Name | Type | Mandatory | Default Value | Description |
---|---|---|---|---|
ersIp | string | true | null | IP address (xx.yy.zz.xx) of ERS |
ersPort | string | true | null | Port number where ERS will listen to |
roomId | string | true | null | Unique room Identifier within ERS that will be used by client browsers to connect to this EMS |
token | string | false | null | The security token to be used within ERS |
API Call Template
startWebrtc ersip=<ERS_IPAddress> ersport=<ERS_Port> roomid=<roomID>
Sample API Call
startWebrtc ersip=52.6.14.61 ersport=3535 roomid=testRoom
Success Response in JSON
{
"data": {
"data": {
"configId": 2,
"ers": "",
"ersOverSsl": false,
"ersip": "54.174.188.145",
"ersport": 4545,
"keepAlive": true,
"name": "evostreamms",
"operationType": 9,
"roomid": "testRoom",
"sslCert": "../config/server.cert",
"sslKey": "../config/server.key",
"token": ""
},
"description": "Started WebRTC Negotiation Service",
"status": "SUCCESS"
}
}
JSON Response
The JSON response contains the following details:
- data – The data to parse.
- configId - The configuration ID for this command
- ers - The name of the ERS
- ersOverSsl - The configuration of the SSL
- ersip – The IP address of the ERS
- ersport – The port of the ERS where it listens to
- keepAlive - If
keepAlive
is set to true, EMS will reconnect to ERS in the event that it gets disconnected - name - The name of the application using the ERS
- operationType – The type of operation, for internal use only
- roomId – The room identifier
- sslCert - The SSL certificate
- sslKey - The SSL key certificate
- token - The security token used within ERS
- description – Describes the result of parsing/executing the command
- status – SUCCESS if the command was parsed and executed successfully, FAIL if not.
Notes
- Room ID can only be started once