Overview Package Class Source Class tree Glossary
previous class      next class frames      no frames

Engine.AudioComponent

Extends
ActorComponent
Modifiers
native noexport collapsecategories hidecategories ( Object ) hidecategories ( ActorComponent ) editinlinenew

Copyright 1998-2008 Epic Games, Inc. All Rights Reserved.

Core.Object
|   
+-- Core.Component
   |   
   +-- Engine.ActorComponent
      |   
      +-- Engine.AudioComponent

Direct Known Subclasses:

UTAmbientSoundComponent

Variables Summary
floatAdjustVolumeStartTime
floatAdjustVolumeStopTime
floatAdjustVolumeTargetVolume
boolbAllowSpatialization
boolbAlwaysPlay
boolbApplyEffects
boolbAutoDestroy
boolbAutoPlay
boolbFinished
boolbIgnoreForFlushing
boolbIsMusic
boolbIsUISound
boolbNoReverb
boolbShouldRemainActiveIfDropped
boolbStopWhenOwnerDestroyed
boolbSuppressSubtitles
boolbUseOwnerLocation
boolbWasOccluded
boolbWasPlaying
vectorComponentLocation
SoundNodeCueFirstNode
floatCurrAdjustVolumeTargetVolume
floatCurrentHighFrequencyGain
vectorCurrentLocation
SoundNodeCurrentNotifyBufferFinishedHook
floatCurrentPitch
floatCurrentPitchMultiplier
intCurrentUseSeamlessLooping
intCurrentUseSpatialization
floatCurrentVoiceCenterChannelVolume
floatCurrentVoiceRadioVolume
floatCurrentVolume
floatCurrentVolumeMultiplier
floatFadeInStartTime
floatFadeInStopTime
floatFadeInTargetVolume
floatFadeOutStartTime
floatFadeOutStopTime
floatFadeOutTargetVolume
floatLastOcclusionCheckTime
pointerListener
vectorLocation
floatOcclusionCheckInterval
floatPlaybackTime
PortalVolumePortalVolume
DrawSoundRadiusComponentPreviewSoundRadius
array<byte>SoundNodeData
MapSoundNodeOffsetMap
multimap_mirrorSoundNodeResetWaveMap
floatSubtitlePriority
array<pointer>WaveInstances
AudioComponent
array<AudioComponentParam>InstanceParameters
floatPitchMultiplier
SoundCueSoundCue
floatVolumeMultiplier
Inherited Variables from Engine.ActorComponent
bAttached, bNeedsReattach, bNeedsUpdateTransform, bTickInEditor, Owner, Scene, TickGroup
Inherited Variables from Core.Component
TemplateName, TemplateOwnerClass

Structures Summary
AudioComponentParam
ParamName, FloatParam, WaveParam

Delegates Summary
delegate OnAudioFinished (AudioComponent AC)

Functions Summary
function AdjustVolume (FLOAT AdjustVolumeDuration, FLOAT AdjustVolumeLevel)
function FadeIn (FLOAT FadeInDuration, FLOAT FadeVolumeLevel)
function FadeOut (FLOAT FadeOutDuration, FLOAT FadeVolumeLevel)
functionbool IsPlaying ()
event OcclusionChanged (bool bNowOccluded))
function Play ()
function ResetToDefaults ()
function SetFloatParameter (name InName, float InFloat)
function SetWaveParameter (name InName, SoundNodeWave InWave)
function Stop ()
Inherited Functions from Engine.ActorComponent
ForceUpdate, SetComponentRBFixed, SetTickGroup


Variables Detail

AdjustVolumeStartTime Source code

var float AdjustVolumeStartTime;

AdjustVolumeStopTime Source code

var float AdjustVolumeStopTime;

AdjustVolumeTargetVolume Source code

var float AdjustVolumeTargetVolume;
This is the volume level we are adjusting to

bAllowSpatialization Source code

var bool bAllowSpatialization;
Is this audio component allowed to be spatialized?

bAlwaysPlay Source code

var native bool bAlwaysPlay;
Whether to artificially prioritise the component to play

bApplyEffects Source code

var native const bool bApplyEffects;
Whether audio effects are applied

bAutoDestroy Source code

var bool bAutoDestroy;
Auto destroy this component on completion

bAutoPlay Source code

var bool bAutoPlay;
Auto start this component on creation

bFinished Source code

var transient bool bFinished;
Whether the current component has finished playing

bIgnoreForFlushing Source code

var transient bool bIgnoreForFlushing;
If TRUE, this sound will not be stopped when flushing the audio device.

bIsMusic Source code

var transient bool bIsMusic;
Whether or not this audio component is a music clip

bIsUISound Source code

var bool bIsUISound;
Whether or not this sound plays when the game is paused in the UI

bNoReverb Source code

var transient bool bNoReverb;
Whether or not the audio component should be excluded from reverb EQ processing

bShouldRemainActiveIfDropped Source code

var bool bShouldRemainActiveIfDropped;
Whether the wave instances should remain active if they're dropped by the prioritization code. Useful for e.g. vehicle sounds that shouldn't cut out.

bStopWhenOwnerDestroyed Source code

var bool bStopWhenOwnerDestroyed;
Stop sound when owner is destroyed

bSuppressSubtitles Source code

var transient bool bSuppressSubtitles;
If true, subtitles in the sound data will be ignored.

bUseOwnerLocation Source code

var bool bUseOwnerLocation;
Spatialise to the owner's coordinates

bWasOccluded Source code

var bool bWasOccluded;
whether we were occluded the last time we checked

bWasPlaying Source code

var transient bool bWasPlaying;
Set to true when the component has resources that need cleanup

ComponentLocation Source code

var duplicatetransient native const vector ComponentLocation;

CueFirstNode Source code

var native const SoundNode CueFirstNode;

CurrAdjustVolumeTargetVolume Source code

var float CurrAdjustVolumeTargetVolume;

CurrentHighFrequencyGain Source code

var native const float CurrentHighFrequencyGain;

CurrentLocation Source code

var native const vector CurrentLocation;

CurrentNotifyBufferFinishedHook Source code

var native const SoundNode CurrentNotifyBufferFinishedHook;

CurrentPitch Source code

var native const float CurrentPitch;

CurrentPitchMultiplier Source code

var native const float CurrentPitchMultiplier;

CurrentUseSeamlessLooping Source code

var native const int CurrentUseSeamlessLooping;

CurrentUseSpatialization Source code

var native const int CurrentUseSpatialization;

CurrentVoiceCenterChannelVolume Source code

var native const float CurrentVoiceCenterChannelVolume;

CurrentVoiceRadioVolume Source code

var native const float CurrentVoiceRadioVolume;

CurrentVolume Source code

var native const float CurrentVolume;

CurrentVolumeMultiplier Source code

var native const float CurrentVolumeMultiplier;

FadeInStartTime Source code

var float FadeInStartTime;

FadeInStopTime Source code

var float FadeInStopTime;

FadeInTargetVolume Source code

var float FadeInTargetVolume;
This is the volume level we are fading to

FadeOutStartTime Source code

var float FadeOutStartTime;

FadeOutStopTime Source code

var float FadeOutStopTime;

FadeOutTargetVolume Source code

var float FadeOutTargetVolume;
This is the volume level we are fading to

LastOcclusionCheckTime Source code

var transient float LastOcclusionCheckTime;
last time we checked for occlusion

Listener Source code

var duplicatetransient native const pointer Listener;

Location Source code

var duplicatetransient native vector Location;

OcclusionCheckInterval Source code

var float OcclusionCheckInterval;
while playing, this component will check for occlusion from its closest listener every this many seconds and call OcclusionChanged() if the status changes

PlaybackTime Source code

var duplicatetransient native const float PlaybackTime;

PortalVolume Source code

var duplicatetransient native const PortalVolume PortalVolume;

PreviewSoundRadius Source code

var const DrawSoundRadiusComponent PreviewSoundRadius;

SoundNodeData Source code

var duplicatetransient native const array<byte> SoundNodeData;

SoundNodeOffsetMap Source code

var duplicatetransient native const Map SoundNodeOffsetMap;
We explicitly disregard SoundNodeOffsetMap/WaveMap/ResetWaveMap for GC as all references are already handled elsewhere and we can't NULL references anyways.

SoundNodeResetWaveMap Source code

var duplicatetransient native const multimap_mirror SoundNodeResetWaveMap;

SubtitlePriority Source code

var native float SubtitlePriority;
Used by the subtitle manager to prioritize subtitles wave instances spawned by this component.

WaveInstances Source code

var duplicatetransient native const array<pointer> WaveInstances;

AudioComponent

InstanceParameters Source code

var(AudioComponent) editinline array<AudioComponentParam> InstanceParameters;
Array of per-instance parameters for this AudioComponent.

PitchMultiplier Source code

var(AudioComponent) float PitchMultiplier;

SoundCue Source code

var(AudioComponent) SoundCue SoundCue;

VolumeMultiplier Source code

var(AudioComponent) float VolumeMultiplier;


Structures Detail

AudioComponentParam Source code

struct AudioComponentParam
{
var(AudioComponent) float FloatParam;
var(AudioComponent) name ParamName;
var(AudioComponent) SoundNodeWave WaveParam;
};
Struct used for storing one per-instance named paramter for this AudioComponent. Certain nodes in the SoundCue may reference parameters by name so they can be adjusted per-instance.


Delegates Detail

OnAudioFinished Source code

delegate OnAudioFinished ( AudioComponent AC )
called when we finish playing audio, either because it played to completion or because a Stop() call turned it off early


Functions Detail

AdjustVolume Source code

native final function AdjustVolume ( FLOAT AdjustVolumeDuration, FLOAT AdjustVolumeLevel )
This will allow one to adjust the volume of an AudioComponent on the fly

FadeIn Source code

native final function FadeIn ( FLOAT FadeInDuration, FLOAT FadeVolumeLevel )
This is called in place of "play". So you will say AudioComponent->FadeIn(). This is useful for fading in music or some constant playing sound. If FadeTime is 0.0, this is the same as calling Play() but just modifying the volume by FadeVolumeLevel. (e.g. you will play instantly but the FadeVolumeLevel will affect the AudioComponent) If FadeTime is > 0.0, this will call Play(), and then increase the volume level of this AudioCompoenent to the passed in FadeVolumeLevel over FadeInTime seconds. The VolumeLevel is MODIFYING the AudioComponent's "base" volume. (e.g. if you have an AudioComponent that is volume 1000 and you pass in .5 as your VolumeLevel then you will fade to 500 )
@param FadeInDuration how long it should take to reach the FadeVolumeLevel
@param FadeVolumeLevel the percentage of the AudioComponents's calculated volume in which to fade to

FadeOut Source code

native final function FadeOut ( FLOAT FadeOutDuration, FLOAT FadeVolumeLevel )
This is called in place of "stop". So you will say AudioComponent->FadeOut(). This is useful for fading out music or some constant playing sound. If FadeTime is 0.0, this is the same as calling Stop(). If FadeTime is > 0.0, this will decrease the volume level of this AudioCompoenent to the passed in FadeVolumeLevel over FadeInTime seconds. The VolumeLevel is MODIFYING the AudioComponent's "base" volume. (e.g. if you have an AudioComponent that is volume 1000 and you pass in .5 as your VolumeLevel then you will fade to 500 )
@param FadeOutDuration how long it should take to reach the FadeVolumeLevel
@param FadeVolumeLevel the percentage of the AudioComponents's calculated volume in which to fade to

IsPlaying Source code

native final function bool IsPlaying ( )
Returns TRUE if this component is currently playing a SoundCue.

OcclusionChanged Source code

event OcclusionChanged ( bool bNowOccluded) )
called when OcclusionCheckInterval > 0.0 and the occlusion status changes

Play Source code

native final function Play ( )

ResetToDefaults Source code

native final function ResetToDefaults ( )
stops the audio (if playing), detaches the component, and resets the component's properties to the values of its template

SetFloatParameter Source code

native final function SetFloatParameter ( name InName, float InFloat )

SetWaveParameter Source code

native final function SetWaveParameter ( name InName, SoundNodeWave InWave )

Stop Source code

native final function Stop ( )


Defaultproperties

defaultproperties
{
   bUseOwnerLocation=True
   bAllowSpatialization=True
   FadeInStopTime=-1.000000
   FadeInTargetVolume=1.000000
   FadeOutStopTime=-1.000000
   FadeOutTargetVolume=1.000000
   AdjustVolumeStopTime=-1.000000
   AdjustVolumeTargetVolume=1.000000
   CurrAdjustVolumeTargetVolume=1.000000
   VolumeMultiplier=1.000000
   PitchMultiplier=1.000000
   Name="Default__AudioComponent"
   ObjectArchetype=ActorComponent'Engine.Default__ActorComponent'
}

Overview Package Class Source Class tree Glossary
previous class      next class frames      no frames
Creation time: sk 18-3-2018 10:00:35.206 - Created with UnCodeX