KX_SoundActuator(SCA_IActuator)

base class — SCA_IActuator

class KX_SoundActuator(SCA_IActuator)

Sound Actuator.

The startSound, pauseSound and stopSound 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