play_sound
Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| play_sound [2021/04/21 18:39] – justin | play_sound [2024/01/31 22:20] (current) – justin | ||
|---|---|---|---|
| Line 2: | Line 2: | ||
| ---- | ---- | ||
| - | Plays the specified [[sound|sound effect]] once. | + | Plays the specified [[sound|sound effect]]. If the optional loop argument is set to true, the [[sound|sound effect]] will continue to play at the given interval of time (e.g. once per second) until stopped via the [[Stop Sound]] function. |
| ====Signature: | ====Signature: | ||
| <code python> | <code python> | ||
| - | play_sound(sound_name) | + | play_sound(sound_name, loop, interval) |
| </ | </ | ||
| ^Argument^Description^Type^Required^ | ^Argument^Description^Type^Required^ | ||
| - | |sound_name|Name of the sound effect to play.|[[String]]|Yes| | + | |sound_name|Name of the [[sound|sound effect]] to play.|[[String]]|Yes| |
| + | |loop|Whether or not the [[sound|sound effect]] will loop or play only once. When true, it will loop until stopped via the [[Stop Sound]] function.|[[Boolean]]|No| | ||
| + | |interval|Interval of time in seconds to wait between each playing of the [[sound|sound effect]] (only applicable when the loop argument is true).|[[Number]]|No| | ||
| + | |||
| + | ^Return Value^Description^Type^ | ||
| + | |Sound ID|Returns a unique numeric ID that can be stored for later reference (e.g. to stop a looping sound via the [[Stop Sound]] function).|[[Number]]| | ||
| <WRAP center round info 100%> | <WRAP center round info 100%> | ||
| Line 18: | Line 23: | ||
| ====Example: | ====Example: | ||
| <code bauxite> | <code bauxite> | ||
| - | play_sound(" | + | play_sound(" |
| </ | </ | ||
| - | // | + | // |
| <WRAP center round tip 100%> | <WRAP center round tip 100%> | ||
play_sound.txt · Last modified: 2024/01/31 22:20 by justin
Page Tools
