ListenOptions

The ListenOptions model allows specifying media preference for a listener. The ListenOptions model specifies:

• Conference access token that is required to join a protected conference
• The maximum number of video streams that may be transmitted to the joining participant
• Information whether the joining participant wants to handle the beforeunload event on the application level

Properties

conferenceAccessToken

• Optional conferenceAccessToken: string

The conference access token that is required to join a protected conference if the conference is created using the create REST API. If the conference is created using the create method, the token is managed by the SDK and is not visible to the application users. For more information, see the Enhanced Conference Access Control document.

leaveConferenceOnBeforeUnload

• Optional leaveConferenceOnBeforeUnload: boolean

Allows handling the beforeunload event on the application level instead of on the SDK level. By default, the SDK listens to the beforeunload event and leaves a conference when this event is triggered. When leaveConferenceOnBeforeUnload is set to false, the SDK stops reacting on the beforeunload event, which allows customizing the beforeunload handling. In this case, the SDK does not react to events such as closing a tab to leave a conference and these events need to be also handled on the application level.

maxVideoForwarding

• Optional maxVideoForwarding: number

Sets the maximum number of video streams that may be transmitted to the joining participant. The valid parameter's values are between 0 and 25 for desktop browsers and between 0 and 4 for mobile browsers. In the case of providing a value smaller than 0 or greater than the valid values, SDK triggers the VideoForwardingError. If the parameter value is not specified, the SDK automatically sets the maximum possible value: 25 for desktop browsers and 4 for mobile browsers.