目次 - SDL 3.0 API(機能別) - ヒント - SDL_HINT_AUDIO_DEVICE_STREAM_NAME

SDL_HINT_AUDIO_DEVICE_STREAM_NAME

オーディオデバイス用のオーディオストリームの名前を指定するヒント

ヘッダ

SDL3/SDL_hints.h

構文

#define SDL_HINT_AUDIO_DEVICE_STREAM_NAME "SDL_AUDIO_DEVICE_STREAM_NAME"

詳細

一部のオーディオバックエンド(PulseAudioのような)はオーディオストリームに名前を付けられる. その名前は, ユーザが全てのボリュームを変えるのではなく特定のオーディオストリームのボリュームを変えるためのシステムコントロールパネルに表示される.

このヒントでこの情報をOSに送ることができる. このヒントの内容は, オーディオデバイスがオープンされている間使用される. あなたのプログラムが何を再生しているかを説明する記述にする必要がある. (多くの場合は"audio stream"で十分である. しかし, ヘッドホンで別にVoIPオーディオを再生している場合などは"team chat"のような名称の方が有用になりうる.)

""や設定しない場合は, SDLはデフォルトとして"audio stream"や, それと似た名称を使用する.

ここでのオーディオストリームはOSレベルのものであり, このヒントはSDL_AudioStreamや論理オーディオデバイスではなく, 物理オーディオデバイスに対して適用される.

このヒントはオーディオデバイスをオープンする前に設定する必要がある.

バージョン

SDL 3.2.0以降

SDL Wikiへのリンク

SDL_HINT_AUDIO_DEVICE_STREAM_NAME - SDL Wiki