SampleDataEvent  - AS3

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

Cet événement a deux usages principaux :

• Fournir des données audio générées de façon dynamique à un objet Sound
• Obtenir des données audio pour un objet Microphone

Génération dynamique de données audio à l’aide de l’objet Sound Utilisez l’événement sampleData pour lire les données audio générées 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 diffusées en continu par l’intermédiaire de la fonction que vous affectez comme gestionnaire à cet événement sampleData.

Dans votre fonction, utilisez la méthode ByteArray.writeFloat() pour écrire dans la propriété event.data de l’événement qui contient les données échantillonnées que vous souhaitez lire.

Si un objet Sound n’a pas chargé un fichier MP3, lorsque vous appelez sa méthode play(), l’objet commence par distribuer des événements sampleData vous demandant des échantillons audio. L’objet Sound continue d’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 stop() de l’objet SoundChannel soit appelée.

Le temps d’attente de l’événement varie selon les plates-formes et peut encore changer dans les futures versions de Flash Player et AIR. Ne dépendez pas d’un temps d’attente spécifique, mais calculez-le à l’aide de ((SampleDataEvent.position/44.1) - SoundChannelObject.position).

Fournissez entre 2 048 et 8 192 échantillons à la propriété data de l’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 plateforme lorsque vous fournissez uniquement 2 048 échantillons, mais ce même code peut ne pas fonctionner s’il s’exécute sur une autre plateforme. 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, l’objet Sound 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 complete.

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

Lorsque vous utilisez l’écouteur d’événement sampleData avec un objet Sound, les uniques méthodes Sound activées sont extract() et 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.

Capture audio du microphone Utilisez l’événement sampleData pour capturer un son à partir d’un microphone. Lorsque vous ajoutez un écouteur d’événement pour l’événement sampleData, le microphone distribue l’événement à mesure que les échantillons audio deviennent disponibles.

Dans la fonction de gestionnaire d’événement, utilisez la méthode ByteArray.readFloat() pour lire la propriété data) de l’événement, qui contient les données échantillonnées. L’événement contient plusieurs échantillons ; par conséquent, vous devez utiliser une boucle while pour lire les données disponibles :

var soundBytes:ByteArray = new ByteArray();
 while(event.data.bytesAvailable)
 {
      var sample:Number = event.data.readFloat();
      soundBytes.writeFloat(sample);
 }

Consulter les exemples

Informations complémentaires

Eléments de l’API associés