| Package | flash.media |
| Classe | public class MediaPromise |
| Héritage | MediaPromise  EventDispatcher Object |
| Implémente | IFilePromise |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.5 |
La propriété data d’un objet MediaEvent est une occurrence de MediaPromise. Vous pouvez utiliser les méthodes MediaPromise pour accéder à l’objet multimédia promis. Les formats multimédias pris en charge formats sont des images fixes et des vidéos.
Vous ne pouvez pas créer un objet MediaPromise. L’appel de MediaPromise() génère une erreur d’exécution.
Eléments de l’API associés
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| file : File [lecture seule]
Occurrence de File représentant l’objet multimédia, s’il existe. | MediaPromise | ||
| isAsync : Boolean [lecture seule]
Indique si la source de données sous-jacente est asynchrone ou synchrone. | MediaPromise | ||
| mediaType : String [lecture seule]
Type général d’éléments multimédias (images ou vidéos). | MediaPromise | ||
| relativePath : String [lecture seule]
Nom du fichier de l’objet multimédia, s’il existe. | MediaPromise | ||
| Méthode | Défini par | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | |
Ferme la source de données. | MediaPromise | ||
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
Ouvre la source de données sous-jacente et renvoie l’occurrence de IDataInput permettant de la lire. | MediaPromise | ||
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
Utilisé par le moteur d’exécution pour signaler des erreurs. | MediaPromise | ||
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher | |
| Evénement | Synthèse | Défini par | ||
|---|---|---|---|---|
| [Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | ||
| Un objet MediaPromise distribue un événement close après la fermeture du flux de données sous-jacent. | MediaPromise | |||
| Un objet MediaPromise distribue un événement complete après la lecture de toutes les données. | MediaPromise | |||
| [Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | ||
| Un objet MediaPromise distribue un événement ioError si une erreur est détectée lors de la lecture du flux de données sous-jacent. | MediaPromise | |||
| Un objet MediaPromise distribue des événements progress au fur et à mesure que les données deviennent disponibles. | MediaPromise | |||
file | propriété |
file:File [lecture seule] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.5 |
Occurrence de File représentant l’objet multimédia, s’il existe.
Cette propriété fait référence à un objet File si la source de données sous-jacente est basée sur un fichier et si le fichier est accessible à l’application. Dans le cas contraire, cette propriété est null.
Implémentation
public function get file():File isAsync | propriété |
mediaType | propriété |
mediaType:String [lecture seule] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.5 |
Type général d’éléments multimédias (images ou vidéos).
Les constantes de la classe MediaType définissent les valeurs possibles de cette propriété :
- MediaType.IMAGE
- MediaType.VIDEO
Implémentation
public function get mediaType():StringEléments de l’API associés
relativePath | propriété |
relativePath:String [lecture seule] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.5 |
Nom du fichier de l’objet multimédia, s’il existe.
Un nom de fichier est disponible si la source de données sous-jacente est basée sur un fichier et si le fichier est accessible à l’application. Dans le cas contraire, cette propriété est null.
Implémentation
public function get relativePath():Stringclose | () | méthode |
public function close():void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.5 |
Ferme la source de données.
open | () | méthode |
public function open():IDataInput| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.5 |
Ouvre la source de données sous-jacente et renvoie l’occurrence de IDataInput permettant de la lire.
Si la source de données sous-jacente est asynchrone, l’objet MediaPromise distribue des événements progress et complete qui indiquent si les données sont disponibles pour la lecture. Si la source de données est synchrone, toutes les données sont immédiatement disponibles et ces événements ne sont pas distribués.
Remarque : vous pouvez charger un objet MediaPromise à l’aide de la méthode loadFilePromise() de la classe Loader au lieu de lire les données manuellement.
IDataInput |
Eléments de l’API associés
reportError | () | méthode |
public function reportError(e:ErrorEvent):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.5 |
Utilisé par le moteur d’exécution pour signaler des erreurs.
Le code de l’application ne doit pas appeler cette méthode.
Paramètres
e:ErrorEvent — L’événement d’erreur à distribuer.
|
close | Evénement |
flash.events.Eventpropriété Event.type =
flash.events.Event.CLOSE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.5 |
Un objet MediaPromise distribue un événement close après la fermeture du flux de données sous-jacent.
Event.CLOSE définit la valeur de la propriété type d’un objet événement close.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet dont la connexion a été fermée. |
complete | Evénement |
flash.events.Eventpropriété Event.type =
flash.events.Event.COMPLETE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.5 |
Un objet MediaPromise distribue un événement complete après la lecture de toutes les données. L’événement indique qu’il n’existe plus aucune donnée disponible dans le flux sous-jacent.
Aucun événement complete n’est distribué par une source de données synchrone.
Event.COMPLETE définit la valeur de la propriété type d’un objet événement complete.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet réseau dont le chargement est terminé. |
ioError | Evénement |
flash.events.IOErrorEventpropriété IOErrorEvent.type =
flash.events.IOErrorEvent.IOERROR| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.5 |
Un objet MediaPromise distribue un événement ioError si une erreur est détectée lors de la lecture du flux de données sous-jacent. Plus aucune donnée ne peut être lue après la distribution de cet événement.
progress | Evénement |
flash.events.ProgressEventpropriété ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.5 |
Un objet MediaPromise distribue des événements progress lorsque les données deviennent disponibles.
La propriété bytesTotal de tous les événements progress, à l’exception du dernier, a une valeur de 0. Si toutes les données sont disponibles immédiatement, il est possible qu’aucun événement progress ne soit distribué. Aucun événement progress n’est distribué par des sources de données synchrones.
type d’un objet événement progress.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
bytesLoaded | Nombre d’éléments ou d’octets chargés lors du traitement de l’événement par l’écouteur. |
bytesTotal | Nombre total d’éléments ou d’octets qui seront chargés si le processus de chargement aboutit. |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet indiquant la progression. |
Tue Jun 12 2018, 09:30 AM Z