unreal.SoundWaveLoadingBehavior

class unreal.SoundWaveLoadingBehavior

Bases: unreal.EnumBase

Only used when stream caching is enabled. Determines how we are going to load or retain a given audio asset. A USoundWave’s loading behavior can be overridden in the USoundWave itself, the sound wave’s USoundClass, or by cvars. The order of priority is defined as: 1) The loading behavior set on the USoundWave 2) The loading behavior set on the USoundWave’s USoundClass. 3) The loading behavior set on the nearest parent of a USoundWave’s USoundClass. 4) The loading behavior set via the au.streamcache cvars.

C++ Source:

  • Module: Engine

  • File: SoundWaveLoadingBehavior.h

FORCE_INLINE

Force all audio data for this audio asset to live outside of the cache and use the non-streaming decode pathways. Only usable if set on the USoundWave.

Type

4

INHERITED

If set on a USoundWave, use the setting defined by the USoundClass. If set on the next parent USoundClass, or the default behavior defined via the au.streamcache cvars.

Type

0

LOAD_ON_DEMAND

the first chunk of audio for this asset will not be loaded until this asset is played or primed.

Type

3

PRIME_ON_LOAD

the first chunk of audio for this asset will be loaded into the cache from disk when this asset is loaded, but may be evicted to make room for other audio if it isn’t played for a while.

Type

2

RETAIN_ON_LOAD

the first chunk of audio for this asset will be retained in the audio cache until a given USoundWave is either destroyed or USoundWave::ReleaseCompressedAudioData is called.

Type

1