# SoundActuator(Actuator)

base classes — `bpy_struct`, `Actuator`

class `bpy.types.``SoundActuator`(Actuator)

  Sound file

  `cone_inner_angle_3d`

    The angle of the inner cone

    Type: | float in [-inf, inf], default 0.0

  `cone_outer_angle_3d`

    The angle of the outer cone

    Type: | float in [-inf, inf], default 0.0

  `cone_outer_gain_3d`

    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 in [-inf, inf], default 0.0

  `distance_3d_max`

    The maximum distance at which you can hear the sound

    Type: | float in [-inf, inf], default 0.0

  `distance_3d_reference`

    The distance where the sound has a gain of 1.0

    Type: | float in [-inf, inf], default 0.0

  `gain_3d_max`

    The maximum gain of the sound, no matter how near it is

    Type: | float in [-inf, inf], default 0.0

  `gain_3d_min`

    The minimum gain of the sound, no matter how far it is away

    Type: | float in [-inf, inf], default 0.0

  `mode`

    Type: | enum in [‘PLAYSTOP’, ‘PLAYEND’, ‘LOOPSTOP’, ‘LOOPEND’, ‘LOOPBIDIRECTIONAL’, ‘LOOPBIDIRECTIONALSTOP’], default ‘PLAYSTOP’

  `pitch`

    Pitch of the sound

    Type: | float in [-inf, inf], default 0.0

  `rolloff_factor_3d`

    The influence factor on volume depending on distance

    Type: | float in [-inf, inf], default 0.0

  `sound`

    Type: | `Sound`

  `use_sound_3d`

    Enable/Disable 3D Sound

    Type: | boolean, default False

  `volume`

    Initial volume of the sound

    Type: | float in [0, 2], default 0.0

Inherited Properties

`bpy_struct.id_data` `Actuator.name` `Actuator.type` | `Actuator.pin` `Actuator.show_expanded` `Actuator.active`

Inherited Functions

`bpy_struct.as_pointer` `bpy_struct.driver_add` `bpy_struct.driver_remove` `bpy_struct.get` `bpy_struct.is_property_hidden` `bpy_struct.is_property_readonly` `bpy_struct.is_property_set` `bpy_struct.items` `bpy_struct.keyframe_delete` | `bpy_struct.keyframe_insert` `bpy_struct.keys` `bpy_struct.path_from_id` `bpy_struct.path_resolve` `bpy_struct.property_unset` `bpy_struct.type_recast` `bpy_struct.values` `Actuator.link` `Actuator.unlink`