Audio track and logo selection for iOS apps integrating Dolby Audio for Applications

Aug 3, 2023
Knowledge

Title

URL Name

Track-and-logo-selection-for-iOS-apps-integrating-Dolby-Audio-for-Applications

Created By

MCW, 3/7/2025 12:31 AM

Last Modified By

MCW, 3/7/2025 12:57 AM

Validation Status

Validated

Publication Status

Published

Assigned To

Assigned By

Assignment Due Date

Article Content

iOS apps that integrate Dolby Audio for Applications to enable AC-4 decoding are not able to utilize the built-in Spatial Audio capabilities of iOS and need to use alternative APIs to determine whether an endpoint can support a Dolby Audio or Dolby Atmos experience.

It is recommended that apps detect the audio output portType of AVAudioSession.currentRoute and use this to control:

Selection of Dolby AC-4 or stereo tracks
Display of the Dolby Audio or Dolby Atmos logo
When a Dolby Audio or Dolby Atmos track is selected, the DAA decoder mode.

The following table shows the different output port types and the corresponding app behavior.

AVAudioSession portType	Track selection	DAA decoder mode	Dolby logo shown during playback
builtinspeaker (2-channel output)	Dolby Audio or Dolby Atmos (AC-4)	Virtualized stereo speaker output	Yes
headphones	Dolby Audio or Dolby Atmos (AC-4)	Virtualized headphone output
bluetootha2dp Major device class = 0x400 Minor device class = 0x1 or 0x6
bluetootha2dp All other major / minor device classes	Alternative stereo track	N/A	No
All other portTypes