High-definition audio badging

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.

Here’s a scenario and the reports sent by players for a set of tracks:

Example Quality ID Text Displayed

<QualityBadgeMap id="16bit" text="HD"/>

16-bit HD

<QualityBadgeMap id="24bit" text="HiRes"/>

24-bit HiRes