2022-07-22

Updates to C++ SDK (v2.0.0) and Web Client SDK (v3.7.0-beta.3)

C++ SDK

2.0.0

Features

  • Introduced the join method that allows joining a conference as a user who can send and receive media. Additionally, this version of the SDK introduces the following methods that allow the local participant to send media to the conference and use the mute option:

    • start_audio: Starts audio transmission between the local client and a conference

    • stop_audio: Stops audio transmission between the local client and a conference

    • start_video: Starts video transmission between the local client and a conference

    • stop_video: Stops video transmission between the local client and a conference

    • set_media_source: Sets the Media Source instance as the media source for the SDK

    • set_audio_processing: Enables and disables audio processing of the local audio stream that is sent to the conference

    • mute: Mutes and unmutes the local participant

    • remote_mute: Stops and starts playing audio from a specific remote participant

    • mute_output: Mutes and unmutes an output audio device

    • stop_remote_audio: Allows the local participant to not receive an audio stream from a selected remote participant

    • start_remote_audio: Allows the local participant, who used the stop_remote_audio on a selected remote participant, to start receiving the remote participant's audio stream

  • Introduced the following methods:

  • The SDK now supports the ability to inject audio and video streams into the conference using the Media Injection API and the Default Media Injector.

  • The SDK now supports the ability to capture and store remote audio and video data using the Media Recording API and the Default Media Recorder.

  • The SDK now supports Apple macOS 10.14+ and Microsoft Windows 10, 64 bit.

  • The SDK now supports the Dolby Voice Codec (DVC) in Dolby Voice conferences to improve audio processing and offer higher audio quality. The use of DVC also increases the conference capacity from 50 users to 250 users in audio-only conferences. The DVC codec is supported only on macOS and Windows.

  • Introduced a new Spatial Audio feature that allows placing conference participants spatially in a 3D rendered audio scene and hearing the audio from the participants rendered from their locations. This feature replicates audio conditions similar to real-life conditions to make virtual meetings more natural and realistic. Spatial audio is supported on Dolby Voice Clients and Stereo Opus Clients in Dolby Voice conferences. The Spatial Audio feature offers the following APIs:

    • spatial_audio: Enables spatial audio for the local participant.

    • set_spatial_position: Sets the participant’s position in space.

    • set_spatial_direction: Defines the direction the local participant is facing; this allows for rotation of the local participant's head and modifies their audio depending on the new direction they are facing in space.

    • set_spatial_environment: Allows an application to configure the spatial audio environment to work with an application’s coordinate system. This way, the audio renderer understands which directions the application considers forward, up, and right and which units it uses for distance.

    • update_spatial_audio_configuration: Updates the spatial audio configuration to enable spatial audio during a conference. This method contains information about participants’ locations, the direction the local participant is facing, and a spatial environment of an application.

    The spatial audio feature allows choosing a spatial audio style. You can either use the individual or shared style:

    • In the individual style, positions are not shared between participants, so each participant sets the positions of all participants and hears a unique spatial audio scene. This style is ideal for video conferencing where each participant sees a different layout of video tiles.

    • In the shared style, one spatial audio scene is shared by all participants who hear audio from their locations. This approach is ideal for shared spaces, such as virtual trade shows or games. The additional benefit of this style is simplified communication between the client and the server and decreased network traffic. This style is only available for participants who joined a conference with spatial audio enabled.

    Information about integrating spatial audio is available in the Integrating Individual Spatial Audio and Integrating Shared Spatial Audio guides.

Changes

Modified the implementation of asynchronous operations. To check the latest implementation, see the Asynchronous Operations documentation.

Web Client SDK

3.7.0-beta.3

Bug Fixes

Fixed an issue where video enabled via the startVideo or startCustomVideo method was not properly handled on Windows when resolution was higher than 1280x720.