sound — Play simple sounds

The sound module contains functions for playing simple sound effects on iOS.

Example:

# Play a short melody
import sound
import time

notes = 'C3', 'D3', 'E3', 'C3'
for note in notes:
    sound.play_effect('Piano_' + note)
    time.sleep(0.5)

Functions in the sound module:

sound.load_effect(name)

Preload the sound effect with the given name to reduce latency when using play_effect().

sound.play_effect(name[, volume, pitch])

Play the sound effect with the given name.

Playback is asynchronous, i.e. the function returns before the sound has finished playing. The return value is an opaque identifier that can be used with the stop_effect() function. The volume and pitch arguments are optional, by default, the effect is played with the global volume, as set by set_volume().

sound.stop_effect(effect_id)

Stops playback of a sound effect. The effect_id is the return value of play_effect().

sound.set_volume(vol)

Sets the default volume for all sound effects (between 0.0 and 1.0, the default is 0.5).