Audio Area Environment Component

Using the Audio Area Environment component, you can apply environment effects to sounds that an entity triggers. You must also add a shape component to use the audio area environment component.

Audio Area Environment Properties

The Audio Area Environment component has the following properties:

Broad-phase Trigger Area Link this property to an entity that includes a trigger area and shape. This trigger area is used for broad-phase checks. The Audio Area Environment component tracks any entity that moves inside the trigger area. Default: None

Environment name The name of the Audio Translation Layer (ATL) environment to apply to entities in the area. Default: None

Environment fade distance The distance around a shape where the environment amounts will fade based on an entity’s distance from the shape. Only positive, non-zero values are valid. Default: 1.0

Using the Audio Area Environment Component

Setting up the Audio Area Environment component requires two entities. The second entity is linked to the Audio Area Environment component in the first entity, acting as a broad-phase trigger area. When these entities are configured properly, any entity that passes near or through the inner shape of the first entity will have an environment amount applied to any triggered sounds.

To set up the Audio Area Environment component

  1. In O3DE Editor, right-click the viewport in your level, and click Create new component entity.

  2. Click Tools, Entity Inspector. Be sure that your new component entity is selected in the viewport.

  3. In the Entity Inspector, click Add Component, Shape, and then select one of the shape options.

  4. Click Add Component, Audio, Audio Area Environment.

  5. Repeat steps 1 - 4 to add another entity with a Shape (any) component and a Trigger Area component (located under Scripting).

  6. Place and size the two entities so that the following conditions are met:

    • The second entity’s shape completely encompasses the first entity’s shape.
    • The second entity’s shape is larger than the first entity’s shape by at least the value for the Environment fade distance. This allows the Audio Area Environment component to track an entity’s distance from the inner shape when the entity enters the outer trigger area.
  7. (Optional) In the Entity Inspector, for the Trigger Area component, use the Tag Filters to filter entities that you don’t want the Audio Area Environment component to process.


Copyright © 2022 Open 3D Engine Contributors

Documentation Distributed under CC BY 4.0.
For our trademark, privacy and antitrust policies, code of conduct, and terms of use, please click the applicable link below or see https://www.lfprojects.org.


The Linux Foundation has registered trademarks and uses trademarks. For a list of trademarks of The Linux Foundation, please see our Trademark Policy page.