NEWDolby Interactivity APIs are now the Dolby.io Communications APIs Learn More >
X

VoxeetSDK

VoxeetSDK is the main object that allows the application to interact with Voxeet services. The SDK is asynchronous and uses promise at its core.

Accessors

command

Staticget command(): CommandService

Retrieves the CommandService instance that allows the participant to send messages to the specified conferences.

Returns: CommandService

conference

Staticget conference(): ConferenceService

Retrieves the ConferenceService instance that allows the participant to interact with conferences.

Returns: ConferenceService


filePresentation

Staticget filePresentation(): FilePresentationService

Retrieves the FilePresentationService instance that allows the participant to use file presentations.

Returns: FilePresentationService


mediaDevice

Staticget mediaDevice(): MediaDeviceService

Retrieves the MediaDeviceService instance that allows the participant to interact with devices through the system.

Returns: MediaDeviceService


notification

Staticget notification(): NotificationService

Retrieves the unique NotificationService instance,
which enables forwarding notifications from a developer to a properly registered manager.

Returns: NotificationService


recording

Staticget recording(): RecordingService

Retrieves the RecordingService instance that allows the participant to record conferences.

Returns: RecordingService


session

Staticget session(): SessionService

Retrieves the SessionService instance that allows the participant to use sessions.

Returns: SessionService


videoFilters

Staticget videoFilters(): VideoFiltersService

Retrieves the VideoFiltersService instance that allows applying video filters on the local participant's video stream.

Returns: VideoFiltersService


videoPresentation

Staticget videoPresentation(): VideoPresentationService

Retrieves the VideoPresentationService instance that allows the participant to use video presentations.

Returns: VideoPresentationService

Methods

initialize

Staticinitialize(customerKey: string, customerSecret: string): void

Initializes the SDK using the customer key and secret.

Parameters:

NameTypeDescription
customerKeystringThe customer key.
customerSecretstringThe customer secret.

Returns: void


initializeToken

StaticinitializeToken(accessToken: string, callback: Function): void

Initialize the SDK with an access token that is provided by the customer backend communicating with Voxeet servers. The token allows securing the customer key and secret.

The following diagram presents the authentication flow:

Client          Customer Server       Voxeet Server
  |                    |                    |
  |  Get Access Token  |  /oauth2/token (1) |
  |------------------->|------------------->|
  |    Access Token    |    Access Token    |
  |<-------------------|<-------------------|
  |  initializeToken(accessToken, callback) |
  |---------------------------------------->|

The access token has a limited period of validity and needs to be refreshed for security reasons. In such case,
The Voxeet SDK will call the callback provided to initializeToken. The callback must return a Promise
containing the refreshed access token by calling the customer backend, as presented in the following diagram:

Client          Customer Server       Voxeet Server
  |      callback      |  /oauth2/token (2) |
  |------------------->|------------------->|
  |    Access Token    |    Access Token    |
  |<-------------------|<-------------------|

Where (1) and (2) are two REST API endpoints available on Voxeet servers and documented on the developer portal.

Parameters:

NameTypeDescription
accessTokenstringThe access token provided by the customer's backend.
callbackFunctionA callback that returns a promise when the access token needs to be refreshed. The callback parameter takes the isExpired boolean parameter to check if the previous token has expired.

Returns: void


Did this page help you?