| Paquete | flash.media |
| Clase | public class MediaPromise |
| Herencia | MediaPromise  EventDispatcher Object |
| Implementa | IFilePromise |
| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.5 |
La propiedad data de un objeto MediaEvent es una instancia de MediaPromise. Se pueden utilizar los métodos MediaPromise para acceder al objeto multimedia prometido. Entre los formatos de medios admitidos se incluyen imágenes fijas y vídeo.
No es posible crear un objeto MediaPromise. Al llamar a new MediaPromise() se genera un error de tiempo de ejecución.
Elementos de API relacionados
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadas| Propiedad | Definido por | ||
|---|---|---|---|
 | constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| file : File [solo lectura]
La instancia de File que representa el objeto multimedia, si existe. | MediaPromise | ||
| isAsync : Boolean [solo lectura]
Informa sobre si el origen de datos subyacente es asíncrono o sincrónico. | MediaPromise | ||
| mediaType : String [solo lectura]
El tipo general del medio, imagen o vídeo. | MediaPromise | ||
| relativePath : String [solo lectura]
El nombre de archivo del objeto multimedia, si existe. | MediaPromise | ||
| 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 | |
Cierra el origen de datos. | MediaPromise | ||
|
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 | |
Abre el origen de datos subyacente y devuelve la instancia de IDataInput permitiendo al usuario leerla. | MediaPromise | ||
|
Indica si existe la propiedad especificada y si es enumerable. | Object | |
|
Elimina un detector del objeto EventDispatcher. | EventDispatcher | |
Lo utiliza el motor de ejecución para informar sobre errores. | MediaPromise | ||
|
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 | ||
| Un objeto MediaPromise distribuye un evento close cuando se cierra la transmisión de datos subyacente. | MediaPromise | |||
| Un objeto MediaPromise distribuye un evento complete cuando se han leído todos los datos. | MediaPromise | |||
| [evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos. | EventDispatcher | ||
| Un objeto MediaPromise distribuye un evento ioError cuando se encuentra un error al leer la transmisión de datos subyacente. | MediaPromise | |||
| Un objeto MediaPromise distribuye eventos progress a medida que los datos van estando visibles. | MediaPromise | |||
file | propiedad |
file:File [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.5 |
La instancia de File que representa el objeto multimedia, si existe.
Esta propiedad hace referencia a un objeto File si el origen de datos subyacente está basado en archivos y su aplicación puede acceder al archivo. De lo contrario, la propiedad es null.
Implementación
public function get file():File isAsync | propiedad |
mediaType | propiedad |
mediaType:String [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.5 |
El tipo general del medio, imagen o vídeo.
Las constantes de la clase MediaType definen posibles valores de esta propiedad:
- MediaType.IMAGE
- MediaType.VIDEO
Implementación
public function get mediaType():StringElementos de API relacionados
relativePath | propiedad |
relativePath:String [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.5 |
El nombre de archivo del objeto multimedia, si existe.
Un nombre de archivo está disponible si el origen de datos subyacente está basado en archivos y su aplicación puede acceder al archivo. De lo contrario, la propiedad es null.
Implementación
public function get relativePath():Stringclose | () | método |
public function close():void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.5 |
Cierra el origen de datos.
open | () | método |
public function open():IDataInput| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.5 |
Abre el origen de datos subyacente y devuelve la instancia de IDataInput permitiendo al usuario leerla.
Si el origen de datos subyacente es asincrónico, a continuación, el objeto MediaPromise distribuye eventos progress y complete para indicar si los datos está disponibles para su lectura. Si el origen de datos es sincrónico, todos los datos están disponibles inmediatamente y estos eventos no se distribuyen.
Nota: se puede cargar un objeto MediaPromise con el método loadFilePromise() de la clase Loader en lugar de leer los datos manualmente.
IDataInput |
Elementos de API relacionados
reportError | () | método |
public function reportError(e:ErrorEvent):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.5 |
Lo utiliza el motor de ejecución para informar sobre errores.
El código de la aplicación no debe llamar a este método.
Parámetros
e:ErrorEvent — el evento de error para distribuir.
|
close | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.CLOSE| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.5 |
Un objeto MediaPromise distribuye un evento close cuando se cierra la transmisión de datos subyacente.
Event.CLOSE define el valor de la propiedad type de un objeto de evento close.
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 cuya conexión se ha cerrado. |
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 2.5 |
Un objeto MediaPromise distribuye un evento complete cuando se han leído todos los datos. El evento indica que no hay más datos disponibles en la secuencia.
Un evento complete no se distribuye por un origen de datos sincrónicos.
Event.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. |
ioError | Evento |
flash.events.IOErrorEventpropiedad IOErrorEvent.type =
flash.events.IOErrorEvent.IOERROR| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2.5 |
Un objeto MediaPromise distribuye un evento ioError cuando se encuentra un error al leer la transmisión de datos subyacente. No se pueden leer más datos una vez distribuido este evento.
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 2.5 |
Un objeto MediaPromise distribuye eventos progress a medida que los datos van estando visibles.
La propiedad bytesTotal de todos los eventos progress excepto la última tiene el valor 0. Si todos los datos están disponibles inmediatamente, no se puede distribuir ningún evento progress. No hay ningún evento progress distribuido por fuentes de datos sincrónicas.
type 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. |
Tue Jun 12 2018, 02:12 PM Z