IAudioSpatialization | Unreal Engine 4.27 Documentation

Unreal Engine C++ API Reference > Runtime > AudioExtensions

Inheritance Hierarchy

References


Module	AudioExtensions
Header	/Engine/Source/Runtime/AudioExtensions/Public/IAudioExtensionPlugin.h
Include	#include "IAudioExtensionPlugin.h"

Syntax

class IAudioSpatialization

Remarks

IAudioSpatialization

This class represents instances of a plugin that will process spatialization for a stream of audio. Currently used to process a mono-stream through an HRTF spatialization algorithm into a stereo stream. This algorithm contains an audio effect assigned to every VoiceId (playing sound instance). It assumes the effect is updated in the audio engine update loop with new position information.

Destructors

	Type	Name	Description
		~IAudioSpatialization ()	Virtual destructor

Functions

Type	Name	Description
bool	CreateSpatializationEffect ( uint32 SourceId )	Creates an audio spatialization effect.
void *	GetSpatializationEffect ( uint32 SourceId )	Returns the spatialization effect for the given voice id.
void	GetSpatializationParameters ( uint32 SourceId, FSpatializationParams& OutParams )	DEPRECATED: Gets the spatialization effect parameters.
void	Initialize ( const FAudioPluginInitializationParams InitializationParams )	Initializes the spatialization plugin with the given buffer length.
void	InitializeSpatializationEffect ( uint32 BufferLength )	DEPRECATED: Initializes the spatialization effect with the given buffer length.
bool	IsSpatializationEffectInitialized ()	Returns whether or not the spatialization effect has been initialized
void	OnAllSourcesProcessed ()	Called when all sources have finished processing.
void	OnDeviceShutdown ( FAudioDevice* AudioDevice )
void	OnInitSource ( const uint32 SourceId, const FName& AudioComponentUserId, USpatializationPluginSourceSettingsBase* InSettings )	Called when a source is assigned to a voice.
void	OnReleaseSource ( const uint32 SourceId )	Called when a source is done playing and is released.
void	ProcessAudio ( const FAudioPluginSourceInputData& InputData, FAudioPluginSourceOutputData& OutputData )	Processes audio with the given input and output data structs.
void	ProcessSpatializationForVoice ( uint32 SourceId, float* InSamples, float* OutSamples )	DEPRECATED: Uses the given HRTF algorithm to spatialize a mono audio stream, assumes the parameters have already been set before processing.
void	ProcessSpatializationForVoice ( uint32 SourceId, float* InSamples, float* OutSamples, const FVector& Position )	DEPRECATED: Uses the given HRTF algorithm to spatialize a mono audio stream.
void	SetSpatializationParameters ( uint32 SourceId, const FSpatializationParams& Params )	DEPRECATED: sets the spatialization effect parameters.
void	Shutdown ()	Shuts down the audio plugin.