Difference between revisions of "Sound:play"

From GiderosMobile
m (linked Sound Channel page)
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
 
'''Available since:''' Gideros 2011.6<br/>
 
'''Available since:''' Gideros 2011.6<br/>
 +
'''Class:''' [[Sound]]<br/>
 +
 
=== Description ===
 
=== Description ===
<translate><br />
+
Creates a new '''[[SoundChannel]]''' object to play the sound. By using the returned '''SoundChannel''' object, you can stop the sound and monitor the position.
Creates a new [[Special:MyLanguage/SoundChannel|SoundChannel]] object to play the sound. By using the retured [[Special:MyLanguage/SoundChannel|SoundChannel]] object,<br />
+
<syntaxhighlight lang="lua">
you can stop the sound and monitor the position.<br />
 
<br /></translate>
 
<source lang="lua">
 
 
(SoundChannel) = Sound:play(startTime,looping,paused)
 
(SoundChannel) = Sound:play(startTime,looping,paused)
</source>
+
</syntaxhighlight>
 +
 
 
=== Parameters ===
 
=== Parameters ===
'''startTime''': (number, default = 0) <translate>The initial position in milliseconds at which playback should start.</translate> <br/>
+
'''startTime''': (number, default = 0) the initial position in milliseconds at which playback should start<br/>
'''looping''': (boolean, default = false) <translate></translate> <br/>
+
'''looping''': (boolean, default = false) <br/>
'''paused''': (boolean, default = false) <translate></translate> <br/>
+
'''paused''': (boolean, default = false) <br/>
 +
 
 
=== Return values ===
 
=== Return values ===
'''Returns''' (SoundChannel) <translate>A [[Special:MyLanguage/SoundChannel|SoundChannel]] object, which you use to control the sound. This function returns [[Special:MyLanguage/nil|nil]] if you run out of available sound channels.</translate><br/>
+
'''Returns''' (SoundChannel) a SoundChannel object which you use to control the sound. This function returns ''nil'' if you run out of available sound channels<br/>
 +
 
 +
{{Sound}}

Latest revision as of 19:32, 7 January 2024

Available since: Gideros 2011.6
Class: Sound

Description

Creates a new SoundChannel object to play the sound. By using the returned SoundChannel object, you can stop the sound and monitor the position.

(SoundChannel) = Sound:play(startTime,looping,paused)

Parameters

startTime: (number, default = 0) the initial position in milliseconds at which playback should start
looping: (boolean, default = false)
paused: (boolean, default = false)

Return values

Returns (SoundChannel) a SoundChannel object which you use to control the sound. This function returns nil if you run out of available sound channels