soundposition(
soundposition(
IDENTIFIER
)

The soundposition( function returns the current playback position (in seconds) of the specified playing sound.

Parameters

This function has one parameter:

identifier – identifier for the sound (sound must already be playing).

Description

This function returns the current playback position (in seconds) of the specified playing sound. The code below could be used to play a long sound, even minutes or hours.

    playsound "~/Sounds/2021_05_21_Interview.mp3","IDENTIFIER","Interview"

Later, this code could be used to save the current playback position.

    letfileglobal soundBookmark = soundposition("Interview"))

Still later, the controlsound statement could be used to jump back to the saved spot.

    controlsound "Position",soundBookmark

Note: The position is a floating point number, so it can be a fractional value.

See Also

- controlsound -- controls playback of a sound file.
- info("sounds") -- returns a carriage return delimited list of all currently playing sounds.
- playsound -- starts playing a sound file.
- soundduration( -- returns the duration (in seconds) of the specified playing sound.
- sounddurationhhmmss( -- returns the duration (in hours:minutes:seconds) of the specified playing sound.
- soundinfo( -- returns a dictionary that contains all of the properties of a sound.
- soundplaying( -- returns true if the specified sound is currently playing, false if it is paused or not playing at all.
- soundpositionhhmmss( -- returns the current playback position (in hours:minutes:seconds) of the specified playing sound.
- soundprogress( -- returns the progress of the played sound from 0 to 1.
- soundstatus( -- returns the status of the specified sound: stopped, playing or paused.
- soundvolume( -- returns the current volume of the specified playing sound.

History

Version | Status | Notes
10.2 | New | New in this version.