FSoundOcclusionMaterial
FSoundOcclusion — the one occlusion law every sound in the engine obeys: world sources, proximity voice, radio speakers and AI hearing all ask it. Before it there were three, with their own constants, and a comment in the voice code claiming they agreed. They did not, which is exactly how a player ends up hearing a friend through a door the creature on the other side of it cannot — the one thing the co-op design cannot afford.
- Module
- Audio
- Header
#include "Audio/SoundOcclusion.h"- Namespace
Mowo
The law is keyed by the MATERIAL a ray crosses, not by a per-source knob: every hit resolves an ESurfaceType already (footsteps pick their cue from it), so a level authored for footsteps is authored for occlusion too. A thin partition costs -9 dB and pulls the low-pass to 2.5 kHz, a thick wall -18 dB and 900 Hz. Several walls along one ray SUM in dB and take the darkest cutoff — filtering alone would leave a blocked source as loud as an open one, which is the giveaway that the wall is not really there.
The table lives in data: Config/Engine.ini under audio.occlusion.<Surface> (db, cutoff_hz), editable on Project Settings > Audio. A portal (a door, a hatch) is the place for an authored exception, not the material table.
Properties
| Type | Name | Description |
|---|---|---|
float | attenuationDb | Default -9.0f. |
float | cutoffHz | Default 2500.0f. |