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
play_sound [2024/01/31 19:42] justinplay_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:====
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 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^ ^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.1706758921.txt.gz · Last modified: 2024/01/31 19:42 by justin