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

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 clase MediaPromise representa la promesa de entregar un objeto multimedia.

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

MediaEvent
IFilePromise
Loader.LoadFilePromise()
IDataInput
CameraRoll.browseForImage()
CameraUI

Propiedades públicas

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é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 el origen de datos.	MediaPromise
		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
		open():IDataInput Abre el origen de datos subyacente y devuelve la instancia de IDataInput permitiendo al usuario leerla.	MediaPromise
		propertyIsEnumerable(name:String):Boolean Indica si existe la propiedad especificada y si es enumerable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Elimina un detector del objeto EventDispatcher.	EventDispatcher
		reportError(e:ErrorEvent):void Lo utiliza el motor de ejecución para informar sobre errores.	MediaPromise
		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
close	Un objeto MediaPromise distribuye un evento close cuando se cierra la transmisión de datos subyacente.	MediaPromise
complete	Un objeto MediaPromise distribuye un evento complete cuando se han leído todos los datos.	MediaPromise
deactivate	[evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos.	EventDispatcher
ioError	Un objeto MediaPromise distribuye un evento ioError cuando se encuentra un error al leer la transmisión de datos subyacente.	MediaPromise
progress	Un objeto MediaPromise distribuye eventos progress a medida que los datos van estando visibles.	MediaPromise

Información sobre propiedades

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

isAsync:Boolean [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 2.5

Informa sobre si el origen de datos subyacente es asíncrono o sincrónico.

Implementación
public function get isAsync():Boolean

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():String

Elementos de API relacionados

MediaType

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():String

Información sobre métodos

close

()

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.

Valor devuelto

IDataInput

Elementos de API relacionados

Loader.loadFilePromise()

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.

Información sobre eventos

close

Evento

Tipo de objeto de evento: flash.events.Event
propiedad 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.

La constante 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

Tipo de objeto de evento: flash.events.Event
propiedad 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.

La constante 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

Tipo de objeto de evento: flash.events.IOErrorEvent
propiedad 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

Tipo de objeto de evento: flash.events.ProgressEvent
propiedad 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.

Define el valor de la propiedad 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.

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

MediaPromise - AS3

Paquete flash.media

file

isAsync

mediaType

relativePath

close

open

reportError

close

complete

ioError

progress