KX_SoundActuator(SCA_IActuator)¶
base class — SCA_IActuator
- class KX_SoundActuator(SCA_IActuator)¶
Sound Actuator.
The
startSound
,pauseSound
andstopSound
do not require the actuator to be activated - they act instantly provided that the actuator has been activated once at least.- volume¶
The volume (gain) of the sound.
- Type
float
- time¶
The current position in the audio stream (in seconds).
- Type
float
- pitch¶
The pitch of the sound.
- Type
float
- mode¶
The operation mode of the actuator. Can be one of these constants
- Type
integer
- sound¶
The sound the actuator should play.
- Type
Audaspace factory
- is3D¶
Whether or not the actuator should be using 3D sound. (read-only)
- Type
boolean
- volume_maximum¶
The maximum gain of the sound, no matter how near it is.
- Type
float
- volume_minimum¶
The minimum gain of the sound, no matter how far it is away.
- Type
float
- distance_reference¶
The distance where the sound has a gain of 1.0.
- Type
float
- distance_maximum¶
The maximum distance at which you can hear the sound.
- Type
float
- attenuation¶
The influence factor on volume depending on distance.
- Type
float
- cone_angle_inner¶
The angle of the inner cone.
- Type
float
- cone_angle_outer¶
The angle of the outer cone.
- Type
float
- cone_volume_outer¶
The gain outside the outer cone (the gain in the outer cone will be interpolated between this value and the normal gain in the inner cone).
- Type
float
- startSound()¶
Starts the sound.
- Returns
None
- pauseSound()¶
Pauses the sound.
- Returns
None
- stopSound()¶
Stops the sound.
- Returns
None