| Package | org.osmf.media |
| Classe | public class MediaElement |
| Héritage | MediaElement  EventDispatcher Object |
| Sous-classes | BeaconElement, CompositeElement, HTMLElement, LoadableElementBase, ProxyElement |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Via un programme, un élément multimédia encapsule un ensemble de traits de média et un espace d’état. Les traits du support représentent les capacités de l’élément multimédia et sont dynamiques par nature. A un moment, un élément multimédia peut être accessible en recherche et, à un autre moment, il peut ne pas l’être. Par exemple, cela peut se produire si l’élément multimédia est une séquence vidéo contenant des publicités obligatoirement visionnables.
Un élément multimédia fonctionne sur une ressource de support. Par exemple, si l’élément multimédia représente un lecteur vidéo, la ressource média peut encapsuler un URL vers un flux vidéo. Si l’élément multimédia représente une composition média complexe, l’URL de ressource média peut être un document qui référence les diverses ressources utilisées dans la composition média.
Eléments de l’API associés
MediaResourceBase
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 | |
| container : IMediaContainer [lecture seule]
Le conteneur multimédia que cet élément utilise. | MediaElement | ||
| metadataNamespaceURLs : Vector.<String> [lecture seule]
Vecteur contenant les URL d’espace de noms de tous les objets Metadata stockés dans ce MediaElement. | MediaElement | ||
| resource : MediaResourceBase
La ressource multimédia sur laquelle cet élément multimédia fonctionne. | MediaElement | ||
| traitTypes : Vector.<String> [lecture seule]
Un vecteur de valeurs MediaTraitType représentant les types de caractéristique sur cet élément multimédia. | MediaElement | ||
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur. | MediaElement | ||
| 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 | |
Ajoute un objet Metadata à ce MediaElement sous l’URL d’espace de noms spécifié. | MediaElement | ||
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
Renvoie l’objet Metadata qui est stocké sous ce MediaElement avec l’URL d’espace de noms indiqué. | MediaElement | ||
Renvoie le trait de support du type spécifié. | MediaElement | ||
|
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 | |
Détermine si cet élément média possède une caractéristique de média du type spécifié. | MediaElement | ||
|
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 | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
Supprime l’objet Metadata stocké sous ce MediaElement avec l’URL d’espace de noms indiqué. | MediaElement | ||
|
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 | |
| Méthode | Défini par | ||
|---|---|---|---|
Ajoute une nouvelle caractéristique commune de média à cet élément multimédia. | MediaElement | ||
Supprime une nouvelle caractéristique commune de média de cet élément multimédia. | MediaElement | ||
Définit les traits de cet élément multimédia. | MediaElement | ||
| 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 | ||
| Distribué lorsque la propriété container de l’élément a été modifiée. | MediaElement | |||
| [Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | ||
| Distribué lorsqu’une erreur entraînant une dégradation du fonctionnement de l’élément multimédia se produit. | MediaElement | |||
| Distribué lorsque des infos ayant un impact sur le fonctionnement de l’élément multimédia sont disponibles. | MediaElement | |||
| Distribué lorsqu’un objet Metadata a été ajouté à cet élément multimédia. | MediaElement | |||
| Distribué lorsqu’un objet Metadata a été supprimé de cet élément multimédia. | MediaElement | |||
| Distribué lorsqu’une caractéristique commune est ajoutée à l’élément multimédia. | MediaElement | |||
| Distribué lorsqu’une caractéristique commune est supprimée de l’élément multimédia. | MediaElement | |||
container | propriété |
container:IMediaContainer [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Le conteneur multimédia que cet élément utilise.
Implémentation
public function get container():IMediaContainermetadataNamespaceURLs | propriété |
resource | propriété |
resource:MediaResourceBase| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
La ressource multimédia sur laquelle cet élément multimédia fonctionne.
Implémentation
public function get resource():MediaResourceBase public function set resource(value:MediaResourceBase):voidtraitTypes | propriété |
traitTypes:Vector.<String> [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Un vecteur de valeurs MediaTraitType représentant les types de caractéristique sur cet élément multimédia.
Implémentation
public function get traitTypes():Vector.<String>MediaElement | () | Constructeur |
public function MediaElement()| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Constructeur.
addMetadata | () | méthode |
public function addMetadata(namespaceURL:String, metadata:Metadata):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Ajoute un objet Metadata à ce MediaElement sous l’URL d’espace de noms spécifié.
Paramètres
namespaceURL:String — L’URL d’espace de noms utilisé pour stocker les métadonnées.
| |
metadata:Metadata — Les métadonnées à ajouter.
|
Valeur émise
ArgumentError — Si namespaceURL ou metadata est null.
|
addTrait | () | méthode |
protected function addTrait(type:String, instance:org.osmf.traits:MediaTraitBase):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Ajoute une nouvelle caractéristique commune de média à cet élément multimédia. Si l’opération a réussi, envoi d’un MediaElementEvent.
Paramètres
type:String — Le MediaTraitType du trait de support à ajouter.
| |
instance:org.osmf.traits:MediaTraitBase — Le trait de support à ajouter.
|
Valeur émise
ArgumentError — Si l’un des paramètres est null ou si le type indiqué et le type du trait de média ne correspondent pas ou bien si une autre instance de la classe du trait a déjà été ajoutée.
|
getMetadata | () | méthode |
public function getMetadata(namespaceURL:String):Metadata| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie l’objet Metadata qui est stocké sous ce MediaElement avec l’URL d’espace de noms indiqué.
Paramètres
namespaceURL:String — L’URL de l’espace de noms de l’objet Metadata à récupérer.
|
Metadata |
Valeur émise
ArgumentError — Si namespaceURL est null.
|
getTrait | () | méthode |
public function getTrait(type:String):org.osmf.traits:MediaTraitBase| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie le trait de support du type spécifié.
Paramètres
type:String — Le MediaTraitType du trait de support à renvoyer.
|
org.osmf.traits:MediaTraitBase — Le trait récupéré ou null si un tel trait n’existe pas sur cet élément multimédia.
|
Valeur émise
ArgumentError — Si le paramètre est null.
|
hasTrait | () | méthode |
public function hasTrait(type:String):Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Détermine si cet élément média possède une caractéristique de média du type spécifié.
Paramètres
type:String — Le MediaTraitType du trait de support à vérifier.
|
Boolean — true si cet élément média possède un trait de support de la classe spécifiée, sinon false.
|
Valeur émise
ArgumentError — Si le paramètre est null.
|
removeMetadata | () | méthode |
public function removeMetadata(namespaceURL:String):Metadata| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Supprime l’objet Metadata stocké sous ce MediaElement avec l’URL d’espace de noms indiqué.
Paramètres
namespaceURL:String — L’URL de l’espace de noms de l’objet Metadata à supprimer.
|
Metadata |
Valeur émise
ArgumentError — Si namespaceURL est null.
|
removeTrait | () | méthode |
protected function removeTrait(type:String):org.osmf.traits:MediaTraitBase| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Supprime une nouvelle caractéristique commune de média de cet élément multimédia. Si l’opération a réussi, envoi d’un MediaElementEvent.
Paramètres
type:String — Le MediaTraitType du trait de support à supprimer.
|
org.osmf.traits:MediaTraitBase — Le trait supprimé ou null si aucun trait n’a été supprimé.
|
Valeur émise
ArgumentError — Si le paramètre est null.
|
setupTraits | () | méthode |
protected function setupTraits():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Définit les traits de cet élément multimédia. Se produit pendant la construction. Les sous-classes doivent annuler cette méthode et appeler addTrait pour chaque trait qui leur est propre.
containerChange | Evénement |
org.osmf.events.ContainerChangeEventpropriété ContainerChangeEvent.type =
org.osmf.events.ContainerChangeEvent.CONTAINER_CHANGE| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Distribué lorsque la propriété container de l’élément a été modifiée.
La constante ContainerChangeEvent.CONTAINER_CHANGE définit la valeur de la propriété type de l’objet d’événement d’un événement containerChange.mediaError | Evénement |
org.osmf.events.MediaErrorEventpropriété MediaErrorEvent.type =
org.osmf.events.MediaErrorEvent.MEDIA_ERROR| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Distribué lorsqu’une erreur entraînant une dégradation du fonctionnement de l’élément multimédia se produit.
La constante MediaErrorEvent.MEDIA_ERROR définit la valeur de la propriété type de l’objet d’événement pour un événement mediaError.mediaInfo | Evénement |
org.osmf.events.MediaErrorEventpropriété MediaErrorEvent.type =
org.osmf.events.MediaErrorEvent.MEDIA_INFO| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 2.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Distribué lorsque des infos ayant un impact sur le fonctionnement de l’élément multimédia sont disponibles. Les événements MEDIA_INFO ne sont pas fatals.
metadataAdd | Evénement |
org.osmf.events.MediaElementEventpropriété MediaElementEvent.type =
org.osmf.events.MediaElementEvent.METADATA_ADD| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Distribué lorsqu’un objet Metadata a été ajouté à cet élément multimédia.
La constante MediaElementEvent.METADATA_ADD définit la valeur de la propriété type de l’objet d’événement d’un événement metadataAdd.metadataRemove | Evénement |
org.osmf.events.MediaElementEventpropriété MediaElementEvent.type =
org.osmf.events.MediaElementEvent.METADATA_REMOVE| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Distribué lorsqu’un objet Metadata a été supprimé de cet élément multimédia.
La constante MediaElementEvent.METADATA_REMOVE définit la valeur de la propriété type de l’objet d’événement d’un événement metadataRemove.traitAdd | Evénement |
org.osmf.events.MediaElementEventpropriété MediaElementEvent.type =
org.osmf.events.MediaElementEvent.TRAIT_ADD| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Distribué lorsqu’une caractéristique commune est ajoutée à l’élément multimédia.
La constante MediaElementEvent.TRAIT_ADD définit la valeur de la propriété type de l’objet d’événement d’un événement traitAdd.traitRemove | Evénement |
org.osmf.events.MediaElementEventpropriété MediaElementEvent.type =
org.osmf.events.MediaElementEvent.TRAIT_REMOVE| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Distribué lorsqu’une caractéristique commune est supprimée de l’élément multimédia.
La constante MediaElementEvent.TRAIT_REMOVE définit la valeur de la propriété type de l’objet d’événement d’un événement traitRemove.Tue Jun 12 2018, 09:30 AM Z