Optional
adaptativeOptional
customOn certain type of networks, clients using default OpenVidu STUN/TURN server can not be reached it because firewall rules and network topologies at the client side. This method allows you to configure your own ICE Server for specific connections if you need it. This is usually not necessary, only it is usefull for OpenVidu users behind firewalls which allows traffic from/to specific ports which may need a custom ICE Server configuration
Add an ICE Server if in your use case you need this connection to use your own ICE Server deployment. When the user uses this connection, it will use the specified ICE Servers defined here.
The level of precedence for ICE Server configuration on every OpenVidu connection is:
OPENVIDU_WEBRTC_ICE_SERVERS
.If no value is found at level 1, level 2 will be used, and so on until level 4.
This method is equivalent to level 2 of precedence.
Only for WEBRTC
Optional
dataSecure (server-side) data associated to this Connection. Every client will receive this data in property Connection.data
. Object Connection
can be retrieved by subscribing to event connectionCreated
of Session object.
Session.connect(TOKEN, DATA)
(DATA
not defined), then Connection.data
will only have this data property.Session.connect(TOKEN, DATA)
(DATA
defined), then Connection.data
will have the following structure: "CLIENT_DATA%/%SERVER_DATA"
, being CLIENT_DATA
the second
parameter passed in OpenVidu Browser in method Session.connect
and SERVER_DATA
this data property.Optional
kurentoWARNING: experimental option. This interface may change in the near future
Some advanced properties setting the configuration that the WebRTC streams of the Connection will have in Kurento Media Server. You can adjust:
videoMaxRecvBandwidth
: maximum number of Kbps that the Connection will be able to receive from Kurento Media Server. 0 means unconstrained. Giving a value to this property will override
the global configuration set in OpenVidu Server configuration
(parameter OPENVIDU_STREAMS_VIDEO_MAX_RECV_BANDWIDTH
) for every incoming stream of the Connection.
WARNING: the lower value set to this property limits every other bandwidth of the WebRTC pipeline this server-to-client stream belongs to. This includes the user publishing the stream and every other user subscribed to the streamvideoMinRecvBandwidth
: minimum number of Kbps that the cConnection will try to receive from Kurento Media Server. 0 means unconstrained. Giving a value to this property will override
the global configuration set in OpenVidu Server configuration
(parameter OPENVIDU_STREAMS_VIDEO_MIN_RECV_BANDWIDTH
) for every incoming stream of the Connection.videoMaxSendBandwidth
: maximum number of Kbps that the Connection will be able to send to Kurento Media Server. 0 means unconstrained. Giving a value to this property will override
the global configuration set in OpenVidu Server configuration
(parameter OPENVIDU_STREAMS_VIDEO_MAX_SEND_BANDWIDTH
) for every outgoing stream of the Connection.
WARNING: this value limits every other bandwidth of the WebRTC pipeline this client-to-server stream belongs to. This includes every other user subscribed to the streamvideoMinSendBandwidth
: minimum number of Kbps that the Connection will try to send to Kurento Media Server. 0 means unconstrained. Giving a value to this property will override
the global configuration set in OpenVidu Server configuration
(parameter OPENVIDU_STREAMS_VIDEO_MIN_SEND_BANDWIDTH
) for every outgoing stream of the Connection.allowedFilters
: names of the filters the Connection will be able to apply. See Voice and video filtersOnly for WEBRTC
Optional
allowedOptional
videoOptional
videoOptional
videoOptional
videoOptional
networkSize of the buffer of the endpoint receiving the IP camera's stream, in milliseconds. The smaller it is, the less delay the signal will have, but more problematic will be in unstable networks. Use short buffers only if there is a quality connection between the IP camera and OpenVidu Server.
Only for IPCAM
2000
Optional
onlyWhether to enable the IP camera stream only when some user is subscribed to it, or not. This allows you to reduce power consumption and network bandwidth in your server while nobody is asking to receive the camera's video. On the counterpart, first user subscribing to the IP camera stream will take a little longer to receive its video.
Only for IPCAM
true
Optional
recordThis feature is part of OpenVidu PRO and ENTERPRISE editions
Whether to record the streams published by this Connection or not. This only affects INDIVIDUAL recording
true
Optional
roleOptional
rtspRTSP URI of an IP camera. For example: rtsp://your.camera.ip:7777/path
Only for IPCAM
Optional
typeType of Connection. The ConnectionType dictates what properties will have effect:
WEBRTC
Generated using TypeDoc
Whether to use adaptative bitrate (and therefore adaptative quality) or not. For local network connections that do not require media transcoding this can be disabled to save CPU power. If you are not sure if transcoding might be necessary, setting this property to false may result in media connections not being established.
Only for IPCAM
Default
true