Getting Started with Acoustic Ray Tracing for Unreal
This section will describe the general steps for setting up Acoustic Ray Tracing. To learn all of the technical details of the library, see the API reference for each component after reading this section.
By the end of this document, you’ll be able to:
- Setup your project to use Acoustic Ray Tracing.
- Understand the general steps to hear the rendered acoustics.
- Understand the general steps to adjust the automatically generated acoustics.
Acoustic Ray Tracing is a new feature set within the existing Meta XR Audio SDK. These features are automatically available when you install the Meta XR Audio SDK through the instructions per platform below:
Check your spatial audio sources
Create an empty game object in the scene and add a MetaXRAcousticGeometry component to it. This is the parent object.
Make sure Include Child Meshes in this component is checked.
Create geometry in the scene using a static mesh (for example, a .fbx file), or 3D objects such as cubes, and attach them as child objects. As a simple example, create a floor, four walls, and a ceiling.
Create a new empty object and add a MetaXRAcousticMap component to it. Ensure the transform of this object has no Scale on its transform.
Click Bake Acoustics on the MetaXRAcousticMap component. By default, this will also bake the Acoustic Geometry. Line gizmos will appear to show the acoustic mesh outline and Sphere gizmos will appear to show the acoustic precompute points in the acoustic map.
Each time any part of your game mesh object changes, click Bake Acoustics again on the acoustic mesh to keep it current with the latest geometry in the scene.
Press play to hear acoustics audio.
Make adjustments to the acoustics
Acoustic Ray Tracing will automatically analyze your game mesh and generate a default acoustic scene. If you wish to further tune the results, there are two methods to fine-tune the Reverb Level and RT60 of a given region of the game:
Acoustic Materials and
Acoustic Control Zones.
Source control integration
The Meta XR Audio SDK implements some of unreal’s built in source control functionality. If your project has source control setup and active, all Acoustic Geometry and Acoustic Map components will automatically check out their generated files after a new computation is completed.
Learn all of the specific technical details about each component related to Acoustic Ray Tracing starting with
the geometry component