トラブルシューティング
以下の各セクションは、聞こえる症状から始めて、よくある原因を可能性の高い順に挙げ、それぞれを説明しているページにリンクしています。
音が出ない
何も再生されない
- オーディオがロックされている。 ブラウザーは、ユーザーがページをクリックまたはタップするまで、オーディオをオフにしています。それより前に再生したサウンドは最初のクリックで始まります。キー入力は操作として認められません。自動再生とユーザー操作を参照してください。
- アプリケーションにサウンドシステムがない。
AppBaseから構築するエンジンアプリには、SoundManager、SoundComponentSystem、AudioHandlerが必要です。システムがないと、addComponent('sound')はnullを返し、entity.soundはundefinedになります。ハンドラーがないと、アセットはNo resource handler for asset type: 'audio'で失敗します。サウンドマネージャーがないと、Audio manager has no audio contextで失敗します。アプリケーションのセットアップを参照してください。 - 音量が0になっている。 マスター音量と、コンポーネントおよびスロットの音量を確認してください。保存されたミュート設定は見落としがちです。
- スマートフォンが消音モードになっている。 iPhoneでは、着信/サイレントスイッチが消音モードになっている間、Web Audioは音が出ません。スマートフォンとタブレットを参照してください。
特定のサウンドが再生されない
- スロット名が間違っている。 コンポーネントにない名前を指定すると、
play()はnullを返します。名前は大文字と小文字を区別します。 - コンポーネントまたはそのエンティティが無効になっている。
play()は何もせず、nullを返します。有効化と無効化を参照してください。 - スロットにアセットがないか、アセットの読み込みに失敗しています。アセットの
errorイベントをリッスンしてください。ブラウザーがデコードできないファイルは、Unable to decode audio dataで失敗します。 - ブラウザーがそのフォーマットをデコードできない。 あるブラウザーでは再生され、別のブラウザーでは再生されないサウンドは、たいてい後者がサポートしていないフォーマットです。サポートされているフォーマットを参照してください。
- アセットの種類が認識されていない。 Web Componentsでは、
<pc-asset>が拡張子からオーディオとして認識するのは.mp3ファイルだけです。ほかのフォーマットにはtype="audio"を指定してください。 - 距離が遠すぎる。 リニア距離モデルでは、
maxDistanceより遠くにあるポジショナルサウンドは無音になります。次のセクションを参照してください。
ポジショナルサウンド
サウンドが聞こえない、または小さすぎる
- ポジショナルにすべきでないサウンドがポジショナルになっている。 Soundコンポーネントはデフォルトでポジショナルです。ポジショナルなコンポーネントで音楽やインターフェースのサウンドを再生すると、カメラがそのエンティティから離れるにつれて音が小さくなります。Positionalをオフにしてください。ポジショナルサウンドと非ポジショナルサウンドを参照してください。
- リスナーが想定した位置にない。 オーディオリスナーがない場合、サウンドはカメラの位置ではなく、ワールドの原点で聞いた音になります。複数ある場合は、最後に有効にしたリスナーだけが使われます。リスナーを無効にしても、サウンドはそのリスナーが最後にあった位置で聞いた音のままです。オーディオリスナーを参照してください。
- 音源が
maxDistanceより遠くにある。 リニアモデルでは、サウンドはmaxDistance以遠で無音になります。
サウンドが距離によって減衰しない
maxDistanceのデフォルトは10,000です。この値ではサウンドの減衰が非常に緩やかになり、まったく減衰していないように聞こえます。maxDistanceをサウンドが無音になるべき距離に設定するか、インバース距離モデルを使用してください。距離を参照してください。
サウンドがスピーカー間を移動しない
- コンポーネントがポジショナルになっていない。 パンニングされるのはポジショナルサウンドだけです。
- リスナーがサウンドと同じエンティティにあるか、サウンドと一緒に動くエンティティにあります。リスナーの位置にあるサウンドは、常に中央から聞こえます。
- サウンドが前または後ろにある。 サウンドは左右にしかパンニングされないので、前から後ろへ移動するサウンドは変化しません。パンニングを参照してください。
再生
サウンドが互いを打ち切る
スロットは一度に1つのサウンドしか再生しないので、もう一度再生すると最初から再生し直します。銃声や足音のように重ねて鳴らしたいサウンドでは、Overlapをオンにしてください。サウンドのオーバーラップを参照してください。
エンティティを破棄した後もサウンドが鳴り続ける
オーバーラップするスロットのサウンドは、エンティティを破棄または無効にしても、最後まで再生されます。エンティティを破棄する前にスロットを停止するか、Overlapをオフにしてください。
音量やピッチを変更しても何も変わらない
オーバーラップするスロットでは、volume、pitch、startTime、durationの変更は、すでに再生中のサウンドではなく、次の再生から適用されます。Soundコンポーネントのvolumeとpitchも同じです。再生中のサウンドを変更するには、そのサウンドインスタンスでプロパティを設定します。
最初のクリックでサウンドが一斉に鳴る
オーディオがロックされている間に再生したワンショットサウンドは、ロックが解除されたときに一斉に始まります。オーディオコンテキストが実行中でない間は、ワンショットサウンドを再生しないようにしてください。ロック中に再生したサウンドを参照してください。
最初の再生だけサウンドが遅れる
アセットがまだ読み込まれていませんでした。アセットの準備ができる前に再生したスロットは、ファイルのダウンロードとデコードが終わってから再生されます。アセットをプリロードするか、必要になる前に読み込んでください。オーディオが読み込まれるタイミングを参照してください。
ループに途切れやクリックノイズがある
エンジンは途切れなくループするので、途切れの原因はファイルにあります。ファイルの両端に無音があるか、音楽的な区切りでカットされていないループです。シームレスなループを参照してください。
endイベントが発火しない
- サウンドがループしている。 ループするサウンドは終わりに達しません。
- サウンドが停止された。 停止されたサウンドは、
endではなくstopを発火します。どちらの場合にも処理を行うには、stopをリッスンしてください。 - 古いインスタンスでリッスンしていた。 再生するたびに、新しいサウンドインスタンスが作成されます。代わりに、再生のたびにイベントを発火するスロットまたはコンポーネントでリッスンしてください。
エフェクト
エフェクトをクリアするとエラーになる
clearExternalNodes()は、すでにクリアされたスロットとノードを共有しているスロットで呼び出すと、InvalidAccessErrorをスローします。ノードを共有しているスロットはクリアしないでください。エフェクトの共有を参照してください。
エフェクトが効かない
- ノード同士が接続されていない。
setExternalNodes()に2つのノードを渡すと、エンジンはサウンドを最初のノードに接続し、最後のノードをスピーカーに接続します。その間の接続は、自分で行う必要があります。 - ノードが別のオーディオコンテキストで作成されている。 ノードは
app.systems.sound.contextから作成してください。 - スロットがオーバーラップする。 オーバーラップするスロットに設定したノードは、次の再生から適用されます。
メモリ
オーディオが大量のメモリを使う
読み込んだサウンドはすべて、ファイルがどれほど小さくても、デコードされた状態でメモリに保持されます。その量は、モノラルのオーディオ1分あたり約11MBです。効果音にはモノラルを使い、長い曲を読み込む代わりに音楽の短い区間をループさせ、使い終わったアセットはアンロードしてください。メモリを参照してください。
関連情報
- 自動再生とユーザー操作 - オーディオがクリックを待つ理由
- オーディオアセット - フォーマット、読み込み、メモリ
- ポジショナルオーディオ - リスナーと距離モデル