Please participate in the MPF User Survey 2018.
Config file section
|Valid in machine config files||YES|
|Valid in mode config files||YES|
|Valid in shows||YES|
This section can also be used in a show file in the
sounds: section of a step.
sound_player: section of your config is where you specify actions to perform on sounds
when MPF events are received. Additional information may be found in the
The following sections are optional in the
sound_player: section of your config. (If you don’t include them, the default will be used).
Single value, type: one of the following options: play, stop. Default:
action: setting controls what action will be performed on the specified sound. Options for
play- The specified sound will be played. Any optional parameter values will override the sound’s settings.
stop- All currently playing and queued instances of the specified sound will stopped/canceled. Any optional parameter values will be ignored as the stop action takes no parameters. There is currently no way to stop specific instances of a particular sound while leaving others playing, but that is on the list to be implemented in a future version.
stop_looping- Looping will be canceled for all currently playing instances of the specified sound (the sound will continue to play to the end of the current loop). In addition, any queued instances of the sound awaiting playback will be removed/canceled.
load- Loads the specified sound or sound pool from its source file into memory to prepare it to be played. The request is ignored if the sound is already loaded.
unload- Unloads the specified sound or sound pool from memory. All instances of the sound or sound pool will be immediately stopped. The request is ignored if the sound is not currently loaded.
Other available optional settings:¶
Several other settings may be used in the sound player to override settings specified in the
sounds: section of config files. Please refer to the sounds:
documentation for details about each setting.
When referencing sounds in the sound player, there is an alternative syntax to specify a sound when
you don’t wish to provide any additional settings. This shortcut notation is known as the “express
configuration” and for the sound player it is simply the name of the sound asset. It can be used in
both configuration files and show steps. In the config file example above,
play_sound_slingshot: slingshot_01 is an example using the express configuration (sound name
Sound behavior upon mode (or show) stop¶
When the mode or show stops that contains a
sound_player, all sounds started in that mode or
show will continue to play and stop automatically when they reach their end. Sounds that are
looping will have their looping stopped so the sound will no longer continue to loop and will stop
when they reach their end. Sounds that are pending playback and are queued will be canceled
(removed from the queue) and will not be played. If you need a sound to be stopped immediately
when a mode or show ends, you will need to add an entry in the
sound_player to trigger a stop
action based on the mode or show stop event.