User Tools

Site Tools


play_sound

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Last revisionBoth sides next revision
play_sound [2024/01/31 19:42] justinplay_sound [2024/01/31 22:19] 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:====
Line 10: Line 10:
  
 ^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|.|[[Boolean]]|No| +|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|.|[[Number]]|No|+|interval|Interval of time to wait between each playing of the [[sound|sound effect]] (only applicable when the loop argument is true).|[[Number]]|No|
  
 ^Return Value^Description^Type^ ^Return Value^Description^Type^
-|Sound ID|Returns a unique numeric ID that can be used for referencing the sound later (e.g. to stop a looping sound via the [[Stop Sound]] function.|[[Number]]|+|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 23: Line 23:
 ====Example:==== ====Example:====
 <code bauxite> <code bauxite>
-play_sound("alarm", true, 1);+play_sound("alarm.wav", true, 1);
 </code> </code>
-//Results:// Plays the [[sound|sound effect]] named "alarm" once every second until stopped.+//Results:// Plays the [[sound|sound effect]] named "alarm.wav" once every second until stopped.
  
 <WRAP center round tip 100%> <WRAP center round tip 100%>
play_sound.txt · Last modified: 2024/01/31 22:20 by justin