S > Sound (objet)

Sound (objet)

L'objet Sound vous permet de contrôler le son dans une animation. Vous pouvez ajouter des sons à un clip à partir de la bibliothèque pendant la lecture de l'animation et contrôler ces sons. Si vous ne spécifiez pas de cible (cible) lorsque vous créez un nouvel objet Sound, vous pouvez utiliser les méthodes pour contrôler le son de toute l'animation. Vous devez utiliser le constructeur new Sound pour créer une occurrence de l'objet Sound avant d'en appeler les méthodes.

L'objet Sound est supporté par Flash Player 5 et Flash Player 6.

 
Méthodes de l'objet Sound

Méthode	Description
Sound.attachSound	Attache le son spécifié dans le paramètre.
Sound.getBytesLoaded	Renvoie le nombre d'octets chargés pour le son spécifié.
Sound.getBytesTotal	Renvoie la taille du son, en octets.
Sound.getPan	Renvoie la valeur de l'appel setPan précédent.
Sound.getTransform	Renvoie la valeur de l'appel setTransform précédent.
Sound.getVolume	Renvoie la valeur de l'appel setVolume précédent.
Sound.loadSound	Charge un fichier MP3 dans Flash Player.
Sound.setPan	Définit la balance gauche/droite du son.
Sound.setTransform	Définit la quantité de chaque canal, gauche et droite, à lire dans chaque haut-parleur.
Sound.setVolume	Définit le niveau du volume pour un son.
Sound.start	Démarre la lecture d'un son depuis le début ou, en option, depuis un point défini dans le paramètre.
Sound.stop	Arrête le son spécifié ou tous les sons en cours de lecture.

 
Propriétés de l'objet Sound

Propriété	Description
Sound.duration	Durée d'un son, en millisecondes.
Sound.position	Nombre de millisecondes de lecture du son.

 
Gestionnaires d'événement de l'objet Sound

Méthode	Description
Sound.onLoad	Invoqué au chargement d'un son.
Sound.onSoundComplete	Invoqué à la fin de la lecture d'un son.

 
Constructeur pour l'objet Sound

Disponibilité

Flash Player 5.

Usage

new Sound([cible])

Paramètres

cible L'occurrence de clip sur laquelle agit l'objet Sound. Ce paramètre est facultatif.

Renvoie

Rien.

Description

Constructeur ; crée un nouvel objet Sound pour un clip spécifié. Si vous ne spécifiez pas d'occurrence cible, l'objet Sound contrôle tous les sons de l'animation.

Exemple

L'exemple suivant crée une nouvelle occurrence de l'objet Sound appelé sonGlobal. La deuxième ligne appelle la méthode setVolume et règle le volume de tous les sons de l'animation à 50 %.

sonGlobal = new Sound();
sonGlobal.setVolume(50);

L'exemple suivant crée une nouvelle occurrence de l'objet Sound, lui transmet le clip cible monAnimation et appelle la méthode start, qui démarre tous les sons de monAnimation.

sonDanimation = new Sound(monAnimation);
sonDanimation.start();