ISoundfieldEndpoint | Unreal Engine 5.4 Documentation

API > API/Runtime > API/Runtime/AudioExtensions

References


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

Syntax

class ISoundfieldEndpoint

Remarks

Class that allows soundfield-encoded audio to be sent to an arbitrary locale. For endpoint types that support receiving our downmixed interleaved audio data directly, implement IAudioEndpoint instead.

Constructors

	Type	Name	Description
		ISoundfieldEndpoint ( int32 NumRenderCallbacksToBuffer )

Destructors

	Type	Name	Description
		~ISoundfieldEndpoint ()

Functions

Type	Name	Description
bool	EndpointRequiresCallback ()	OPTIONAL OVERRIDES: For endpoints that do not explicitly fire a timed callback to poll audio data, this should be overridden to return true, and OnAudioCallback and GetDesiredCallbackFrequency should be overridden.
float	GetDesiredCallbackPeriodicity ()	For endpoints that return true for EndpointRequiresCallback, this should return the duration between OnAudioCallback calls in seconds.
int32	GetNumPacketsBuffer ()	Returns the amount of ISoundfieldAudioPackets currently buffered for this endpoint.
int32	GetRemainderInPacketBuffer ()	Returns the amount of ISoundfieldAudioPackets that can be buffered for this endpoint before reaching capacity.
void	OnAudioCallback ( TUniquePtr< ISoundfieldAudioPacket >&& InPacket, const ISoundfieldEndpointSettingsProxy* InSettings )	For endpoints that override EndpointRequiresCallback to return true, this callback will be called every (GetDesiredNumFrames() / GetSampleRate()) seconds.
void	PollSettings ( TFunctionRef< void(const ISoundfieldEndpointSettingsProxy*)> SettingsCallback )	Use this as a thread safe way to use the current settings posted to this IAudioEndpoint.
TUniquePtr< ISoundfieldAudioPacket >	PopAudio ()	METHODS USED BY IMPLEMENTATIONS OF ISoundfieldEndpoint: This is used by the IAudioEndpoint implementation to poll buffered audio to process or send to the endpoint.
void	ProcessAudioIfNecessary ()	If this endpoint hasn't created it's own async callback thread but still requires an explicit callback, this should be called.
bool	PushAudio ( TUniquePtr< ISoundfieldAudioPacket >&& InPacket )	Push a soundfield packet to the buffer.
void	RunCallbackSynchronously ()
void	SetNewSettings ( TUniquePtr< ISoundfieldEndpointSettingsProxy >&& InNewSettings )	Post new settings for this endpoint.
void	StartRunningCallback ()	If EndpointRequiresCallback() returns true, this will be used to spawn an async thread and begin calling OnAudioCallback.
void	StopRunningCallback ()