SoundLoaderContext  - AS3

Il numero di millisecondi per precaricare l'audio in streaming in un buffer prima dell'avvio dello streaming.

Non è possibile sostituire il valore di SoundLoaderContext.bufferTime impostando la proprietà globale SoundMixer.bufferTime. La proprietà SoundMixer.bufferTime incide sul tempo di bufferizzazione dell'audio in streaming incorporato in un file SWF ed è indipendente dagli oggetti Sound creati in modo dinamico (ovvero gli oggetti Sound creati in ActionScript).

Specifica se l'applicazione deve tentare di scaricare un file di criteri URL dal server su cui carica l'audio prima di iniziare il caricamento. Questa proprietà è valida per l'audio caricato all'esterno del dominio del file che effettua la chiamata mediante il metodo Sound.load().

Impostate questa proprietà su true quando caricate audio dall'esterno del dominio del file che esegue la chiamata e il codice nel file che esegue la chiamata richiede un accesso di basso livello ai dati audio. Esempi di accesso di basso livello ai dati audio comprendono il riferimento alla proprietà Sound.id3 per ottenere un oggetto ID3Info o la chiamata del metodo SoundMixer.computeSpectrum() per ottenere il campionamento audio dal suono caricato. Se si tenta di accedere ai dati audio senza impostare la proprietà checkPolicyFile su true al momento del caricamento, può verificarsi un'eccezione SecurityError perché il file di criteri necessario non è stato scaricato.

Se l'accesso di basso livello ai dati audio da caricare non è necessario, evitare di impostare checkPolicyFile su true. Il controllo della presenza di un file di criteri richiede una notevole ampiezza di banda e potrebbe ritardare l'avvio dello scaricamento; pertanto, deve essere eseguito solo quando è necessario.

Se chiamate Sound.load() con SoundLoaderContext.checkPolicyFile impostato su true, Flash Player o AIR deve scaricare correttamente un file di criteri URL appropriato o determinare l'inesistenza di tale file prima di iniziare a scaricare il file audio specificato. Per verificare l'esistenza di un file di criteri, Flash Player o AIR esegue le seguenti operazioni, nell'ordine:

• Flash Player o AIR prende in considerazione i file dei criteri che sono già stati scaricati.
• Flash Player o AIR cerca di scaricare gli eventuali file dei criteri in attesa specificati nelle chiamate a Security.loadPolicyFile().
• Flash Player o AIR cerca di scaricare un file di criteri dal percorso predefinito che corrisponde all'URL del file audio, ovvero /crossdomain.xml sullo stesso server di URLRequest.url. (L'URL del file audio è specificato nella proprietà url dell'oggetto URLRequest passato a Sound.load() o alla funzione di costruzione Sound).

In ogni caso, Flash Player o AIR richiede che sul server del file audio esista un file dei criteri appropriato, che questo consenta di accedere al file audio in URLRequest.url per mezzo del percorso del file dei criteri e che consenta al dominio del file che effettua la chiamata di accedere all'audio tramite uno o più tag <allow-access-from>.

Se impostate checkPolicyFile su true, Flash Player o AIR attende la verifica del file dei criteri prima di caricare l'audio. È opportuno aspettare a eseguire qualsiasi operazione di basso livello sui dati audio (ad esempio, la chiamata a Sound.id3 o SoundMixer.computeSpectrum()) fino a quando gli eventi progress e complete non vengono inviati dall'oggetto Sound.

Se impostate checkPolicyFile su true ma non viene trovato un file di criteri appropriato, l'errore viene generato solo quando si esegue un'operazione che richiede un file di criteri e, in quel caso, Flash Player o AIR genera un'eccezione SecurityError. Quando viene restituito un evento complete è possibile verificare se è stato trovato un file di criteri appropriato inserendo il valore di Sound.id3 all'interno di un blocco try per vedere se viene generata un'eccezione SecurityError.

Prestate attenzione nell'uso di checkPolicyFile in caso di scaricamento di audio da un URL che utilizza il reindirizzamento HTTP sul lato server. Flash Player o AIR tenta di recuperare i file di criteri che corrispondono alla proprietà url dell'oggetto URLRequest passato a Sound.load(). Se il file audio finale proviene da un URL diverso per via del reindirizzamento HTTP, i file di criteri scaricati all'inizio potrebbero non essere validi per l'URL del file audio finale, che è quello fondamentale nelle decisioni relative alla sicurezza.

Nel caso in cui si verifichi questa eventualità, di seguito è illustrata una possibile soluzione. Quando si riceve un evento progress o complete, è possibile esaminare il valore della proprietà Sound.url, che contiene l'URL finale del file audio. A questo punto, chiamate il metodo Security.loadPolicyFile() con un URL del file di criteri calcolato in base all'URL finale del file audio. Infine, eseguite il polling del valore di Sound.id3 fino a quando non vengono più generate eccezioni.

Ciò non vale per il contenuto presente nella funzione di sicurezza sandbox dell'applicazione AIR. Il contenuto presente nella funzione di sicurezza sandbox ha sempre accesso a livello di codice al contenuto audio, a prescindere dall'origine.

Per ulteriori informazioni sulla sicurezza, vedete l'argomento sulla sicurezza nel Centro per sviluppatori di Flash Player .

Altre informazioni

Elementi API correlati

Crea un nuovo oggetto 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);
        }

    }
}