SoundLoaderContext  - AS3

Durée, en millisecondes, de préchargement dans une mémoire tampon d’un son en flux continu avant que la diffusion ne commence.

Vous pouvez remplacer la valeur de SoundLoaderContext.bufferTime en définissant la propriété globale SoundMixer.bufferTime. La propriété SoundMixer.bufferTime affecte uniquement la durée de mise en mémoire tampon des sons en flux continu imbriqués dans un fichier SWF. Elle n’a aucune incidence sur les objets Sound créés dynamiquement (autrement dit, créés dans ActionScript).

Indique si l’application doit tenter de télécharger un fichier de régulation d’URL à partir du serveur du son chargé avant de commencer à charger ce dernier. Cette propriété s’applique si le son chargé à l’aide de la méthode Sound.load() se trouve en dehors du domaine du fichier appelant.

Définissez cette propriété sur true lorsque vous chargez un son qui se trouve en dehors du domaine du fichier appelant et que le code dans le fichier appelant requiert un accès de niveau bas pour les données du son. Référencer la propriété Sound.id3 pour extraire un objet ID3Info et appeler la méthode SoundMixer.computeSpectrum() pour extraire des échantillons audio du son chargé constituent des exemples d’accès de bas niveau. Si vous tentez d’accéder aux données audio sans régler la propriété checkPolicyFile sur true au chargement, vous risquez d’obtenir une exception SecurityError car le fichier de régulation requis n’a pas été téléchargé.

Si un accès de bas niveau aux données audio que vous chargez est inutile, il est préférable de ne pas régler checkPolicyFile sur true. La recherche d’un fichier de régulation consomme de la bande passante réseau et peut retarder le début du téléchargement. N’effectuez donc cette opération qu’en cas de nécessité.

Lorsque vous appelez Sound.load() en définissant SoundLoaderContext.checkPolicyFile sur true, Flash Player ou AIR doit télécharger un fichier de régulation d’URL approprié, ou déterminer qu’un tel fichier n’existe pas, avant de commencer à télécharger le son spécifié. Flash Player ou AIR exécute les actions suivantes, dans l’ordre indiqué, pour vérifier l’existence d’un fichier de régulation :

• Flash Player ou AIR examine les fichiers de régulation téléchargés au préalable.
• Flash Player ou AIR tente de télécharger tout fichier de régulation en attente spécifié dans les appels de Security.loadPolicyFile().
• Flash Player ou AIR tente de télécharger un fichier de régulation à partir de l’emplacement par défaut qui correspond à l’URL du son, autrement dit /crossdomain.xml sur le même serveur que URLRequest.url (l’URL du son est spécifiée dans la propriété url de l’objet URLRequest transmis à Sound.load() ou à la fonction du constructeur Sound()).

Dans tous les cas, Flash Player ou AIR requiert que le serveur du son héberge un fichier de régulation approprié et que ce fichier autorise l’accès au fichier son à URLRequest.url, sur la base de l’emplacement du fichier de régulation, et qu’il permette au domaine du fichier appelant d’accéder au son par le biais d’une ou plusieurs balises <allow-access-from>.

Si vous réglez checkPolicyFile sur true, Flash Player ouAIR attend la vérification du fichier de régulation avant de télécharger le son. Avant d’effectuer des opérations de bas niveau sur les données audio, en appelant Sound.id3 ou SoundMixer.computeSpectrum() par exemple, attendez que l’objet Sound ait déclenché les événements progress et complete.

Si vous définissez checkPolicyFile sur true et qu’il n’existe aucun fichier de régulation approprié, vous ne recevez aucun message d’erreur tant que vous n’effectuez pas d’opération nécessitant un tel fichier ; dans ce cas Flash Player ou AIR renvoie une exception SecurityError. Une fois que vous avez reçu un événement complete, vous pouvez vérifier qu’un fichier de régulation approprié a été éventuellement trouvé en extrayant la valeur de Sound.id3 d’un bloc try et en vérifiant si une exception SecurityError est renvoyée.

Servez-vous de checkPolicyFile avec précaution si vous téléchargez un son à partir d’une URL qui utilise des redirections HTTP côté serveur. Flash Player ou AIR tente d’extraire les fichiers de régulation correspondant à la propriété url de l’objet URLRequest transmis à Sound.load(). Si le fichier audio final provient d’une URL différente en raison de redirections HTTP, les fichiers de régulation initialement téléchargés peuvent ne pas être applicables à l’URL finale du son, autrement dit l’URL à prendre en compte dans les décisions relatives à la sécurité.

La solution ci-après peut vous permettre de résoudre ce problème. Après la réception d’un événement progress ou complete, vous pouvez examiner la valeur de la propriété Sound.url qui contient l’URL finale du son. Appelez ensuite la méthode Security.loadPolicyFile() en vous basant sur l’URL finale du son pour calculer l’URL du fichier de régulation. Enfin, interrogez Sound.id3 jusqu’à ce qu’aucune exception ne soit renvoyée.

Ceci ne s’applique pas au contenu dans le sandbox de l’application AIR. Le contenu dans le sandbox de l’application a toujours un accès par programmation au contenu sonore, quelle que soit son origine.

Pour plus d’informations concernant la sécurité, voir la rubrique du Pôle de développement Flash Player : Sécurité (disponible en anglais uniquement).

Informations complémentaires

Eléments de l’API associés

Crée un objet SoundLoaderContext.

package {
    import flash.display.Sprite;
    import flash.net.URLRequest;
    import flash.media.Sound;
    import flash.media.SoundLoaderContext;
    import flash.events.IOErrorEvent;
    
    public class SoundLoaderContextExample extends Sprite {

        public function SoundLoaderContextExample() {
            var snd:Sound = new Sound();
            var req:URLRequest = new URLRequest("http://av.adobe.com/podcast/csbu_dev_podcast_epi_2.mp3");
            var context:SoundLoaderContext = new SoundLoaderContext(3000, false);

            snd.load(req, context);
            snd.play();      
 
            snd.addEventListener(IOErrorEvent.IO_ERROR, errorHandler);
        }

        private function errorHandler(errorEvent:IOErrorEvent):void {
            trace("The sound could not be loaded: " + errorEvent.text);
        }

    }
}