AVURLStream - Referencia de la API de Adobe ActionScript® 3 (AS3 )

Paquete	flash.media
Clase	public class AVURLStream
Herencia	AVURLStream URLStream EventDispatcher Object

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

La clase URLStream proporciona acceso de bajo nivel a las URL de descarga. Los datos están disponibles en el código de la aplicación de forma inmediata mientras se descargan; no es necesario esperar a que se descargue todo el archivo, tal como ocurría con URLLoader. La clase URLStream también permite cerrar una transmisión antes de que finalice su descarga. El contenido del archivo descargado está disponible como datos binarios sin formato.

Las operaciones de lectura de URLStream son no bloqueantes. Esto quiere decir que se debe utilizar la propiedad bytesAvailable para determinar si hay suficientes datos disponibles para poder leerlos. Se emite una excepción EOFError si no hay suficientes datos disponibles.

De forma predeterminada, todos los datos binarios se codifican en formato Big-Endian, con el byte más significativo en primer lugar.

Las reglas de seguridad que se aplican a la descarga de URL con la clase URLStream son idénticas a las que se aplican a los objetos URLLoader. Se pueden descargar tantos archivos de política como sea necesario. Se reforzarán las reglas de seguridad de archivos locales y se emitirán advertencias de seguridad si es necesario.

Elementos de API relacionados

URLLoader
URLRequest

Propiedades públicas

Ocultar propiedades públicas heredadas

Mostrar propiedades públicas heredadas

	Propiedad		Definido por
		bytesAvailable : uint [solo lectura] Devuelve el número de bytes de datos disponibles para su lectura en el búfer de entrada.	URLStream
		connected : Boolean [solo lectura] Indica si este objeto URLStream está conectado actualmente.	URLStream
		constructor : Object Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.	Object
		cookieHeader : String [solo escritura]	AVURLStream
		endian : String Indica el orden de bytes de los datos.	URLStream
		objectEncoding : uint Controla la versión del formato de mensaje de acción (AMF) utilizado al escribir o leer un objeto.	URLStream

Métodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	Método		Definido por
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento.	EventDispatcher
		close():void Cierra la transmisión inmediatamente y cancela la operación de descarga.	URLStream
		dispatchEvent(event:Event):Boolean Distribuye un evento en el flujo del evento.	EventDispatcher
		hasEventListener(type:String):Boolean Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica si un objeto tiene definida una propiedad especificada.	Object
		isPrototypeOf(theClass:Object):Boolean Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.	Object
		load(request:URLRequest):void [override] Comienza a descargar la URL especificada en el parámetro request.	AVURLStream
		propertyIsEnumerable(name:String):Boolean Indica si existe la propiedad especificada y si es enumerable.	Object
		readBoolean():Boolean Lee un valor booleano de la transmisión.	URLStream
		readByte():int Lee un byte con signo del flujo.	URLStream
		readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void Lee bytes length de datos de la transmisión.	URLStream
		readDouble():Number Lee un número de coma flotante con precisión doble IEEE 754 de la transmisión.	URLStream
		readFloat():Number Lee un número de coma flotante con precisión simple IEEE 754 de la transmisión.	URLStream
		readInt():int Lee un entero de 32 bits con signo del flujo.	URLStream
		readMultiByte(length:uint, charSet:String):String Lee una cadena multibyte de longitud especificada desde la transmisión de bytes mediante el juego de caracteres especificado.	URLStream
		readObject():* Lee un objeto del socket, codificado en formato de mensaje de acción (AMF).	URLStream
		readShort():int Lee un entero de 16 bits con signo de la transmisión.	URLStream
		readUnsignedByte():uint Lee un byte sin signo de la transmisión.	URLStream
		readUnsignedInt():uint Lee un entero de 32 bits sin signo de la transmisión.	URLStream
		readUnsignedShort():uint Lee un entero de 16 bits sin signo de la transmisión.	URLStream
		readUTF():String Lee una cadena UTF-8 de la transmisión.	URLStream
		readUTFBytes(length:uint):String Lee una secuencia de bytes length UTF-8 desde la transmisión y devuelve una cadena.	URLStream
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Elimina un detector del objeto EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		toLocaleString():String Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.	Object
		toString():String Devuelve la representación de cadena del objeto especificado.	Object
		valueOf():Object Devuelve el valor simple del objeto especificado.	Object
		willTrigger(type:String):Boolean Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto.	EventDispatcher

Eventos

Haga clic para obtener más información sobre los eventos

Ocultar eventos heredados

Mostrar eventos heredados

	Resumen	Definido por
activate	[evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos.	EventDispatcher
complete	Se distribuye cuando los datos se han cargado correctamente.	URLStream
deactivate	[evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos.	EventDispatcher
httpResponseStatus	Se distribuye si una llamada al método URLStream.load() intenta acceder a los datos mediante HTTP y Adobe AIR puede detectar y devolver el código de estado de la petición.	URLStream
httpStatus	Se distribuye si una llamada a URLStream.load() intenta acceder a los datos mediante HTTP y si Flash Player o Adobe AIR pueden detectar y devolver el código de estado de la petición.	URLStream
ioError	Se distribuye cuando se produce un error de entrada o salida que provoca que una operación de carga se realice incorrectamente.	URLStream
open	Se distribuye cuando se inicia la operación de carga.	URLStream
progress	Se distribuye al recibirse datos mientras progresa una operación de descarga.	URLStream
securityError	Se distribuye si se intenta llamar a URLStream.load() para cargar datos de un servidor situado fuera del entorno limitado de seguridad.	URLStream

Información sobre propiedades

cookieHeader

propiedad

cookieHeader:String [solo escritura]

Implementación
public function set cookieHeader(value:String):void

Información sobre métodos

load

()

método

override public function load(request:URLRequest):void

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

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.

De forma predeterminada, el archivo SWF que realiza la llamada y la URL que se carga deben estar exactamente en el mismo dominio. Por ejemplo, un archivo SWF de www.adobe.com puede cargar datos únicamente de orígenes que también estén en www.adobe.com. Para cargar datos desde un dominio distinto, coloque un archivo de política URL en el servidor que aloja los datos.

En Flash Player no es posible conectarse a puertos comunes reservados. Para obtener una lista completa de los puertos bloqueados, consulte la sección “Restricción de API de red” en el Guía del desarrollador de ActionScript 3.0.

En Flash Player, 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.

En Flash Player 10 y versiones posteriores, y en AIR 1.5 y versiones posteriores, si utiliza una estructura Content-Type de varias partes (por ejemplo, "multipart/form-data") con una acción de carga (indicada por un parámetro "filename" en un encabezado "content-disposition" dentro del cuerpo POST), la operación POST está sujeta a las reglas de seguridad aplicadas a las cargas:

Es preciso realizar una operación POST como respuesta a una acción iniciada por el usuario, por ejemplo, un clic de ratón o la pulsación de una tecla.
Si la operación POST afecta a varios dominios (el destino POST no se encuentra en el mismo servidor que el archivo SWF que envía la petición POST), el servidor de destino debe proporcionar un archivo de política URL que permita el acceso a varios dominios.

Asimismo, en cualquier estructura Content-Type de varias partes, la sintaxis debe ser válida (de acuerdo con la norma RFC2046). Si la sintaxis no es válida, la operación POST está sujeta a las reglas de seguridad que se aplican a las cargas.

Estas reglas también se aplican al contenido de AIR ajeno a los entornos limitados de la aplicación. Sin embargo, en Adobe AIR, el contenido del entorno limitado de la aplicación (contenido instalado con la aplicación de AIR) no está limitado por estas restricciones de seguridad.

Para obtener más información sobre la seguridad, consulte el tema del Centro de desarrollo de Flash Player Seguridad.

En AIR, un objeto URLRequest puede registrar el evento de estado httpResponse. Al contrario que httpStatus, el evento httpResponseStatus se envía antes de cualquier dato de respuesta. Asimismo, el evento httpResponseStatus incluye valores para las propiedades responseHeaders y responseURL (que son undefined en un evento httpStatus). Tenga en cuenta que se enviará el evento httpResponseStatus (si existe) antes que (y además de) cualquier evento complete o error.

Si existe un detector de eventos httpResponseStatus, el cuerpo del mensaje de respuesta se envía siempre; las respuestas de código de estado HTTP siempre producen un evento complete. Esto se cumple a pesar de que el código de estado de la respuesta HTTP indique una finalización correcta o un error.

En AIR, si no hay detector de eventos httpResponseStatus, el comportamiento no es el mismo que el de la versión SWF:

En contenido SWF 9, el cuerpo del mensaje de respuesta HTTP se envía sólo si el código de estado de la respuesta HTTP indica que se ha realizado correctamente. En caso contrario (si se produce un error), no se envía nada y el objeto URLRequest distribuye un evento IOError.
En contenido SWF 10, el cuerpo del mensaje de respuesta HTTP se envía siempre. Si se produce un error, el objeto URLRequest distribuye un evento IOError.

Parámetros

request:URLRequest — Un objeto URLRequest que especifica la URL que se va a descargar. Si el valor de este parámetro o la propiedad URLRequest.url del objeto URLRequest transmitido es null, la aplicación emite un error de puntero nulo.

Eventos

	`complete:Event` — Se distribuye cuando los datos se han cargado correctamente. Si existe un detector de eventos `httpResponseStatus`, el objeto URLRequest también distribuye un evento `complete` si el código de estado de la respuesta HTTP indica una finalización correcta o bien si indica un error.

	`httpStatus:HTTPStatusEvent` — Si se accede a través de HTTP y el entorno actual admite la obtención de códigos de estado, es posible recibir dichos eventos además de cualquier evento `complete` o `error`.

	`httpResponseStatus:HTTPStatusEvent` — Se distribuye si una llamada al método `load()` intenta acceder a los datos mediante HTTP y Adobe AIR puede detectar y devolver el código de estado de la petición.

	`ioError:IOErrorEvent` — No se pudo completar la operación de carga.

	`open:Event` — Se distribuye cuando se inicia la operación de carga.

	`securityError:SecurityErrorEvent` — Intento de operación de carga para recuperar datos desde un servidor fuera del entorno limitado de seguridad del elemento que realiza la llamada. Esto puede resolverse utilizando un archivo de política en el servidor.

Emite

	`ArgumentError` — Es posible que los objetos `URLRequest.requestHeader` no contengan determinados encabezados de petición HTTP no permitidos. Para más información, consulte la descripción de la clase URLRequestHeader.

	`MemoryError` — Este error puede producirse por los motivos siguientes: Flash Player o Adobe AIR no pueden convertir el parámetro `URLRequest.data` de UTF8 a MBCS. Este error es aplicable si se define el objeto URLRequest transferido a `load()` para que lleve a cabo una operación `GET` y si `System.useCodePage` está establecido como `true`. Flash Player o Adobe AIR no pueden asignar memoria para los datos de `POST`. Este error es aplicable si se define el objeto URLRequest transmitido para la carga para que lleve a cabo una operación `POST`.

	`SecurityError` — Los archivos SWF locales que no son de confianza no pueden comunicarse en Internet. Puede solucionar este problema reclasificando el archivo SWF como archivo local de red o archivo de confianza.

	`SecurityError` — Si intenta conectarse a un puerto habitualmente reservado. Para obtener una lista completa de los puertos bloqueados, consulte la sección “Restricción de API de red” en el Guía del desarrollador de ActionScript 3.0.

Avisos legales | Política de privacidad en línea

AVURLStream - AS3

Clases x

cookieHeader

load