To facilitate quick and accurate placement of AkAcousticPortal and AkSpatialAudioVolume actors, the Wwise Unreal integration is able to detect surrounding static mesh geometry in a scene and determine the appropriate size and location of the portals and volumes within the scene. Fit to Geometryは、複数の典型的なルーム、窓、ドア形状に対応しています。This section gives an overview of how to use Fit To Geometry for AkAcousticPortal and AkSpatialAudioVolume actors.

注記： このチュートリアルを始める前に、 Spatial Audioチュートリアルの事前準備 を完了させておいてください。

注記： Fit To Geometryが正しく機能するように、Viewport Optionsで Realtime を有効にしてください。 Viewport OptionsでRealtimeを有効にする

Fit To Geometry の前提条件

• Select the desired default collision channel inside the Integration Settings. Fit To Geometry機能は、Unreal Engineを使ってレイトレーシングを行いますが、レイが、周囲のスタティックメッシュジオメトリと交差する必要があります。Therefore, the collision channel must correspond with the collision parameters of the static mesh that the AkAcousticPortal and AkSpatialAudioVolume actors are placed within.
• If desired, individual AkAcousticPortal and AkSpatialAudioVolume actors can override the default collision channel and choose a different one. This setting is found in the Details panel for both AkAcousticPortal and AkSpatialAudioVolume actors.
• If automatic Surface Property assignment is desired, set up the Geometry Surface Properties Table in the Integration Settings. 詳細は Automatically Assigning Surface Properties to AkSpatialAudioVolumes を参照してください。

注記： Fit To Geometry機能をAkAcousticPortalアクターやAkSpatialAudioVolumeアクターで使えるのは、レベルエディタのビューポート内だけです。ブループリントエディタのビューポート内で使うことはできず、先ほどのアクター内にある個々のコンポーネント、つまりAkPortalComponent、AkSurfaceReflectorSet、AkRoomComponent、AkLateReverbに対しては、使えません。

Fit To Geometryを使い、AkSpatialAudioVolumeを配置する

• Fit To Geometryの処理は、まずAkSpatialAudioVolumeのDetailsパネルでこのオプションを有効にしたときに実行されます。オプションを有効にしたあとは、トランスフォームギズモを使ってボリュームを新しい場所に変換するたびに実行されます。
• トランスレーションギズモをドラッグすると、黄色いプレビューアウトラインが描写され、そのAkSpatialAudioVolumeが、ワールドの特定場所にどのようにフィットするかの目安が表示されます。希望するフィットが見つかるまでボリュームをドラッグしてから、マウスを離せば、このAkSpatialAudioVolumeのブラシのボリュームが更新されます。なお、Fit To Geometryの操作を実行しても、AkSpatialAudioVolumeアクターのトランスフォームは変更されず、子ブラシコンポーネントだけが変更されます。
• Fit To Geometryでは、アクターの原点から外に向かって、壁を探索するかのように球状に発せられるレイを、何本か追っていくことで成り立ちます。レイが面にヒットしたポイントは、緑色で表示されます（ヒットを無視する場合は、そのポイントは赤色です）。It can be useful to take note of where the rays hit to make sense of the resulting shape, to make sure that the correct collision channel is being used, and lastly, to make sure the correct properties are assigned to the resulting surfaces.
• 3種類の形に対応していますが、形のタイプは、AkSpatialAudioVolumeのDetailsパネルで選択します。
  1. Oriented Box - 箱型の、任意のオリエンテーションのルーム。ボックスのオリエンテーションは、Fit To Geometryの操作中に自動的に判断されます。ボックスの形は、全ての緑のヒットポイントが中に収まるような、（ボリュームが）最小限のボックスを探して計算されます。
  2. Aligned Box - 箱型の、オリエンテーションが固定されたルーム。ボックスのオリエンテーションは、ユーザーが指定します。オリエンテーションを変えるには、トランスフォームギズモを使ってAkSpatialAudioVolumeを回転させます。Aligned Boxの形は、複数の障害物があるような箱型のエリアにボリュームをフィットさせたいときに、Oriented Boxの形では不揃いになってしまうような場合に便利で、ほかにも壁と壁の間の屋外のエリアや、細道などにボックスをフィットさせたい場合にも便利です。
     • 場合によって、複数のレイトレーシングの結果、ボリュームがゼロであるAkSpatialAudioVolumeが出されることがあります。例えばヒットポイントが全て、同じ平面上にあったときなどです。そのときは、ボックスのアウトラインが赤色に点滅し、ボックスの形が更新されません。画面の左下にエラーメッセージが表示されます。この問題を解決するには、AkSpatialAudioVolumeの場所を変えて、もう一度試してみてください。
  3. Convex Polyhedron - 完全に閉ざされた、凸面の多面体の形のルーム。これが最も複雑な形で、配置時にエラーが起きやすいかもしれませんが、壁が平行でないルームなど、箱型でないルームにボリュームをフィットさせたいときなどに、時間を節約できます。なお、ルームは必ず凸面（convex）の完全に閉ざされた形状とし、開いた壁や天井などがあってはいけません。
     • 場合によって、特定の場所から発せられるレイトレーシングだけでは、閉ざされた凸面の形が見つからないことがあります。そのときは、多面体のアウトラインが赤色に点滅し、多面体の形が更新されず、画面の左下にエラーメッセージが表示されます。この問題を解決するには、AkSpatialAudioVolumeの場所を変えて、もう一度試してみてください。
• レイキャストのヒットポイントを対象に、AkSpatialAudioVolumeのDetailsパネルにあるスライダーを使ってフィルターをかけることができます。
  • 内部で、レイが長さ順に並べられ、そのうち短い方の何パーセントを計算に取り込むのかを、スライダーで設定します。
    • 例えば、スライダーを0.75に設定すると、フィット処理にレイの短い方から75が適用され、長い方から25が無視されます。
  • レイのヒットポイントのうち、計算に含まれたものは緑色、フィルターで計算から外されたものは赤色で表示されます。
  • ヒットポイントをフィルターにかける操作は、一部のレイが窓やドアから逃れるために、それらのレイのヒットポイントが原因でエラーが起きている場合などに、便利です。
  • ヒットポイントにフィルターをかけることはAligned Boxのときにおそらく一番役に立ち、理由は、レイのヒットポイントの数を減らしてもオリエンテーションの判定エラーが出ない（Aligned Boxのオリエンテーションが固定されている）ためですが、レイのフィルターは、どの形状でも使えます。

Automatically Assigning Surface Properties to AkSpatialAudioVolumes

• Surface Properties (that is Acoustic textures and Transmission Loss values) are automatically assigned to the surfaces of the AkSpatialAudioVolume based on the collision results of the ray traces performed by Fit To Geometry, and the acoustic material mapping defined in the Geometry Surface Properties Table chosen in the Integration Settings.
  • Since the result of a ray trace in the Unreal Engine yields a physical material, the table maps each physical material to surface properties.
  • AkSpatialAudioVolumeの結果としてつくられた面に、複数のレイがヒットする可能性が高く、それぞれのレイのヒットが、異なる物理マテリアルを返すこともあります。The physical material with the most hits is chosen.
  • It is possible that some rays will hit undesirable surfaces that are not representative of the properties of the resulting AkSpatialAudioVolume surface. For example, a drywall surface may have a wooden trim in some areas, but using 'drywall' for the acoustic texture representation makes more sense than 'wood' for the wall as a whole. ほとんどの場合、広い面のテキスチャに当たるヒットポイントの方が多くなり、適切なテキスチャがアサインされるはずです。If not, try translating the AkSpatialAudioVolume slightly so that the hit points move slightly, or if desired results are still not achieved, the acoustic texture can be manually assigned in the Details panel for the AkSurfaceReflectorSet component.
• It is necessary to create the desired mapping between physical materials and surface properties in the Geometry Surface Properties Table before using Fit To Geometry on an AkSpatialAudioVolume. If you change the material mapping after fitting an AkSpatialAudioVolume, its properties are not updated.

注記： Fit To Geometryでは、スタティックメッシュの個々の三角を見つけるためにUnreal EngineのComplexコリジョンを使うので、Static Meshアクターの、'Phys Material Override'プロパティにアサインされている物理マテリアルを取得することができません。This property only applies to simple collision, and will not be mapped to Surface Properties.

Fit To Geometryを使ってAkAcousticPortalを配置する

• AkSpatialAudioVolumeのときと同様に、Fit To Geometryの処理は、AkAcousticPortalのDetailsパネルで、このオプションを有効にしてから実行できます。オプションを有効にしたあとは、トランスフォームギズモを使ってこのアクターを新しい場所に変換するたびに実行されます。 -トランスレーションギズモをドラッグすると、黄色いプレビューアウトラインが描写され、そのAkAcousticPortalが、ワールドの特定場所にどのようにフィットするかの目安が表示されます。希望するフィットが見つかるまでアクターをドラッグしてから、マウスを離せば、このAkAcousticPortalが更新されます。
• Fit To Geometryは、アクターの原点から数本のレイをトレーシングすることで機能し、窓や戸口を求めて、外に向かって球状に発せられます。窓や戸口らしきものを発見すると、その面法線の方向に第2のレイを発して、窓枠または戸枠の、反対面を検知しようとします。
• ポータルは、はっきりとした「枠」があり、内向きの垂直な面がある場合に限り、ポータルとして検知されます。

左はAkAcousticPortalが検知するような開口部で、右の開口部はメッシュが薄すぎるため、検知されない。

• 検知される開口部の大きさを制限するには、Detailsパネルの中にある Detection Radius プロパティを使います。一般的な目安として、この値を、検知しようとする開口部よりは大きく、ルーム全体の寸法よりは小さく設定します。
  • デフォルト値は500なので、単位としてセンチメートルを使い、窓やドアの開口部が平均的な大きさのUnrealプロジェクトは、だいたいこれでうまくいきます。あなたのスタティックメッシュの寸法に合わせて、必要に応じて設定値を調節してください。
  • もし Detection Radius が開口部より小さければ、そのポータルは検知されません。
  • もし Detection Radius が大きすぎれば、ルームの幅全体を覆うようなポータルが、誤って検知されてしまうかもしれません。
• Collision Channel プロパティで決められたFit To Geometryのレイトレースと、コリジョンを起こしてしまうような固体のドアや窓が、ポータルにあってはいけません。それが存在すると、開口部が検知されません。開口部に窓やドアがある場合は、別のコリジョンプロファイルを使うか、Hを押してメッシュを無視させて、窓やドアが隠れるようにします。

Fit To Geometryの使い方のコツ

• レベルのAkAcousticPortalアクターやAkSpatialAudioVolumeアクターを簡単に増やすには、まず1つのアクターでFit To Geometryを有効にし、次に、このアクターのトランスレーションギズモをAltを押しながらドラッグしてアクターのコピーを作成し、そのアクターがレベル内の別の場所にフィットするようにします。
• もし家具、プロップ、電灯など、特定のスタティックメッシュアクターがFit To Geometryで実行されるレイトレースを妨害して誤った結果を引き起こしていれば、それらのアクターを隠す（Hを押下）ことで、Fit To Geometryのレイトレースがこれらを無視します。