ドキュメント

Unity Engine

Unity Engine

ウェブのオーディオ

ウェブのオーディオ機能に関する情報。
読み終わるまでの所要時間 17 分最終更新 5日前

このページでは、ウェブ プラットプラットフォームのオーディオ機能に関する情報のみを提供します。Unity プロジェクトでオーディオを使用する方法については、「 オーディオの概要 」を参照してください。
Unity はプラットフォームのオーディオ管理に FMOD を使用するため、ウェブ プラットフォームでは、基本機能だけを含む限られたオーディオ機能がサポートされます。FMOD はスレッドに依存しますが、WebGL API はこれをサポートしていません。このため、Unity では、ブラウザーでオーディオの再生とミキシングを処理できる、内部の ウェブ オーディオ API に基づいた実装を使用しています。
注
Google Chromeの新しい自動再生ポリシーでは、特定の条件下でのオーディオとビデオの自動再生を禁止しています。例えば背景いる場合でも、ウェブサイ背景リックまたはタップしない限り、バックグラウンド音楽は自動的に再生されません。このポリシーを有効または使用不可にする方法の詳細については、Chromeの自動再生ポリシーに関するGoogle Chromeのドキュメントを参照してください。

サポートされるクラス

Unity ウェブは以下の API クラスをサポートします。

クラス

WebGL サポート状態

AudioSourceWebGL はいくつかの API をサポートします。サポートの詳細については、AudioSource を参照してください。
AudioListenerすべての API がサポートされています。
AudioClipWebGL はいくつかの API をサポートします。サポートの詳細については、AudioClip を参照してください。
AudioMixerWebGL はいくつかの API をサポートします。サポートの詳細については、オーディオミキサーを参照してください。
SystemInfo.supportsAudioブラウザーは WebGL のオーディオサポートを提供します。このため、
SystemInfo.supportsAudio
は常に true です。
マイクサポートされていません。

AudioSource

AudioSource API は、以下のような基本的なポジショナルオーディオ再生をサポートします。
  • 一時停止と再開
  • ロールオフ
  • ピッチ設定
  • ドップラー効果サポート
Unity WebGL は以下の AudioSource API をサポートします。

設定

説明

Clip次に再生するオーディオクリップを決定します。
dopplerLevelAudioSource のドップラーススケールを設定します。
ignoreListenerPauseAudioSource が
AudioListener.pause
を無視してオーディオの再生を継続できるようにします。
ignoreListenerVolume終了ユーザーのAudioSource音量を無視します。
isPlaying
AudioSource.clip
が再生中の場合は true を返します。
loopアプリケーションが
AudioSource.clip
をループできるようにします。
maxDistance
AudioSource.clip
の減衰が止まる、または聞こえなくなる最大距離を設定します。
minDistanceAudioSource.clip の音量が上がらなくなる最小距離を設定します。サウンドが最小距離を超えて減衰し始めます。
muteAudioSource をミュートします。
pitch
AudioSource.clip
のピッチを設定します。WebGL は正のピッチ値のみをサポートします。
playOnAwakeAwake で AudioSource を再生します。
rolloffMode距離による AudioSource の減衰を設定します。
Time (期間)再生位置を秒単位で設定します。
timeSamples再生位置をパルスコード変調(PCM)サンプルで設定します。
velocityUpdateModeAudioSource の更新を固定更新ループで行う設ます。
volumeAudioSource の音量を設定します(0.0 ~ 1.0)。
一時停止
AudioSource.clip
を一時停止します。
再生
AudioSource.clip
を再生します。
PlayDelayed秒単位で指定した遅延で
AudioSource.clip
を再生します。
PlayOneShotAudioClip を再生し、 volumeScale で AudioSource 音量をスケールします。
PlayScheduled指定した時間に AudioSource を再生します。
SetScheduledEndTimeスケジュールされた
AudioSource.clip
が終了する時間を設定します。
SetScheduledStartTimeスケジュールされた
AudioSource.clip
の開始時間を設定します。
停止:
AudioSource.clip
の再生を停止します。
UnPause一時停止中の
AudioSource.clip
の一時停止を解除します。
PlayClipAtPointワールド空間の指定された位置で
AudioSource.clip
を再生します。
注
オーディオデータはブラウザーで
decodeAudioData
でデコードされるため、オーディオファイルのランタイムサンプリングレートがシリアル化されたオーディオデータ(44100Hz)と異なる可能性があります。これは、ブラウザーが一般的にデバイスのオーディオドライバーの設定に合わせて
BaseAudioContext
サンプリングレートに一致するためです。これを考慮して、ランタイムに
AudioClip.frequency
値を検証するか、シーク操作を実行するときに
AudioSource.time
を使用することをお勧めします。

AudioClip

Unity WebGL は上級者向けのオーディオコーディング (AAC) 形式で AudioClip ファイルをインポートします。AAC 形式はほとんどのブラウザでサポートされています。Unity WebGL は以下の AudioClip API をサポートします。

プロパティ

説明

頻度クリップのサンプル頻度(単位:Hz)。
長さ:AudioClip の長さ (秒)。
loadStateAudioClip に関連付けられたデータードステートを返します。
サンプル /Samplesサンプルの AudioClip の長さ。
loadTypeクリップのロードタイプ。AudioClip のロードタイプは Inspector で設定できます。

メソッド

説明

追加情報

AudioClip.Create指定した名前と長さで AudioClip を作成します。Unity WebGL は
AudioClip.Create
を部分的にサポートしています。ブラウザは動的ストリーミングをサポートしていないため、
AudioClip.Create
を使用するにはストリームをfalseに設定します。
AudioClip.SetDataAudioSource.clip にサンプルデータを設定します。Unity WebGL は
AudioClip.SetData
を部分的にサポートしています。このメソッドは、ロードタイプが Decompress on Load に設定されている圧縮オーディオ ファイルに対してのみ使用できます。圧縮オーディオ を参照してください。
AudioClip.GetDataAudioSource.clip からサンプルデータを含む配列を取得します。Unity WebGL は
AudioClip.GetData
を部分的にサポートしています。このメソッドは、ロードタイプが Decompress on Load に設定されている圧縮オーディオ ファイルに対してのみ使用できます。圧縮オーディオ を参照してください。
注
Linux でオーディオクリップをサポートするには、ffmpeg パッケージがインストールされていることを確認してください。

オーディオループの問題

WebGL ビルドでオーディオクリップをループすると、ループでオーディオに不具合が生じる場合があります。AAC はライセンス形式であるため、Unity はホスト プラットフォームのエンコーダを使用してファイルを AAC に変換します。エンコーディング中にエンコーダが最初の 1024 サンプルを変更する場合があります。これはループの開始点に影響し、サウンドがループするときに音声に不具合が生じます。この問題に対処するには、以下を行います。
  1. ソース ファイル形式として WAV を使用します。
  2. WAV ファイルの先頭に少なくとも 1024 のサンプルの無音部分を追加します。
  3. WAV の
    smpl
    チャンクを編集し、無音を追加した後にループを開始します。

オーディオミキサー

Unity ウェブは、オーディオミキサーアセットの一部の機能をサポートします。
ウェブ上のオーディオミキサーで以下のことができます。
  • オーディオミキサー アセットを作成します。
  • 階層に AudioMixerGroups を追加します。
  • 各グループの音量を調整します。スクリプトで音量を公開または変更するには、 AudioMixer.SetFloat を使用します。
注
音量はウェブ上で変更できる唯一のプロパティです。その他のプロパティや効果音はサポートされません。

圧縮オーディオ

Unity で WebGL で圧縮オーディオを使用するには、AudioClip loadType を以下のいずれかのオプションに設定します。
これらの設定は Unity エディターでも変更できます。設定を変更するには、オーディオクリップを選択し、Inspector ウィンドウでロードタイプを任意のオプション (解凍ロード時または圧縮インメモリ) に設定します。

圧縮方法

説明

考慮事項

CompressedInMemoryディスク上のオーディオを圧縮し、アプリケーションメモリにロードした後も圧縮されたままになります。圧縮オーディオは待ち時間の原因になる可能性があり、オーディオ再生の精度は低くなります。ただし、圧縮オーディオは、解凍オーディオよりもアプリケーションのメモリ使用量が少なくなります。精度に影響されないオーディオ、例えば背景音楽には
CompressedInMemory
を使用するのがベスト プラクティスです。
DecompressOnLoadCompressedInMemory と同様にディスク上のオーディオを圧縮し、アプリケーションメモリにロードされたときに解凍します。解凍オーディオは、圧縮オーディオと比較してメモリ使用量が大幅に増えますが、待ち時間が短く、オーディオの柔軟性が向上します。精度に影響されるオーディオには
DecompressedOnLoad
を使用します (例えば、キャラクターのセリフや効果音など)。

iOS デバイスでの DecompressOnLoad に関する問題

オーディオクリップの
loadType
を
DecompressOnLoad
に設定すると、サイレント モードの iOS デバイスでクリップが聞こえない場合があります。この問題は ウェブ ビルドでのみ発生します。
ウェブオーディオシステムはブラウザーの
AudioBufferSourceNode
ノードを使用して、
DecompressOnLoad
ロードタイプのオーディオクリップをロードします。サイレントモードの iOS デバイスではサウンドは聞こえません。WebKit はこのノードタイプを
CompressedInMemory
サウンドに使用される
MediaElementSourceNode
とは異なる方法で分類するためです。
サイレント モードに関係なくオーディオを再生するには、オーディオクリップの
loadType
を
CompressedInMemory
に設定します。シーンの開始時にサウンドをロードする必要がある場合は、一時的なシーンにサウンドを完全にロードし、ターゲットシーンを追加してロードすることをお勧めします。

オーディオ再生とブラウザー セキュリティ

セキュリティ上の理由から、ブラウザーでは、終了ユーザーがマウスクリック、イベント、またはキーの押下を介してアプリケーションのウェブページを操作するまで、オーディオの再生を許可しません。ローディング画面を使用して、終了ユーザーがアプリケーションと対話し、メインコンテンツが始まる前にオーディオ再生を開始できるようにします。