| Pacchetto | flash.media |
| Classe | public class MediaPromise |
| Ereditarietà | MediaPromise  EventDispatcher Object |
| Implementa | IFilePromise |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.5 |
La proprietà data di un oggetto MediaEvent è un'istanza MediaPromise. Potete usare i metodi MediaPromise per accedere all'oggetto multimediale promesso. I formati multimediali supportati includono le immagini istantanee e i video.
Non è possibile creare un oggetto MediaPromise. Una chiamata new MediaPromise() genera un errore runtime.
Elementi API correlati
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
 | constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| file : File [sola lettura]
L'istanza File che rappresenta l'oggetto multimediale, se esiste. | MediaPromise | ||
| isAsync : Boolean [sola lettura]
Segnala se l'origine dati sottostante è asincrona o sincrona. | MediaPromise | ||
| mediaType : String [sola lettura]
Il tipo multimediale generale (immagine o video). | MediaPromise | ||
| relativePath : String [sola lettura]
Il nome file dell'oggetto multimediale, se esiste. | MediaPromise | ||
| Metodo | Definito da | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento. | EventDispatcher | |
Chiude l'origine dati. | MediaPromise | ||
|
Invia un evento nel flusso di eventi. | EventDispatcher | |
|
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | |
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
Apre l'origine dati sottostante e restituisce l'istanza IDataInput che consente di leggerla. | MediaPromise | ||
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | |
Utilizzato in runtime per segnalare gli errori. | MediaPromise | ||
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | |
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
|
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher | |
| Evento | Riepilogo | Definito da | ||
|---|---|---|---|---|
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo. | EventDispatcher | ||
| Un oggetto MediaPromise invia un evento close quando il flusso di dati sottostante è stato chiuso. | MediaPromise | |||
| Un oggetto MediaPromise invia un evento complete quando tutti i dati sono stati letti. | MediaPromise | |||
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo. | EventDispatcher | ||
| Un oggetto MediaPromise invia un evento ioError quando si verifica un errore durante la lettura del flusso di dati sottostante. | MediaPromise | |||
| Un oggetto MediaPromise invia eventi progress man mano che i dati diventano disponibili. | MediaPromise | |||
file | proprietà |
file:File [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.5 |
L'istanza File che rappresenta l'oggetto multimediale, se esiste.
Questa proprietà fa riferimento a un oggetto File se l'origine dati sottostante è basata su file e il file è accessibile all'applicazione. In caso contrario, la proprietà è null.
Implementazione
public function get file():File isAsync | proprietà |
mediaType | proprietà |
mediaType:String [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.5 |
Il tipo multimediale generale (immagine o video).
Le costanti della classe MediaType definiscono i valori possibili di questa proprietà:
- MediaType.IMAGE
- MediaType.VIDEO
Implementazione
public function get mediaType():StringElementi API correlati
relativePath | proprietà |
relativePath:String [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.5 |
Il nome file dell'oggetto multimediale, se esiste.
Un nome file è disponibile se l'origine dati sottostante è basata su file e il file è accessibile all'applicazione. In caso contrario, la proprietà è null.
Implementazione
public function get relativePath():Stringclose | () | metodo |
public function close():void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.5 |
Chiude l'origine dati.
open | () | metodo |
public function open():IDataInput| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.5 |
Apre l'origine dati sottostante e restituisce l'istanza IDataInput che consente di leggerla.
Se l'origine dati sottostante è asincrona, l'oggetto MediaPromise invia gli eventi progress e complete per indicare se sono presenti dati disponibili per la lettura. Se l'origine dati è sincrona, tutti i dati sono disponibili immediatamente e questi eventi non vengono inviati.
Nota: potete caricare un oggetto MediaPromise utilizzando il metodo loadFilePromise() della classe Loader anziché leggere i dati manualmente.
IDataInput |
Elementi API correlati
reportError | () | metodo |
public function reportError(e:ErrorEvent):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.5 |
Utilizzato in runtime per segnalare gli errori.
Il codice dell'applicazione non deve chiamare questo metodo.
Parametri
e:ErrorEvent — L'evento di errore da inviare.
|
close | Evento |
flash.events.Eventproprietà Event.type =
flash.events.Event.CLOSE| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.5 |
Un oggetto MediaPromise invia un evento close quando il flusso di dati sottostante è stato chiuso.
Event.CLOSE definisce il valore della proprietà type di un oggetto evento close.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto la cui connessione è stata chiusa. |
complete | Evento |
flash.events.Eventproprietà Event.type =
flash.events.Event.COMPLETE| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.5 |
Un oggetto MediaPromise invia un evento complete quando tutti i dati sono stati letti. L'evento indica che non vi sono più dati disponibili nel flusso sottostante.
Un evento complete non viene inviato da un'origine dati sincrona.
Event.COMPLETE definisce il valore della proprietà type di un oggetto evento complete.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto di rete che ha completato il caricamento. |
ioError | Evento |
flash.events.IOErrorEventproprietà IOErrorEvent.type =
flash.events.IOErrorEvent.IOERROR| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.5 |
Un oggetto MediaPromise invia un evento ioError quando si verifica un errore durante la lettura del flusso di dati sottostante. Dopo l'invio di questo evento non è possibile leggere altri dati.
progress | Evento |
flash.events.ProgressEventproprietà ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.5 |
Un oggetto MediaPromise invia eventi progress man mano che i dati diventano disponibili.
La proprietà bytesTotal di tutti gli eventi progress eccetto l'ultimo ha il valore 0. Se tutti i dati sono disponibili immediatamente, non viene inviato alcun evento progress. Gli eventi progress non vengono inviati dalle origini dati sincrone.
type di un oggetto evento progress.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
bytesLoaded | Il numero di elementi o di byte caricati nel momento in cui il listener elabora l'evento. |
bytesTotal | Il numero totale di elementi o byte che vengono caricati se il processo di caricamento viene completato correttamente. |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto che riporta l'avanzamento. |
Tue Jun 12 2018, 02:44 PM Z