Skip to content

Commit c66589e

Browse files
AntonPo456Copilot
andcommitted
Add audio capability query examples and matrix to supported-play-type-strings
- Add audio/mp4 as a supported media type for audio-only codec queries - Add audio capability query examples for codec support, endpoint device capabilities, and speaker configuration discovery - Add example capability matrix showing audio-endpoint-codec and codecs=ac-3 query results across 8 representative device configurations Co-authored-by: Copilot <[email protected]>
1 parent 0ee5adf commit c66589e

1 file changed

Lines changed: 47 additions & 1 deletion

File tree

uwp/audio-video-camera/supported-play-type-strings.md

Lines changed: 47 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,12 +42,13 @@ Many of these APIs return enumeration values that express the result as "NotSupp
4242

4343
## Media type and subtype
4444

45-
Windows APIs only support content type strings with the media type `"video"` and the subtype/container of `"mp4"`.
45+
Windows APIs support content type strings with the media types `"video"` and `"audio"` and the subtype/container of `"mp4"`.
4646

4747

4848
| Value | Description | Remarks |
4949
|-------|-------------|----------------|--------------------|
5050
| "video/mp4" | Video media type and MPEG-4 subtype/container. | |
51+
| "audio/mp4" | Audio media type and MPEG-4 subtype/container. | Used for audio-only codec capability queries. |
5152

5253

5354

@@ -144,3 +145,48 @@ Note that if the endpoint supports more or the same number of channels as specif
144145
| PCM7.1 | Uncompressed 7.1 channel audio | |
145146
| AC3 | Dolby Digital | |
146147

148+
### Audio capability query examples
149+
150+
Windows supports enhanced MIME CanPlayType queries that allow a client to discover the audio capabilities of a device. You can query the CanPlayType/IsTypeSupported API for audio capabilities to find out what codecs are available on the machine, the number of speakers the system is configured for, and the capabilities of the connected audio endpoint device.
151+
152+
**Querying for audio codec support**
153+
154+
Use the `codecs` parameter to determine whether the system has a software decoder that can decode the specified audio format into PCM and play it through the connected speaker or headphone configuration.
155+
156+
`"audio/mp4; codecs=\"ac-3\""`
157+
158+
This query checks whether there is a software decoder that can decode AC-3 (Dolby Digital) audio.
159+
160+
**Querying for audio endpoint device capabilities**
161+
162+
Use the `audio-endpoint-codec` feature to determine the capabilities of the audio endpoint device, such as whether the system is connected to an audio/video receiver (AVR) that can decode a specific audio format.
163+
164+
`"video/mp4; codecs=\"avc3,mp4a\";features=\"audio-endpoint-codec=DD\""`
165+
166+
This query checks whether the connected audio endpoint device, such as an AVR, can play Dolby Digital audio.
167+
168+
**Querying for speaker configuration**
169+
170+
Use the `audio-endpoint-codec` feature with a PCM codec string to discover the number of speakers the system is configured for.
171+
172+
`'video/mp4; features="audio-endpoint-codec=PCM5.1"'`
173+
174+
This query checks whether the system is configured for 5.1 speakers and can play 5.1-channel PCM audio. If the endpoint supports an equal or greater number of channels than specified, the check succeeds.
175+
176+
### Example audio capability matrix
177+
178+
When systems with Dolby Atmos or headphones that support Virtual Surround Sound (VSS) are considered, the number of possible hardware and software combinations can be very large. The following table shows the query results for the `audio-endpoint-codec` feature and the `codecs=ac-3` codec query across representative device configurations.
179+
180+
| # | Device configuration | Dolby decoder | DD | DD+ | DD+JOC | PCM2.0 | PCM5.1 | PCM7.1 | codecs=ac-3 |
181+
|---|---------------------|---------------|:---:|:---:|:------:|:------:|:------:|:------:|:-----------:|
182+
| 1 | Headphones with Atmos, VSS enabled | Installed ||||||||
183+
| 2 | Headphones without Atmos, VSS disabled | Installed ||||||||
184+
| 3 | Headphones without Atmos, VSS enabled | Installed ||||||||
185+
| 4 | Headphones without Atmos, VSS enabled | Not installed ||||||||
186+
| 5 | 5.1 speakers (no AVR) | Installed ||||||||
187+
| 6 | 5.1 speakers (no AVR) | Not installed ||||||||
188+
| 7 | Atmos-capable AVR, configured for 5.1 | Installed ||||||||
189+
| 8 | Atmos-capable AVR, configured for 5.1 | Not installed ||||||||
190+
191+
The DD, DD+, DD+JOC, PCM2.0, PCM5.1, and PCM7.1 columns show the results of the `audio-endpoint-codec` feature query. The `codecs=ac-3` column shows whether a software decoder for AC-3 (Dolby Digital) is available on the system.
192+

0 commit comments

Comments
 (0)