ホーム › Media.Audio › AUDIO_STREAM_CATEGORY

AUDIO_STREAM_CATEGORY

列挙型

基底型i4

メンバー 14

名前	10進	16進	説明
AudioCategory_Other	0	0x0	その他のオーディオストリームです。
AudioCategory_ForegroundOnlyMedia	1	0x1	アプリがフォアグラウンドにある場合にのみストリーミングされるメディアです。この列挙型の値は非推奨です。詳細については、「解説」セクションを参照してください。
AudioCategory_Communications	3	0x3	VOIP やチャットなどのリアルタイム通信です。
AudioCategory_Alerts	4	0x4	アラート音です。
AudioCategory_SoundEffects	5	0x5	効果音です。
AudioCategory_GameEffects	6	0x6	ゲームの効果音です。
AudioCategory_GameMedia	7	0x7	ゲームのバックグラウンドオーディオです。
AudioCategory_GameChat	8	0x8	ゲームのチャットオーディオです。AudioCategory_Communications と似ていますが、AudioCategory_GameChat は他のストリームを減衰させません。
AudioCategory_Speech	9	0x9	音声(スピーチ)です。
AudioCategory_Movie	10	0xA	セリフを含むオーディオのストリームです。
AudioCategory_Media	11	0xB	セリフを含まないオーディオのストリームです。
AudioCategory_FarFieldSpeech	12	0xC	「遠方界(ファーフィールド)」、つまりマイクから離れた場所にある音源を取り込む目的でキャプチャされたオーディオのメディアです。
AudioCategory_UniformSpeech	13	0xD	すべての Windows デバイスにおいて、キャプチャされたオーディオストリームに対して一貫した音声処理を必要とする、キャプチャ済みオーディオのメディアです。機械学習アルゴリズムを使用して音声データを処理するアプリケーションで使用されます。
AudioCategory_VoiceTyping	14	0xE	音声によるディクテーション(音声入力)を可能にする目的でキャプチャされたオーディオのメディアです。

公式ドキュメント

オーディオストリームのカテゴリを指定します。

解説(Remarks)

ストリームの種類によっては、オーディオストリームカテゴリの一部のみが有効である点に注意してください。

ストリームの種類	有効なカテゴリ
レンダーストリーム	すべてのカテゴリが有効です。
キャプチャストリーム	AudioCategory_Communications、AudioCategory_Speech、AudioCategory_Other
ループバックストリーム	AudioCategory_Other

ゲームでは、音楽ストリームを AudioCategory_GameMedia に分類してください。そうすることで、他のアプリケーションがバックグラウンドで音楽を再生した場合に、ゲーム音楽が自動的にミュートされます。音楽アプリケーションやビデオアプリケーションでは、ストリームを AudioCategory_Media または AudioCategory_Movie に分類することで、AudioCategory_GameMedia のストリームより優先されるようになります。ゲーム内のシネマティックやカットシーンのオーディオについても、オーディオが事前にミキシングされている場合や、演出上の理由でバックグラウンドオーディオより優先させるべき場合は、Media または Movie に分類してください。

AudioCategory_ForegroundOnlyMedia と AudioCategory_BackgroundCapableMedia の値は非推奨です。Windows ストアアプリの場合、これらの値は Windows 10 上で実行しても Windows 8.1 と同じように機能し続けます。ユニバーサル Windows プラットフォーム (UWP) アプリでこれらの値を使用しようとすると、コンパイルエラーおよび実行時の例外が発生します。Windows 10 SDK でビルドされた Windows デスクトップアプリケーションでこれらの値を使用すると、コンパイルエラーになります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum AUDIO_STREAM_CATEGORY : int {
    AudioCategory_Other = 0,
    AudioCategory_ForegroundOnlyMedia = 1,
    AudioCategory_Communications = 3,
    AudioCategory_Alerts = 4,
    AudioCategory_SoundEffects = 5,
    AudioCategory_GameEffects = 6,
    AudioCategory_GameMedia = 7,
    AudioCategory_GameChat = 8,
    AudioCategory_Speech = 9,
    AudioCategory_Movie = 10,
    AudioCategory_Media = 11,
    AudioCategory_FarFieldSpeech = 12,
    AudioCategory_UniformSpeech = 13,
    AudioCategory_VoiceTyping = 14
} AUDIO_STREAM_CATEGORY;

public enum AUDIO_STREAM_CATEGORY : int
{
    AudioCategory_Other = 0,
    AudioCategory_ForegroundOnlyMedia = 1,
    AudioCategory_Communications = 3,
    AudioCategory_Alerts = 4,
    AudioCategory_SoundEffects = 5,
    AudioCategory_GameEffects = 6,
    AudioCategory_GameMedia = 7,
    AudioCategory_GameChat = 8,
    AudioCategory_Speech = 9,
    AudioCategory_Movie = 10,
    AudioCategory_Media = 11,
    AudioCategory_FarFieldSpeech = 12,
    AudioCategory_UniformSpeech = 13,
    AudioCategory_VoiceTyping = 14,
}

Public Enum AUDIO_STREAM_CATEGORY As Integer
    AudioCategory_Other = 0
    AudioCategory_ForegroundOnlyMedia = 1
    AudioCategory_Communications = 3
    AudioCategory_Alerts = 4
    AudioCategory_SoundEffects = 5
    AudioCategory_GameEffects = 6
    AudioCategory_GameMedia = 7
    AudioCategory_GameChat = 8
    AudioCategory_Speech = 9
    AudioCategory_Movie = 10
    AudioCategory_Media = 11
    AudioCategory_FarFieldSpeech = 12
    AudioCategory_UniformSpeech = 13
    AudioCategory_VoiceTyping = 14
End Enum

import enum

class AUDIO_STREAM_CATEGORY(enum.IntEnum):
    AudioCategory_Other = 0
    AudioCategory_ForegroundOnlyMedia = 1
    AudioCategory_Communications = 3
    AudioCategory_Alerts = 4
    AudioCategory_SoundEffects = 5
    AudioCategory_GameEffects = 6
    AudioCategory_GameMedia = 7
    AudioCategory_GameChat = 8
    AudioCategory_Speech = 9
    AudioCategory_Movie = 10
    AudioCategory_Media = 11
    AudioCategory_FarFieldSpeech = 12
    AudioCategory_UniformSpeech = 13
    AudioCategory_VoiceTyping = 14

// AUDIO_STREAM_CATEGORY
pub const AudioCategory_Other: i32 = 0;
pub const AudioCategory_ForegroundOnlyMedia: i32 = 1;
pub const AudioCategory_Communications: i32 = 3;
pub const AudioCategory_Alerts: i32 = 4;
pub const AudioCategory_SoundEffects: i32 = 5;
pub const AudioCategory_GameEffects: i32 = 6;
pub const AudioCategory_GameMedia: i32 = 7;
pub const AudioCategory_GameChat: i32 = 8;
pub const AudioCategory_Speech: i32 = 9;
pub const AudioCategory_Movie: i32 = 10;
pub const AudioCategory_Media: i32 = 11;
pub const AudioCategory_FarFieldSpeech: i32 = 12;
pub const AudioCategory_UniformSpeech: i32 = 13;
pub const AudioCategory_VoiceTyping: i32 = 14;

// AUDIO_STREAM_CATEGORY
const (
	AudioCategory_Other int32 = 0
	AudioCategory_ForegroundOnlyMedia int32 = 1
	AudioCategory_Communications int32 = 3
	AudioCategory_Alerts int32 = 4
	AudioCategory_SoundEffects int32 = 5
	AudioCategory_GameEffects int32 = 6
	AudioCategory_GameMedia int32 = 7
	AudioCategory_GameChat int32 = 8
	AudioCategory_Speech int32 = 9
	AudioCategory_Movie int32 = 10
	AudioCategory_Media int32 = 11
	AudioCategory_FarFieldSpeech int32 = 12
	AudioCategory_UniformSpeech int32 = 13
	AudioCategory_VoiceTyping int32 = 14
)

const
  AudioCategory_Other = 0;
  AudioCategory_ForegroundOnlyMedia = 1;
  AudioCategory_Communications = 3;
  AudioCategory_Alerts = 4;
  AudioCategory_SoundEffects = 5;
  AudioCategory_GameEffects = 6;
  AudioCategory_GameMedia = 7;
  AudioCategory_GameChat = 8;
  AudioCategory_Speech = 9;
  AudioCategory_Movie = 10;
  AudioCategory_Media = 11;
  AudioCategory_FarFieldSpeech = 12;
  AudioCategory_UniformSpeech = 13;
  AudioCategory_VoiceTyping = 14;

// AUDIO_STREAM_CATEGORY
pub const AudioCategory_Other: i32 = 0;
pub const AudioCategory_ForegroundOnlyMedia: i32 = 1;
pub const AudioCategory_Communications: i32 = 3;
pub const AudioCategory_Alerts: i32 = 4;
pub const AudioCategory_SoundEffects: i32 = 5;
pub const AudioCategory_GameEffects: i32 = 6;
pub const AudioCategory_GameMedia: i32 = 7;
pub const AudioCategory_GameChat: i32 = 8;
pub const AudioCategory_Speech: i32 = 9;
pub const AudioCategory_Movie: i32 = 10;
pub const AudioCategory_Media: i32 = 11;
pub const AudioCategory_FarFieldSpeech: i32 = 12;
pub const AudioCategory_UniformSpeech: i32 = 13;
pub const AudioCategory_VoiceTyping: i32 = 14;

const
  AudioCategory_Other* = 0
  AudioCategory_ForegroundOnlyMedia* = 1
  AudioCategory_Communications* = 3
  AudioCategory_Alerts* = 4
  AudioCategory_SoundEffects* = 5
  AudioCategory_GameEffects* = 6
  AudioCategory_GameMedia* = 7
  AudioCategory_GameChat* = 8
  AudioCategory_Speech* = 9
  AudioCategory_Movie* = 10
  AudioCategory_Media* = 11
  AudioCategory_FarFieldSpeech* = 12
  AudioCategory_UniformSpeech* = 13
  AudioCategory_VoiceTyping* = 14

enum AUDIO_STREAM_CATEGORY : int {
    AudioCategory_Other = 0,
    AudioCategory_ForegroundOnlyMedia = 1,
    AudioCategory_Communications = 3,
    AudioCategory_Alerts = 4,
    AudioCategory_SoundEffects = 5,
    AudioCategory_GameEffects = 6,
    AudioCategory_GameMedia = 7,
    AudioCategory_GameChat = 8,
    AudioCategory_Speech = 9,
    AudioCategory_Movie = 10,
    AudioCategory_Media = 11,
    AudioCategory_FarFieldSpeech = 12,
    AudioCategory_UniformSpeech = 13,
    AudioCategory_VoiceTyping = 14,
}

#define global AudioCategory_Other               0x0
#define global AudioCategory_ForegroundOnlyMedia 0x1
#define global AudioCategory_Communications      0x3
#define global AudioCategory_Alerts              0x4
#define global AudioCategory_SoundEffects        0x5
#define global AudioCategory_GameEffects         0x6
#define global AudioCategory_GameMedia           0x7
#define global AudioCategory_GameChat            0x8
#define global AudioCategory_Speech              0x9
#define global AudioCategory_Movie               0xA
#define global AudioCategory_Media               0xB
#define global AudioCategory_FarFieldSpeech      0xC
#define global AudioCategory_UniformSpeech       0xD
#define global AudioCategory_VoiceTyping         0xE