| Pacote | flash.media |
| Classe | public class MediaPromise |
| Herança | MediaPromise  EventDispatcher Object |
| Implementações | IFilePromise |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.5 |
A propriedade data de um objeto MediaEvent é uma instância de MediaPromise. Você pode usar os métodos MediaPromise para acessar o objeto de mídia prometido. Os formatos de mídia com suporte incluem imagens estáticas e vídeo.
Você não pode criar um objeto MediaPromise. Chamar new MediaPromise() gera um erro de tempo de execução.
Elementos da API relacionados
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
 | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| file : File [somente leitura]
A instância de File que representa o objeto de mídia, caso haja. | MediaPromise | ||
| isAsync : Boolean [somente leitura]
Indica se a fonte de dados subjacente é assíncrona ou síncrona. | MediaPromise | ||
| mediaType : String [somente leitura]
O tipo geral de mídia: imagem ou vídeo. | MediaPromise | ||
| relativePath : String [somente leitura]
O nome de arquivo do objeto de mídia, caso haja. | MediaPromise | ||
| Método | Definido por | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. | EventDispatcher | |
Fecha a fonte de dados. | MediaPromise | ||
|
Envia um evento para o fluxo de eventos. | EventDispatcher | |
|
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | EventDispatcher | |
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
Abre a fonte de dados subjacente e retorna a instância IDataInput para que você possa lê-la. | MediaPromise | ||
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
|
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | |
Usado pelo tempo de execução para relatar erros. | MediaPromise | ||
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
|
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
|
Retorna a representação de string do objeto especificado. | Object | |
|
Retorna o valor primitivo do objeto especificado. | Object | |
|
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. | EventDispatcher | |
| Evento | Resumo | Definido por | ||
|---|---|---|---|---|
| [transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo. | EventDispatcher | ||
| Um objeto MediaPromise emite um evento close quando o fluxo de dados subjacente tiver sido fechado. | MediaPromise | |||
| Um objeto MediaPromise emite um evento complete quando todos os dados tiverem sido lidos. | MediaPromise | |||
| [transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo. | EventDispatcher | ||
| Um objeto MediaPromise emite um evento ioError quando um erro é encontrado durante a leitura do fluxo de dados subjacente. | MediaPromise | |||
| Um objeto MediaPromise emite eventos progress à medida que os dados ficam disponíveis. | MediaPromise | |||
file | propriedade |
file:File [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.5 |
A instância de File que representa o objeto de mídia, caso haja.
Esta propriedade faz referência a um objeto File se a fonte de dados subjacente for baseada em arquivo e o arquivo for acessível ao aplicativo. Caso contrário, a propriedade é null.
Implementação
public function get file():File isAsync | propriedade |
mediaType | propriedade |
mediaType:String [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.5 |
O tipo geral de mídia: imagem ou vídeo.
As constantes na classe MediaType definem os valores possíveis desta propriedade:
- MediaType.IMAGE
- MediaType.VIDEO
Implementação
public function get mediaType():StringElementos da API relacionados
relativePath | propriedade |
relativePath:String [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.5 |
O nome de arquivo do objeto de mídia, caso haja.
Um nome de arquivo fica disponível se a fonte de dados subjacente for baseada em arquivo e o arquivo estiver acessível ao aplicativo. Caso contrário, a propriedade é null.
Implementação
public function get relativePath():Stringclose | () | método |
public function close():void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.5 |
Fecha a fonte de dados.
open | () | método |
public function open():IDataInput| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.5 |
Abre a fonte de dados subjacente e retorna a instância IDataInput para que você possa lê-la.
Se a fonte de dados subjacente for assíncrona, o objeto MediaPromise despachará eventos progress e complete para indicar se os dados estão disponíveis para leitura. Se a fonte de dados for síncrona, todos os dados ficam disponíveis imediatamente e esses eventos não são despachados.
Nota: você pode carregar um objeto MediaPromise usando o método loadFilePromise() da classe Loader em vez de ler os dados manualmente.
IDataInput |
Elementos da API relacionados
reportError | () | método |
public function reportError(e:ErrorEvent):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.5 |
Usado pelo tempo de execução para relatar erros.
O código do aplicativo não deve chamar este método.
Parâmetros
e:ErrorEvent — a abertura de erro para emissão.
|
close | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.CLOSE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.5 |
Um objeto MediaPromise emite um evento close quando o fluxo de dados subjacente tiver sido fechado.
Event.CLOSE define o valor da propriedade type de um objeto de evento close.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto cuja conexão foi fechada. |
complete | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.COMPLETE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.5 |
Um objeto MediaPromise emite um evento complete quando todos os dados tiverem sido lidos. O evento indica que não há mais dados disponíveis no fluxo subjacente.
O evento complete não é despachado pelas fontes de dados síncronas.
Event.COMPLETE define o valor da propriedade type de um objeto de evento complete.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto de rede que concluiu o carregamento. |
ioError | Evento |
flash.events.IOErrorEventpropriedade IOErrorEvent.type =
flash.events.IOErrorEvent.IOERROR| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.5 |
Um objeto MediaPromise emite um evento ioError quando um erro é encontrado durante a leitura do fluxo de dados subjacente. Mais nenhum dado pode ser lido após a emissão desse evento.
progress | Evento |
flash.events.ProgressEventpropriedade ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.5 |
Um objeto MediaPromise emite eventos progress à medida que os dados ficam disponíveis.
A propriedade bytesTotal de todos os eventos progress, exceto o último, tem valor 0. Se todos os dados estiverem disponíveis imediatamente, nenhum evento progress será despachado. Nenhum evento progress é despachado por fontes de dados síncronas.
type de um objeto de evento progress.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
bytesLoaded | O número de itens ou bytes carregados no momento em que o ouvinte processa o evento. |
bytesTotal | O número total de itens ou bytes que serão carregados no final se o processo de carregamento tiver êxito. |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto que está informando o andamento. |
Wed Jun 13 2018, 11:10 AM Z