You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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]>
| "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. |
51
52
52
53
53
54
@@ -144,3 +145,48 @@ Note that if the endpoint supports more or the same number of channels as specif
144
145
| PCM7.1 | Uncompressed 7.1 channel audio ||
145
146
| AC3 | Dolby Digital ||
146
147
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.
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.
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.
0 commit comments