Mostly Harmless

UE3:AudioComponent (UT3)

From Unreal Wiki, The Unreal Engine Documentation Site

Jump to: navigation, search
UT3 Object >> Component >> ActorComponent >> AudioComponent

Contents

Package: 
Engine
Known direct subclass:
UTAmbientSoundComponent
This class in other games:
UDK

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

[edit] Properties

[edit] Property group 'AudioComponent'

[edit] InstanceParameters

Type: array<AudioComponentParam>

Modifiers: editinline

Array of per-instance parameters for this AudioComponent.

[edit] PitchMultiplier

Type: float


Default value: 1.0

[edit] SoundCue

Type: SoundCue


[edit] VolumeMultiplier

Type: float


Default value: 1.0

[edit] Internal variables

See AudioComponent internal variables.

[edit] Structs

[edit] AudioComponentParam

Modifiers: native

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.

name ParamName 
float FloatParam 
SoundNodeWave WaveParam 

[edit] Delegates

[edit] OnAudioFinished

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

[edit] Functions

[edit] Native functions

[edit] AdjustVolume

native final function AdjustVolume (float AdjustVolumeDuration, float AdjustVolumeLevel)

This will allow one to adjust the volume of an AudioComponent on the fly

[edit] FadeIn

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 )

Parameters:

  • FadeInDuration - how long it should take to reach the FadeVolumeLevel
  • FadeVolumeLevel - the percentage of the AudioComponents's calculated volume in which to fade to

[edit] FadeOut

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 )

Parameters:

  • FadeOutDuration - how long it should take to reach the FadeVolumeLevel
  • FadeVolumeLevel - the percentage of the AudioComponents's calculated volume in which to fade to

[edit] IsPlaying

native final function bool IsPlaying ()

Returns TRUE if this component is currently playing a SoundCue.

[edit] Play

native final function Play ()


[edit] ResetToDefaults

native final function ResetToDefaults ()

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

[edit] SetFloatParameter

native final function SetFloatParameter (name InName, float InFloat)


[edit] SetWaveParameter

native final function SetWaveParameter (name InName, SoundNodeWave InWave)


[edit] Stop

native final function Stop ()


[edit] Events

[edit] OcclusionChanged

event OcclusionChanged (bool bNowOccluded)

called when OcclusionCheckInterval > 0.0 and the occlusion status changes

Personal tools