WebRTC
Version 5 (Saúl Ibarra Corretgé, 07/30/2015 04:21 pm) → Version 6/33 (Saúl Ibarra Corretgé, 07/30/2015 04:29 pm)
h1. SylkServer WebRTC gateway application
Starting with version 3.0.0 SylkServer includes a WebRTC gateway application. The application implements a WebSocket protocol which WebRTC endpoints can use in order to interact with the SIP world.
h2. Architecture
TODO
h2. WebSocket API
SylkServer offers the WebSocket API in order to interact with the WebRTC gateway in the @ws(s)://hostname:port/webrtcgateway/ws@ endpoint. Both WebSocket and Secure WebSocket are supported, depending on how SylkServer was configured, check the configuration section.
The following API is modeled around 2 concepts: requests and events.
A request represents an action which SylkServer should perform, and it's identified with a transaction ID which the user must provide. SylkServer will reply with either an 'ack' or an 'error' response, with the associated transaction ID. An example transaction is that of adding an account.
Events are notifications sent by SylkServer to the client. They are the result of some change triggered by a user action, but they don't have a transaction ID associated with them. An example event would be the connection state changed event.
h3. Establishing the connection
In order to connect to SylkServer to begin to use the API a WebSocket connection must be established, using the @sylkRTC-1@ subprotocol. Example: TODO
<pre>
var conn = new WebSocket('wss://example.com/webrtcgateway/ws', 'sylkRTC-1');
</pre>
After the connection is established, a 'ready' event will be sent to the client, indicating that the connection is ready to be used:
<pre>
{
"sylkrtc": "event",
"event": "ready"
}
</pre>
h3. Account management
TODO
h3. Calling
TODO
h2. Configuration
TODO
h2. Client libraries
In order to interact with SylkServer's WebRTC gateway, we provide the "sylkrtc.js":http://projects.ag-projects.com/projects/sylkrtc JavaScript library. It implements the API described in this document in an easy to use manner. Check the README file in the project for the JavaScript API documentation.
Starting with version 3.0.0 SylkServer includes a WebRTC gateway application. The application implements a WebSocket protocol which WebRTC endpoints can use in order to interact with the SIP world.
h2. Architecture
TODO
h2. WebSocket API
SylkServer offers the WebSocket API in order to interact with the WebRTC gateway in the @ws(s)://hostname:port/webrtcgateway/ws@ endpoint. Both WebSocket and Secure WebSocket are supported, depending on how SylkServer was configured, check the configuration section.
The following API is modeled around 2 concepts: requests and events.
A request represents an action which SylkServer should perform, and it's identified with a transaction ID which the user must provide. SylkServer will reply with either an 'ack' or an 'error' response, with the associated transaction ID. An example transaction is that of adding an account.
Events are notifications sent by SylkServer to the client. They are the result of some change triggered by a user action, but they don't have a transaction ID associated with them. An example event would be the connection state changed event.
h3. Establishing the connection
In order to connect to SylkServer to begin to use the API a WebSocket connection must be established, using the @sylkRTC-1@ subprotocol. Example: TODO
<pre>
var conn = new WebSocket('wss://example.com/webrtcgateway/ws', 'sylkRTC-1');
</pre>
After the connection is established, a 'ready' event will be sent to the client, indicating that the connection is ready to be used:
<pre>
{
"sylkrtc": "event",
"event": "ready"
}
</pre>
h3. Account management
TODO
h3. Calling
TODO
h2. Configuration
TODO
h2. Client libraries
In order to interact with SylkServer's WebRTC gateway, we provide the "sylkrtc.js":http://projects.ag-projects.com/projects/sylkrtc JavaScript library. It implements the API described in this document in an easy to use manner. Check the README file in the project for the JavaScript API documentation.