Sonos players support High-Definition (HD) audio (16-bit and 24-bit lossless) and Dolby Atmos audio. Whenever a user plays HD or Dolby Atmos content, the Now Playing screen will display a corresponding badge. This badge informs users that they are listening to HD or Dolby Atmos content, as shown below.

This badge is dynamic and will be removed if the content is either in lossy format or below 16-bit lossless.
How to badge an audio stream
The Sonos application supports text-based badging using definitions provided in StreamQualityBadgeDictionary
contained in your service PMAP.
To implement HD badging feature, your service must include a StreamQualityBadgeDictionary
type in your presentation map. Within this StreamQualityBadgeDictionary
object, define one or more QualityBadgeMap
entries that provide badging definitions for quality that your service support. Each QualityBadgeMap
will require an ID that identifies one of the quality buckets that our systems support (16- or 24-bit) and the associated text to display in the badge (HD, HiRes, etc.).
There are a few notes that you should keep in mind when implementing your service PMAP to support this feature:
- We recommend keeping text to 10 characters or fewer.
- The associated text in
QualityBadgeMap
is case-sensitive. For example, “HiRes” is not the same as “HIRES”. Sonos app will display the provided text as-is. - For Dolby Atmos content, Sonos application will automatically display Dolby Atmos badge.
1 2 3 4 5 6 7 8 |
<Presentation> <PresentationMap type="StreamQualityBadgeDictionary"> <StreamQualityBadgeDictionary> <QualityBadgeMap id="16bit" text="HD" /> <QualityBadgeMap id="24bit" text="HiRes" /> </StreamQualityBadgeDictionary> </PresentationMap> </Presentation> |
Here’s a scenario and the reports sent by players for a set of tracks:
Example | Quality ID | Text Displayed |
---|---|---|
|
16-bit | HD |
|
24-bit | HiRes |