#define SDL_HINT_AUDIO_DEVICE_STREAM_ROLE "SDL_AUDIO_DEVICE_STREAM_ROLE"
一部のオーディオバックエンド(Pipewireのような)は音声ストリームのロールに名前を付けられる. その名前は, システムコントロールパネルや, メディアの再生/録音グラフの表示や操作を行うソフトウェアで表示される.
このヒントでこの情報をOSに送ることができる. このヒントの内容は, オーディオデバイスがオープンされている間使用される. あなたのプログラムが何を再生しているか(ゲーム, 音楽, 映像, ...)を説明する記述にする必要がある.
""や設定しない場合は, SDLはデフォルトとして"Game"や, それと似た名称を使用する.
ここでのオーディオストリームはOSレベルのものであり, このヒントはSDL_AudioStreamや論理オーディオデバイスではなく, 物理オーディオデバイスに対して適用される.
Windows WASAPIオーディオの場合, 次のロールに対応しており, AUDIO_STREAM_CATEGORYに対応付けられる:
アプリケーションが自身でエコーキャンセラー, ボリュームコントロール, ノイズ除去などを適用させる場合は, SDL_HINT_AUDIO_DEVICE_RAW_STREAMも設定する必要がある.
このヒントはオーディオデバイスをオープンする前に設定する必要がある.
SDL 3.2.0以降