ドキュメント

Unity Engine

Unity Engine

オーディオ設定

AudioSettings クラスに関するリファレンス情報。
読み終わるまでの所要時間 4 分最終更新 6日前

AudioSettings クラスには、サウンドシステムに関するさまざまなグローバル情報が含まれていますが、最も重要なのは、スピーカーモード、サンプル (プラットプラットフォームでサポートされている場合)、DSP バッファサイズ、リアル/バーチャル音声数などの設定を変更するためにランタイムにオーディオシステムをリセットする API が含まれていることです。
これらの設定の多くは、プロジェクト設定のオーディオセクションでも設定できます。設定を変更すると、これらの設定はエディターとゲームの初期ステートの両方に適用されます。一方、AudioSettings API を使用して行われた変更はゲームのランタイムにのみ適用され、エディターでゲームを停止するとプロジェクト設定で定義されたステートにリセットされます。
ゲームでは、ユーザーがサウンド設定を変更できるサウンドオプションメニューが用意されている場合があります。また、外部オーディオ入力/出力デバイスや、オーディオデバイスとしても機能するHDMIモニタを接続するなど、デバイスの変更に反応して外部から変更が加えられる場合もあります。AudioConfiguration AudioSettings.GetConfiguration() / ブーリアン AudioSettings.リセット(AudioConfiguration config) API は、現在のサウンドシステム設定のグローバルな変更を読み取り適用することができ、基本的に、プロパティが変更されたときにオーディオシステム全体を再初期化するという副エフェクトがあった AudioSettings.SetDSPBufferSize(...) 機能と AudioSettings.outputSampleRate、AudioSettings.speakerMode を置き換えます。
API は AudioSettings.OnAudioConfigurationChanged(ブーリアン デバイス) を定義し、スクリプトがオーディオ設定の変更を通知できるコールバックを設定します。これらは、実際のデバイス変更またはスクリプトによって開始された設定のいずれかによって発生します。
グローバル オーディオ システム設定のランタイム変更が実行されるたびに、すべてのオーディオ オブジェクトをリロードする必要があることに注意してください。これはディスクベースの AudioClip アセットとオーディオオミキサーで動作しますが、スクリプトによって生成または変更された AudioClip は失われ、再作成する必要があります。同様に、再生ステートも失われます。そのため、AudioSettings.OnAudioConfigurationChanged(...) コールバックで再生成する必要があります。
詳細と例については、スクリプティング API リファレンス を参照してください。