2022-02-03

Updates to the Web Client SDK (v3.4.0), iOS Client SDK (v3.4.0-beta.3), and Android Client SDK (v3.4.0)

Web Client SDK

3.4.0

Features

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 at the given locations. This feature replicates audio conditions similar to real conference room 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 for the Web SDK:

  • spatialAudio: Enables spatial audio for the local participant. When set to true, the application must place remote participants in a 3D space using the setSpatialPosition method.

  • setSpatialEnvironment: 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.

  • setSpatialPosition: Sets a participant's position in space to enable the spatial audio experience during a Dolby Voice conference. Depending on the specified participant in the participant parameter, the setSpatialPosition method impacts the location from which audio is heard or from which audio is rendered.

  • setSpatialDirection: 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.

Setting the spatial audio scene for listeners is supported via the Set Spatial Listeners Audio REST API.

Bug Fixes

  • Fixed an issue where the audioTransmitting property does not reflect the correct audio transmitting status.

  • Fixed an issue where a participant who rejoins a conference does not see video tiles of other conference participants.

iOS Client SDK

3.4.0-beta.3

Features

Optimized communication with the Dolby.io server to not update unchanged participants' positions.

Bug Fixes

  • Fixed an issue where the audioTransmitting property does not reflect the correct audio transmitting status.

  • Fixed an issue where some conference participants are not heard during a conference enabled with Spatial Audio.

Android Client SDK

3.4.0

Features

  • 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 at the given locations. This feature replicates audio conditions similar to real conference room 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 for the Android SDK:

    • setSpatialAudio: Enables spatial audio for the local participant. When set to true, the application must place remote participants in a 3D space using the setSpatialPosition method. The isSpatialAudio API returns true if spatial audio will be enabled during a conference.

    • setSpatialEnvironment: 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.

    • setSpatialPosition: Sets a participant's position in space to enable the spatial audio experience during a Dolby Voice conference. Depending on the specified participant in the participant parameter, the setSpatialPosition method impacts the location from which audio is heard or from which audio is rendered.

    • setSpatialDirection: 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.

    Setting the spatial audio scene for listeners is supported via the Set Spatial Listeners Audio REST API.

  • The Android Client SDK now allows joining conferences with enabled video.

  • Added the DemoOptions and DemoOptions.Builder models that allow setting spatial audio in demo conferences and checking if spatial audio is enabled.

  • Added the following parameters to the ParamsHolder model:

    • setTtl: Allows customizing time after which the SDK terminates empty conferences.
    • setRtcpMode: Allows setting the bitrate adaptation mode for video transmission.
    • setLiveRecording: A boolean that enables and disables live recording.
  • Added a new audioOnly parameter that allows creating audio-only conferences where participants cannot enable cameras.

Changes

  • Renamed the following FilePresentationService methods:

    • The convertFile method is renamed to convert
    • The getImage method is renamed to image
    • The getThumbnail method thumbnail
  • Modified the ActiveSpeakerChangeEvent that now contains new properties.

  • Full support for AndroidX; all remaining references to support library are updated to AndroidX.

Bug Fixes

  • Fixed an issue where the audioTransmitting property does not reflect the correct audio transmitting status.

  • Fixed an issue where the decline method is not responding properly on Conference Access Token enabled keys.

  • Fixed an issue where audio devices continue to be managed by the SDK after leaving the conference.

  • Fixed an issue where unsubscribe did not function as expected.

  • Fixed the following issues with FilePresentation:

    • convert did not resolve properly
    • Issues with FilePresentation logic
    • Duplicate presentation events added to list of known presentations
  • Fixed an issue that caused null Media Engine errors

  • Fixed a sound control issue that occurs when a participant uses a wired headset.