Aide:SoundPlay.txt

Document original V3.3.6.1 :

###Function###
SoundPlay

###Description###
Play a sound file.

###Syntax###
SoundPlay ( "filename" [, wait] )


###Parameters###
@@ParamTable@@
filename
	Name of the file to be played (typically a WAV or MP3)
wait
	[optional] This flag determines if the script should wait for the sound to finish before continuing:
	1 = wait until sound has finished
	0 = continue script while sound is playing (default)
@@End@@

###ReturnValue###
None.  (Always returns 1 regardless of success.)


###Remarks###
Terminating the script will stop the sound (if it is still playing).
Calling SoundPlay("") can be used to stop a currently playing sound.  This has the side effect of also closing the open handle.
If you need to delete a sound file which you have played in the script, you should call SoundPlay("") first to ensure the handle is closed.


###Related###
SoundSetWaveVolume, Beep


###Example###
@@IncludeExample@@

Document traduit V3.3.6.1 :

###Function###
SoundPlay

###Description###
Joue un fichier audio.


###Syntax###
SoundPlay ( "filename" [, wait] )


###Parameters###
@@ParamTable@@
filename
	Nom du fichier à jouer (généralement un fichier WAV ou MP3)
wait
	[optionnel] Cet indicateur détermine si le script doit attendre que le son soit fini avant de poursuivre :
	1 = attendre jusqu'à ce que le son soit terminé
	0 = continuer le script tant que le son est joué (par défaut)
@@End@@


###ReturnValue###
Aucun. (Retourne toujours 1 quel que soit le résultat.)


###Remarks###
La fermeture du script stoppera le son (s'il est encore joué).
L'appel à SoundPlay ("") peut être utilisé pour arrêter un son en cours de lecture. Ceci à pour effet secondaire de fermer le handle ouvert.
Si vous avez besoin de supprimer un fichier audio que vous avez joué dans le script, vous devez utiliser SoundPlay ("") en premier afin d'être sur que le handle est fermé.


###Related###
<a href="SoundSetWaveVolume.htm">SoundSetWaveVolume</a>, <a href="Beep.htm">Beep</a>


###Example###
@@IncludeExample@@

Traducteur : TT22

Contributeurs (pour les modifications avant le Wiki) : Tlem