Package	flash.events
Classe	public class SampleDataEvent
Héritage	SampleDataEvent Event Object

Version du langage:

ActionScript 3.0

Versions du moteur d'exécution:

Flash Player 10, AIR 1.5

Distribué lorsque le lecteur demande de nouvelles données audio.

Utilisez cet événement pour gérer le son généré dynamiquement. Dans cet environnement, l'objet Sound ne contient pas vraiment de données audio. Il agit en fait en tant que socket pour les données audio qui lui sont distribuées en continu par l'intermédiaire de la fonction que vous affectez à cet événement.

Dans votre fonction, vous utilisez la méthode ByteArray.writeFloat() pour écrire dans un objet ByteArray (event.data) contenant les données échantillonnées que vous souhaitez lire.

Lorsque vous appelez la méthode Sound.play(), le lecteur commence par appeler votre gestionnaire d'événement, en demandant des tranches de données contenant des échantillons audio. Le lecteur continue à envoyer des événements pendant la lecture du son jusqu'à ce que vous cessiez de fournir des données ou jusqu'à ce que la méthode SoundChannel.stop() soit appelée.

La période d'attente de l'événement varie selon les plates-formes et peut encore changer dans les futures versions de Flash Player. Plutôt que de vous appuyer sur une période d'attente spécifique, calculez-la. Pour calculer cette attente dans ActionScript, utilisez la formule : ((SampleDataEvent.position/44.1) - SoundChannelObject.position).

Fournissez entre 2 048 et 8 192 échantillons dans un objet SampleDataEvent. Pour de meilleures performances, fournissez autant d'échantillons que possible. Moins vous fournissez d'échantillons, plus il est probable que des bruits parasites se feront entendre pendant la lecture. Ce comportement varie selon les plates-formes et peut se produire dans diverses situations, par exemple lors du redimensionnement du navigateur. Vous pouvez écrire du code qui fonctionne sur une plate-forme lorsque vous fournissez uniquement 2 048 échantillons, mais ce même code peut ne pas fonctionner s'il s'exécute sur une autre plate-forme. S'il vous faut le plus court délai d'attente possible, envisagez de permettre à l'utilisateur de sélectionner la quantité de données.

Si vous fournissez moins de 2 048 échantillons, Flash Player lit les échantillons restants, puis interrompt la lecture comme s'il avait atteint la fin du fichier son, en générant un événement SoundComplete.

Vous pouvez également utiliser la méthode Sound.extract() pour extraire les données d'un objet Sound, que vous pouvez ensuite écrire dans le flux dynamique pour la lecture.

Lorsque vous utilisez cet événement avec un objet Sound, les seules autres méthodes Sound activées sont Sound.extract() et Sound.play(). L'appel à d'autres méthodes ou propriétés résulte en une exception d'appel non valide. Tous les méthodes et propriétés de l'objet SoundChannel sont toujours activées.

Consulter les exemples

Voir aussi

---

var mySound:Sound = new Sound();
function sineWaveGenerator(event:SampleDataEvent):void {
    for ( var c:int=0; c<8192; c++ ) {
        event.data.writeFloat(Math.sin((Number(c+event.position)/Math.PI/2))*0.25);
        event.data.writeFloat(Math.sin((Number(c+event.position)/Math.PI/2))*0.25);
    }
}

mySound.addEventListener(SampleDataEvent.SAMPLE_DATA,sineWaveGenerator);
mySound.play();