| Paquete | flash.media |
| Clase | public class AVURLLoader |
| Herencia | AVURLLoader  URLLoader EventDispatcher Object |
| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Un objeto URLLoader descarga todos los datos de una URL antes de ponerla a disposición en el código de las aplicaciones. Envía notificaciones sobre el progreso de la descarga que se pueden supervisar mediante las propiedades bytesLoaded y bytesTotal, así como a través de los eventos distribuidos.
Al cargar archivos de vídeo de gran tamaño como, por ejemplo, archivos FLV, se pueden producir errores de memoria insuficiente.
Al utilizar esta clase en Flash Player y en el contenido de la aplicación de AIR en entornos limitados de seguridad distintos al entorno limitado de seguridad de la aplicación, se considera el modelo de seguridad siguiente:
- Es posible que un archivo SWF del entorno limitado local-con-sistema-de-archivos no cargue ni proporcione datos a un recurso que se encuentre en el entorno limitado de red.
- 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.
Para obtener más información, consulte el tema del Centro de desarrollo de Flash Player Seguridad.
Elementos de API relacionados
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadas| Propiedad | Definido por | ||
|---|---|---|---|
 | bytesLoaded : uint = 0
Indica el número de bytes cargados hasta ese momento durante la operación de carga. | URLLoader | |
| bytesTotal : uint = 0
Indica el número total de bytes de los datos descargados. | URLLoader | |
| constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| cookieHeader : String [solo escritura] | AVURLLoader | ||
| data : *
Los datos recibidos de la operación de carga. | URLLoader | |
| dataFormat : String = "text"
Controla si los datos cargados se reciben como texto (URLLoaderDataFormat.TEXT), como datos binarios sin formato (URLLoaderDataFormat.BINARY) o como variables con codificación URL (URLLoaderDataFormat.VARIABLES). | URLLoader | |
| Método | Definido por | ||
|---|---|---|---|
AVURLLoader(request:URLRequest = null)
Crea un objeto URLLoader. | AVURLLoader | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [override] | AVURLLoader | ||
[override]
Cierra la operación de carga en curso. | AVURLLoader | ||
|
Distribuye un evento en el flujo del evento. | EventDispatcher | |
|
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento. | EventDispatcher | |
|
Indica si un objeto tiene definida una propiedad especificada. | Object | |
|
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | |
[override]
Envía y carga datos desde la URL especificada. | AVURLLoader | ||
|
Indica si existe la propiedad especificada y si es enumerable. | Object | |
|
Elimina un detector del objeto EventDispatcher. | EventDispatcher | |
|
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | |
|
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | |
|
Devuelve la representación de cadena del objeto especificado. | Object | |
|
Devuelve el valor simple del objeto especificado. | Object | |
|
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 | |
| Evento | Resumen | Definido por | ||
|---|---|---|---|---|
| [evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos. | EventDispatcher | ||
| Se distribuye tras decodificar y colocar todos los datos recibidos en la propiedad data del objeto URLLoader. | AVURLLoader | |||
| [evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos. | EventDispatcher | ||
| 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. | AVURLLoader | |||
| Se distribuye si una llamada al método URLLoader.load() intenta acceder a los datos mediante HTTP. | AVURLLoader | |||
| Se distribuye si el resultado de una llamada a URLLoader.load() es un error grave que hace que la descarga finalice. | AVURLLoader | |||
| Se distribuye cuando se inicia la operación de descarga tras una llamada al método URLLoader.load(). | AVURLLoader | |||
| Se distribuye al recibirse datos mientras progresa una operación de descarga. | AVURLLoader | |||
| Se distribuye si se intenta llamar a URLLoader.load() para cargar datos de un servidor situado fuera del entorno limitado de seguridad. | AVURLLoader | |||
cookieHeader | propiedad |
AVURLLoader | () | Información sobre |
public function AVURLLoader(request:URLRequest = null)| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Crea un objeto URLLoader.
Parámetrosrequest:URLRequest (default = null)load para obtener más información).
|
Elementos de API relacionados
addEventListener | () | método |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):voidParámetros
type:String | |
listener:Function | |
useCapture:Boolean (default = false) | |
priority:int (default = 0) | |
useWeakReference:Boolean (default = false) |
close | () | método |
override public function close():void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Cierra la operación de carga en curso. Se detendrá inmediatamente cualquier operación de carga en curso. Si no se transmite ninguna URL en ese momento, se emitirá un error de transmisión no válida.
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 |
Envía y carga datos desde la URL especificada. Los datos se pueden recibir como texto, como datos binarios sin formato o como variables con codificación, en función del valor establecido para la propiedad dataFormat. Tenga en cuenta que el valor predeterminado de la propiedad dataFormat es text. Si quiere enviar datos a la URL especificada, puede establecer la propiedad data en el objeto URLRequest.
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.
Es posible que un archivo SWF del entorno limitado local-con-sistema-de-archivos no cargue ni proporcione datos a un recurso que se encuentre en el entorno limitado de red.
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.
No es posible conectar con puertos reservados comúnmente. 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 10 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.
Para obtener más información, consulte el tema del Centro de desarrollo de Flash Player Seguridad.
Parámetros
request:URLRequest — Un objeto URLRequest que especifica la URL que se va a descargar.
|
Eventos
complete: — Se distribuye cuando los datos se han cargado correctamente.
| |
httpStatus: — Si se accede a través de HTTP y el entorno actual de Flash Player admite la obtención de códigos de estado, es posible recibir dichos eventos además de cualquier evento complete o error.
| |
ioError: — No se pudo completar la operación de carga.
| |
progress: — Se distribuye al recibirse datos mientras progresa una operación de descarga.
| |
securityError: — 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.
| |
securityError: — Una operación de carga ha intentado cargar un archivo SWZ (un componente de plataforma de Adobe), pero el certificado no es válido o la cadena digest no coincide con el componente.
| |
open: — Se distribuye cuando se inicia la operación de carga.
| |
httpResponseStatus: — 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.
|
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: 1) Flash Player o 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. 2) Flash Player o AIR no pueden asignar memoria para los datos de POST. Este error se aplica si se define el objeto URLRequest transferido a load para que lleve a cabo una operación POST.
| |
SecurityError — Los archivos locales que no son de confianza no pueden comunicarse en Internet. Puede solucionar este problema reclasificando el archivo 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.
| |
TypeError — El valor del parámetro de solicitud o de la propiedad URLRequest.url del objeto URLRequest transferido es null.
|
Elementos de API relacionados
URLRequest.requestHeaders
URLRequest.data
URLRequest.digest
complete | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.COMPLETE| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Se distribuye tras decodificar y colocar todos los datos recibidos en la propiedad data del objeto URLLoader. Es posible acceder a los datos recibidos una vez distribuido este evento.
La constanteEvent.COMPLETE define el valor de la propiedad type de un objeto de evento complete.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Objeto de red que ha terminado de cargarse. |
Elementos de API relacionados
httpResponseStatus | Evento |
flash.events.HTTPStatusEventpropiedad HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, AIR 1.0, Flash Lite 4 |
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.
Al contrario quehttpStatus, 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.
La constante HTTPStatusEvent.HTTP_RESPONSE_STATUS define el valor de la propiedad type de un objeto de evento httpResponseStatus.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
responseURL | URL desde la que se devolvió la respuesta. |
responseHeaders | Encabezados de respuesta devueltos por la respuesta como un conjunto de objeto URLRequestHeader. |
status | El código de estado HTTP que devuelve el servidor. |
redirected | Indica si la respuesta es el resultado de una redirección. |
target | El objeto de red que recibe el código de estado HTTP. |
Elementos de API relacionados
httpStatus | Evento |
flash.events.HTTPStatusEventpropiedad HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_STATUS| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Se distribuye si una llamada al método URLLoader.load() intenta acceder a los datos mediante HTTP. Para contenido ejecutado en Flash Player, este evento sólo se distribuye si el entorno actual de Flash Player puede detectar y devolver el código de estado de la petición. (Es posible que algunos entornos de navegador no proporcionen esta información.) Tenga en cuenta que se enviará el evento httpStatus (si existe) antes que (y además de) cualquier evento complete o error.
HTTPStatusEvent.HTTP_STATUS define el valor de la propiedad type de un objeto de evento httpStatus.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
status | El código de estado HTTP que devuelve el servidor. |
target | El objeto de red que recibe el código de estado HTTP. |
Elementos de API relacionados
ioError | Evento |
flash.events.IOErrorEventpropiedad IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Se distribuye si el resultado de una llamada a URLLoader.load() es un error grave que hace que la descarga finalice.
Define el valor de la propiedadtype de un objeto de evento ioError.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
errorID | Un número de referencia asociado al error concreto (sólo AIR). |
target | El objeto de red en el que se produce el error de entrada/salida. |
text | Texto que se mostrará como mensaje de error. |
Elementos de API relacionados
open | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.OPEN| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Se distribuye cuando se inicia la operación de descarga tras una llamada al método URLLoader.load().
Event.OPEN define el valor de la propiedad type de un objeto de evento open.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Objeto de red que ha abierto una conexión. |
Elementos de API relacionados
progress | Evento |
flash.events.ProgressEventpropiedad ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Se distribuye al recibirse datos mientras progresa una operación de descarga.
Tenga en cuenta que con un objeto URLLoader no es posible acceder a los datos hasta que no se reciben por completo. Por tanto, el evento de progreso únicamente sirve de notificación para saber qué grado de progreso ha alcanzado la descarga. Para acceder a los datos antes de que se descarguen por completo, utilice un objeto AVURLStream.
Define el valor de la propiedadtype de un objeto de evento progress.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
bytesLoaded | Número de elementos o bytes cargados en el momento en que el detector procesa el evento. |
bytesTotal | Número total de elementos o bytes que se cargarán en última instancia si el proceso de carga se realiza correctamente. |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | El objeto que informa sobre el progreso. |
Elementos de API relacionados
securityError | Evento |
flash.events.SecurityErrorEventpropiedad SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Se distribuye si se intenta llamar a URLLoader.load() para cargar datos de un servidor situado fuera del entorno limitado de seguridad. También se distribuye si una llamada a URLLoader.load() intenta cargar un archivo SWZ y el certificado no es válido, o si la cadena digest no coincide con el componente.
SecurityErrorEvent.SECURITY_ERROR define el valor de la propiedad type de un objeto de evento securityError.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | El objeto de red que informa sobre le error de seguridad. |
text | Texto que se mostrará como mensaje de error. |
Elementos de API relacionados
Tue Jun 12 2018, 02:12 PM Z