threejs-audio

このスキルを使用する場面

ユーザーが次の内容に言及した場合は、必ずこのスキルを使用してください。

• Camera 上の AudioListener、Audio と PositionalAudio の違い、距離モデル、refDistance/maxDistance/rolloff
• 可視化バー／スペクトラム用の AudioAnalyser
• ブラウザーの自動再生ポリシーによって音声の再生開始がブロックされる場合

重要：音声とローダーの使い分け

手順	スキル
mp3/ogg バッファーをデコードする	threejs-loaders（AudioLoader）
空間再生 API	threejs-audio

トリガーとなる語句の例：

• 「PositionalAudio」「AudioListener」「AudioAnalyser」「panner」
• 「空間音声」「音量減衰」「スペクトラム」

このスキルの使用方法

1. リスナーをアタッチして、視点に合わせて頭部に関連する音声が追従するよう、カメラオブジェクトに設定します。
2. コンテキストを作成し、ブラウザーでユーザー操作を利用してロックを解除するパターンに対応させます。
3. PositionalAudio：ドキュメントに従って refDistance、maxDistance、rolloffFactor、distanceModel を設定します。
4. バッファーを読み込むには AudioLoader（threejs-loaders）を使用し、その後 positionalAudio.setBuffer を呼び出します。
5. アナライザー：例に従って listener.context.createAnalyser() の経路をオーディオグラフに接続し、パフォーマンスに注意します。
6. 更新：移動する音源に手動で追従させる場合を除き、通常、オーディオノードをフレームごとに更新する必要はありません。

examples/workflow-positional-audio.md を参照してください。

ドキュメントマップ（公式）

ドキュメントのセクション	代表的なリンク
Audio	https://threejs.org/docs/AudioListener.html
Audio	https://threejs.org/docs/Audio.html
Audio	https://threejs.org/docs/PositionalAudio.html
Audio	https://threejs.org/docs/AudioAnalyser.html

拡張リスト：references/official-sections.md。

対象範囲

• 対象範囲内： コアの Audio クラス、空間化パラメーター、アナライザーの使用概要。
• 対象範囲外： FMOD/Wwise のようなオーサリングツール。

よくある落とし穴とベストプラクティス

• 自動再生の制限を解除して AudioContext を再開するには、ユーザー操作が必要です。
• ポジショナル音源が多すぎると CPU に負荷がかかるため、音源のプール化またはオーディオの LOD を使用してください。
• ワールド単位が距離モデルの想定と一致していることを確認してください。

ドキュメントとバージョン

オーディオクラスは three.js ドキュメントの Audio にあります。バッファーのデコードには AudioLoader を使用します。threejs-loaders を参照してください。ブラウザーの Web Audio ポリシーは外部仕様ですが、AudioContext が一時停止されている場合は必ず言及してください。

エージェント回答チェックリスト

このスキルに基づいて回答する際は、次の点を優先してください。

1. 該当する場合は AudioListener、PositionalAudio、または AudioAnalyser へのリンクを提示します。
2. サウンドバッファーのファイル読み込みは threejs-loaders（AudioLoader）に委ねます。
3. コンテキストを再開するために、自動再生やユーザー操作が必要であることを説明します。
4. 距離減衰をワールド単位および threejs-objects での配置と関連付けます。
5. DAW レベルのミキシングを約束せず、three.js のオーディオの範囲内にとどめます。

参考資料

• https://threejs.org/docs/#Audio
• https://threejs.org/docs/AudioListener.html
• https://threejs.org/docs/PositionalAudio.html

キーワード

英語： audio, positional audio, listener, analyser, spatial sound, web audio, three.js

中国語： 音声、空間音声、AudioListener、PositionalAudio、Web Audio、three.js