AudioRenderCategory Enum

Definition

Namespace:

Windows.Media.Render

Describes the purpose of the audio information in an audio stream.

public enum class AudioRenderCategory

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class AudioRenderCategory

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum AudioRenderCategory

var value = Windows.Media.Render.AudioRenderCategory.other

Public Enum AudioRenderCategory

Inheritance

Enum

AudioRenderCategory

Attributes

ContractVersionAttribute

Windows requirements

Device family	Windows 10 (introduced in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v1.0)

Fields

Name	Value	Description
Other	0	All other streams.
ForegroundOnlyMedia	1	Audio is for general media, for example audio for video, or streaming audio, but should not be played as background. This enumeration value is deprecated. For more information, see Remarks.
BackgroundCapableMedia	2	Audio is for general media, for example audio for video, or streaming audio, and can be played as background. This enumeration value is deprecated. For more information, see Remarks.
Communications	3	Audio is for peer-to-peer communications, for example chat or VoIP.
Alerts	4	Audio is for system or application notifications, for example ring tones.
SoundEffects	5	Audio is for sound effects.
GameEffects	6	Audio is for game-specific sound effects.
GameMedia	7	Audio is background (non-event or ambient) audio for games.
GameChat	8	Audio is voice chat for games.
Speech	9	Audio is speech.
Movie	10	Audio is movie audio.
Media	11	Audio is media playback.

Remarks

Starting in Windows 10, version 1511 the ForegroundOnlyMedia and BackgroundCapableMedia enumeration values are deprecated. For more info about using background audio in your app, see Play media in the background.

Games should categorize their music streams as GameMedia so that game music mutes automatically if another application plays music in the background. Music or video applications should categorize their streams as Media or Movie so they will take priority over GameMedia streams. Game audio for in-game cinematics or cutscenes, when the audio is premixed or for creative reasons should take priority over background audio, should also be categorized as Media or Movie.