4D Doc Center : JOUER SON

4D v14.3

JOUER SON


JOUER SON ( nomObjet {; canal} )

Paramètre	Type	Description
nomObjet	Chaîne	Nom de fichier son ou son système Chaîne vide pour stopper un son asynchrone
canal	Entier long	Si passé : canal de sortie et exécution asynchrone, si omis : exécution synchrone

Description

La commande JOUER SON vous permet de jouer des fichiers de son ou multimedia. Sous Mac OS, la commande permet également de jouer un son système.

Pour jouer un fichier, passez son nom et son chemin d'accès dans nomObjet. Vous pouvez passer un chemin d'accès complet ou relatif au fichier de structure de la base.
Les principaux formats de fichiers son et multimedia sont pris en charge : .WAV, .MP3, .AVI, .AIFF (Mac OS)... Sous Mac OS, la commande prend notamment en charge les formats Core Audio.
Note : Vous ne pouvez pas jouer des fichiers ou des objets multimédia en mode asynchrone. Pour cela, utilisez les services OLE.
(Mac OS uniquement) Pour jouer un son système, passez directement son nom dans le paramètre nomObjet.

Le paramètre canal spécifie le canal de sortie de synthétiseur Macintosh. Si le canal n'est pas spécifié, le canal est utilisé pour des sons digitalisés simples et est synchrone. Synchrone signifie que tous les traitements s'arrêtent jusqu'à ce que le son soit entièrement joué. Si canal est égal à 0, le canal est utilisé pour des sons digitalisés simples et est asynchrone. Asynchrone signifie que le traitement ne s'arrête pas et que le son est joué en tâche de fond.

Pour stopper un son synchrone, il faut exécuter l'instruction suivante :

JOUER SON("";0)

Exemple 1

L'exemple suivant montre comment jouer un fichier vidéo de votre choix sous Windows :

 $DocRéf :=Ouvrir document("";"AVI")

 Si(OK=1)

    FERMER DOCUMENT($DocRéf)

    JOUER SON(Document)

 Fin de si

Exemple 2

L'exemple suivant se trouve dans une méthode de démarrage. Ce son est joué lors de l'ouverture de la base sous Mac OS :

JOUER SON("Bienvenue") ` Jouer le son de bienvenue