ウェブのオーディオ
ウェブのオーディオ機能に関する情報。
読み終わるまでの所要時間 17 分最終更新 5日前
このページでは、ウェブ プラットプラットフォームのオーディオ機能に関する情報のみを提供します。Unity プロジェクトでオーディオを使用する方法については、「 オーディオの概要 」を参照してください。
Unity はプラットフォームのオーディオ管理に FMOD を使用するため、ウェブ プラットフォームでは、基本機能だけを含む限られたオーディオ機能がサポートされます。FMOD はスレッドに依存しますが、WebGL API はこれをサポートしていません。このため、Unity では、ブラウザーでオーディオの再生とミキシングを処理できる、内部の ウェブ オーディオ API に基づいた実装を使用しています。
サポートされるクラス
Unity ウェブは以下の API クラスをサポートします。
クラス | WebGL サポート状態 |
|---|---|
| AudioSource | WebGL はいくつかの API をサポートします。サポートの詳細については、AudioSource を参照してください。 |
| AudioListener | すべての API がサポートされています。 |
| AudioClip | WebGL はいくつかの API をサポートします。サポートの詳細については、AudioClip を参照してください。 |
| AudioMixer | WebGL はいくつかの API をサポートします。サポートの詳細については、オーディオミキサーを参照してください。 |
| SystemInfo.supportsAudio | ブラウザーは WebGL のオーディオサポートを提供します。このため、 |
| マイク | サポートされていません。 |
AudioSource
AudioSource API は、以下のような基本的なポジショナルオーディオ再生をサポートします。
- 一時停止と再開
- ロールオフ
- ピッチ設定
- ドップラー効果サポート
Unity WebGL は以下の AudioSource API をサポートします。
設定 | 説明 |
|---|---|
| Clip | 次に再生するオーディオクリップを決定します。 |
| dopplerLevel | AudioSource のドップラーススケールを設定します。 |
| ignoreListenerPause | AudioSource が |
| ignoreListenerVolume | 終了ユーザーのAudioSource音量を無視します。 |
| isPlaying | |
| loop | アプリケーションが |
| maxDistance | |
| minDistance | AudioSource.clip の音量が上がらなくなる最小距離を設定します。サウンドが最小距離を超えて減衰し始めます。 |
| mute | AudioSource をミュートします。 |
| pitch | |
| playOnAwake | Awake で AudioSource を再生します。 |
| rolloffMode | 距離による AudioSource の減衰を設定します。 |
| Time (期間) | 再生位置を秒単位で設定します。 |
| timeSamples | 再生位置をパルスコード変調(PCM)サンプルで設定します。 |
| velocityUpdateMode | AudioSource の更新を固定更新ループで行う設ます。 |
| volume | AudioSource の音量を設定します(0.0 ~ 1.0)。 |
| 一時停止 | |
| 再生 | |
| PlayDelayed | 秒単位で指定した遅延で |
| PlayOneShot | AudioClip を再生し、 volumeScale で AudioSource 音量をスケールします。 |
| PlayScheduled | 指定した時間に AudioSource を再生します。 |
| SetScheduledEndTime | スケジュールされた |
| SetScheduledStartTime | スケジュールされた |
| 停止: | |
| UnPause | 一時停止中の |
| PlayClipAtPoint | ワールド空間の指定された位置で |
AudioClip
Unity WebGL は上級者向けのオーディオコーディング (AAC) 形式で AudioClip ファイルをインポートします。AAC 形式はほとんどのブラウザでサポートされています。Unity WebGL は以下の AudioClip API をサポートします。
プロパティ | 説明 |
|---|---|
| 頻度 | クリップのサンプル頻度(単位:Hz)。 |
| 長さ: | AudioClip の長さ (秒)。 |
| loadState | AudioClip に関連付けられたデータードステートを返します。 |
| サンプル /Samples | サンプルの AudioClip の長さ。 |
| loadType | クリップのロードタイプ。AudioClip のロードタイプは Inspector で設定できます。 |
メソッド | 説明 | 追加情報 |
|---|---|---|
| AudioClip.Create | 指定した名前と長さで AudioClip を作成します。 | Unity WebGL は |
| AudioClip.SetData | AudioSource.clip にサンプルデータを設定します。 | Unity WebGL は |
| AudioClip.GetData | AudioSource.clip からサンプルデータを含む配列を取得します。 | Unity WebGL は |
オーディオループの問題
WebGL ビルドでオーディオクリップをループすると、ループでオーディオに不具合が生じる場合があります。AAC はライセンス形式であるため、Unity はホスト プラットフォームのエンコーダを使用してファイルを AAC に変換します。エンコーディング中にエンコーダが最初の 1024 サンプルを変更する場合があります。これはループの開始点に影響し、サウンドがループするときに音声に不具合が生じます。この問題に対処するには、以下を行います。
- ソース ファイル形式として WAV を使用します。
- WAV ファイルの先頭に少なくとも 1024 のサンプルの無音部分を追加します。
- WAV のチャンクを編集し、無音を追加した後にループを開始します。
smpl
オーディオミキサー
Unity ウェブは、オーディオミキサーアセットの一部の機能をサポートします。
ウェブ上のオーディオミキサーで以下のことができます。
- オーディオミキサー アセットを作成します。
- 階層に AudioMixerGroups を追加します。
- 各グループの音量を調整します。スクリプトで音量を公開または変更するには、 AudioMixer.SetFloat を使用します。
圧縮オーディオ
Unity で WebGL で圧縮オーディオを使用するには、AudioClip loadType を以下のいずれかのオプションに設定します。
これらの設定は Unity エディターでも変更できます。設定を変更するには、オーディオクリップを選択し、Inspector ウィンドウでロードタイプを任意のオプション (解凍ロード時または圧縮インメモリ) に設定します。
圧縮方法 | 説明 | 考慮事項 |
|---|---|---|
| CompressedInMemory | ディスク上のオーディオを圧縮し、アプリケーションメモリにロードした後も圧縮されたままになります。 | 圧縮オーディオは待ち時間の原因になる可能性があり、オーディオ再生の精度は低くなります。ただし、圧縮オーディオは、解凍オーディオよりもアプリケーションのメモリ使用量が少なくなります。精度に影響されないオーディオ、例えば背景音楽には |
| DecompressOnLoad | CompressedInMemory と同様にディスク上のオーディオを圧縮し、アプリケーションメモリにロードされたときに解凍します。 | 解凍オーディオは、圧縮オーディオと比較してメモリ使用量が大幅に増えますが、待ち時間が短く、オーディオの柔軟性が向上します。精度に影響されるオーディオには |
iOS デバイスでの DecompressOnLoad に関する問題
オーディオクリップのを に設定すると、サイレント モードの iOS デバイスでクリップが聞こえない場合があります。この問題は ウェブ ビルドでのみ発生します。
loadTypeDecompressOnLoadウェブオーディオシステムはブラウザーのノードを使用して、ロードタイプのオーディオクリップをロードします。サイレントモードの iOS デバイスではサウンドは聞こえません。WebKit はこのノードタイプを サウンドに使用される とは異なる方法で分類するためです。
AudioBufferSourceNodeDecompressOnLoadCompressedInMemoryMediaElementSourceNodeサイレント モードに関係なくオーディオを再生するには、オーディオクリップのを に設定します。シーンの開始時にサウンドをロードする必要がある場合は、一時的なシーンにサウンドを完全にロードし、ターゲットシーンを追加してロードすることをお勧めします。
loadTypeCompressedInMemoryオーディオ再生とブラウザー セキュリティ
セキュリティ上の理由から、ブラウザーでは、終了ユーザーがマウスクリック、イベント、またはキーの押下を介してアプリケーションのウェブページを操作するまで、オーディオの再生を許可しません。ローディング画面を使用して、終了ユーザーがアプリケーションと対話し、メインコンテンツが始まる前にオーディオ再生を開始できるようにします。