• Public
  • Public/Protected
  • All

Interface OpenViduAdvancedConfiguration


  • OpenViduAdvancedConfiguration



Optional forceMediaReconnectionAfterNetworkDrop

forceMediaReconnectionAfterNetworkDrop: undefined | false | true

Determines the automatic reconnection process policy. Whenever the client's network drops, OpenVidu Browser starts a reconnection process with OpenVidu Server. After network is recovered, OpenVidu Browser automatically inspects all of its media streams to see their status. For any of them that are broken, it asks OpenVidu Server for a forced and silent reconnection.

This policy is technically enough to recover any broken media connection after a network drop, but in practice it has been proven that OpenVidu Browser may think a media connection has properly recovered when in fact it has not. This is not a common case, and it only affects Publisher streams, but it may occur. This property allows forcing OpenVidu Browser to reconnect all of its outgoing media streams after a network drop regardless of their supposed status.

Default to false.

Optional iceServers

iceServers: RTCIceServer[] | string

Array of RTCIceServer to be used by OpenVidu Browser. By default OpenVidu will generate the required credentials to use the COTURN server hosted along OpenVidu Server You can also set this property to string 'freeice' to force the use of free STUN servers instead (got thanks to freeice library).

Optional publisherSpeakingEventsOptions

publisherSpeakingEventsOptions: any

Custom configuration for the PublisherSpeakingEvent feature and the StreamManagerEvent.streamAudioVolumeChange feature. It is an object which includes the following optional properties:

  • interval: (number) how frequently the analyser polls the audio stream to check if speaking has started/stopped or audio volume has changed. Default 100 (ms)
  • threshold: (number) the volume at which publisherStartSpeaking and publisherStopSpeaking events will be fired. Default -50 (dB)

This sets the global default configuration that will affect all streams, but you can later customize these values for each specific stream by calling StreamManager.updatePublisherSpeakingEventsOptions

Optional screenShareChromeExtension

screenShareChromeExtension: undefined | string

URL to a custom screen share extension for Chrome (always based on ours: openvidu-screen-sharing-chrome-extension) to be used instead of the default one. Must be something like this: https://chrome.google.com/webstore/detail/YOUR_WEBSTORE_EXTENSION_NAME/YOUR_EXTENSION_ID

Generated using TypeDoc