Devuelve el número de bytes de datos disponibles para su lectura en el búfer de entrada. El código debe llamar a la propiedad bytesAvailable para garantizar que hay datos suficientes disponibles antes de intentar leerlos con uno de los métodos read.

Indica si este objeto URLStream está conectado actualmente. Una llamada a esta propiedad devuelve true si el objeto URLStream está conectado; en caso contrario, devuelve false.

Indica el orden de bytes de los datos; los valores posibles son BIG_ENDIAN o LITTLE_ENDIAN.

El valor predeterminado es Endian.BIG_ENDIAN.

Véase también

Controla la versión del formato de mensaje de acción (AMF) utilizado al escribir o leer un objeto.

Véase también

Cierra la transmisión inmediatamente y cancela la operación de descarga. No se pueden leer datos de la transmisión después de llamar al método close().

Comienza a descargar la URL especificada en el parámetro request.

Nota: si un archivo que se está cargando contiene caracteres no ASCII (como ocurre en muchos idiomas, no así en inglés), se recomienda que guarde el archivo con codificación UTF-8 o UTF-16, en lugar de utilizar un formato no Unicode, como ASCII.

Si la operación de carga falla inmediatamente, se emite una excepción IOError o SecurityError (incluido el error de seguridad del archivo local) en la que se describe el error. En caso contrario, se distribuye un evento open si la descarga de la URL comienza correctamente, o se distribuye un evento de error si se produce un error.

Cuando utilice este método, puede ser conveniente usar el modelo de seguridad de Adobe^® Flash^® Player:

• No se permite la carga de datos si el archivo SWF que realiza la llamada se encuentra en el entorno limitado local con el sistema de archivos y el recurso se encuentra en un entorno limitado de red.
• Tampoco se permite la carga de datos si el archivo SWF que realiza la llamada se encuentra en un entorno limitado de red y el recurso de destino es local.
• De forma predeterminada, la URL de carga debe encontrarse exactamente en el mismo dominio que el archivo SWF que realiza la llamada. Por ejemplo, un archivo SWF de www.adobe.com puede cargar datos únicamente de orígenes que estén también en www.adobe.com. Para cargar datos desde un dominio distinto, coloque un archivo de política entre dominios en el servidor que aloja los datos.
• Asimismo, se puede impedir que un archivo SWF utilice este método si define el parámetro allowNetworking de las etiquetas object y embed de la página HTML que aloja el contenido SWF.

Para más información, consulte las siguientes secciones:

• El capítulo de seguridad de la guía Programación con ActionScript 3.0 y los últimos comentarios realizados en LiveDocs.
• El documento técnico sobre la seguridad de Flash Player 9.

Parámetros

Véase también

Lee un valor booleano de la transmisión. Se lee un solo byte y devuelve true si el byte es distinto de cero; en caso contrario, devuelve false.

Lee un byte con signo de la transmisión.

El valor devuelto se encuentra entre -128 y 127.

Lee bytes length de datos de la transmisión. Los bytes se leen en el objeto ByteArray especificado por bytes, iniciando bytes offset en el objeto ByteArray.

Parámetros

Lee un número de coma flotante con precisión doble IEEE 754 de la transmisión.

Lee un número de coma flotante con precisión simple IEEE 754 de la transmisión.

Lee un entero de 32 bits con signo de la transmisión.

El valor devuelto se encuentra entre -2147483648...2147483647.

Lee una cadena multibyte de longitud especificada desde la transmisión de bytes mediante el juego de caracteres especificado.

Parámetros

Lee un objeto del socket, codificado en formato de mensaje de acción (AMF).

Véase también

Lee un entero de 16 bits con signo de la transmisión.

El valor devuelto se encuentra entre -32768 y 32767.

Lee un byte sin signo de la transmisión.

El valor devuelto se encuentra entre 0 y 255.

Lee un entero de 32 bits sin signo de la transmisión.

El valor devuelto se encuentra entre 0 y 4294967295.

Lee un entero de 16 bits sin signo de la transmisión.

El valor devuelto se encuentra entre 0 y 65535.

Lee una cadena UTF-8 de la transmisión. Se da por hecho que la cadena tiene un prefijo de declaración unsigned short que indica la longitud en bytes.

Lee una secuencia de bytes length UTF-8 desde la transmisión y devuelve una cadena.

Parámetros

Se distribuye cuando los datos se han cargado correctamente.

Este evento tiene las propiedades siguientes:

Se distribuye si una llamada a URLStream.load() intenta acceder a datos sobre HTTP y si el reproductor Flash Player actual puede detectar y devolver el código de estado para la solicitud. (Es posible que algunos entornos de navegador no proporcionen esta información.) Tenga en cuenta que se enviará httpStatus (si existe) antes que (y además de) cualquier evento complete o error.

Este evento tiene las propiedades siguientes:

Véase también

Se distribuye cuando se produce un error de entrada o salida que provoca que una operación de carga se realice incorrectamente.

Este evento tiene las propiedades siguientes:

Véase también

Se distribuye cuando se inicia la operación de carga.

Este evento tiene las propiedades siguientes:

Véase también

Se distribuye al recibirse datos mientras progresa una operación de descarga. Los datos recibidos se pueden leer inmediatamente con los métodos de la clase URLStream.

Este evento tiene las propiedades siguientes:

Véase también

Se distribuye si se intenta llamar a URLStream.load() para cargar datos de un servidor situado fuera del entorno limitado de seguridad.

Este evento tiene las propiedades siguientes:

Véase también

Para ejecutar el ejemplo, coloque un archivo llamado URLStreamExample.swf en el mismo directorio que el archivo SWF.

package {
    import flash.display.Sprite;
    import flash.errors.*;
    import flash.events.*;
    import flash.net.URLRequest;
    import flash.net.URLStream;

    public class URLStreamExample extends Sprite {
        private static const ZLIB_CODE:String = "CWS";
        private var stream:URLStream;

        public function URLStreamExample() {
            stream = new URLStream();
            var request:URLRequest = new URLRequest("URLStreamExample.swf");
            configureListeners(stream);
            try {
                stream.load(request);
            } catch (error:Error) {
                trace("Unable to load requested URL.");
            }
        }

        private function configureListeners(dispatcher:EventDispatcher):void {
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
        }

        private function parseHeader():void {
            trace("parseHeader");
            trace("isCompressed: " + isCompressed());
            trace("version: " + stream.readByte());
        }

        private function isCompressed():Boolean {
            return (stream.readUTFBytes(3) == ZLIB_CODE);
        }

        private function completeHandler(event:Event):void {
            trace("completeHandler: " + event);
            parseHeader();
        }

        private function openHandler(event:Event):void {
            trace("openHandler: " + event);
        }

        private function progressHandler(event:Event):void {
            trace("progressHandler: " + event);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

        private function httpStatusHandler(event:HTTPStatusEvent):void {
            trace("httpStatusHandler: " + event);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }
    }
}