ParallelElement

Package	org.osmf.elements
Classe	public class ParallelElement
Héritage	ParallelElement CompositeElement MediaElement EventDispatcher Object

Version du langage:

ActionScript 3.0

Version du produit:

OSMF 1.0

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

ParallelElement est une composition multimédia dont les éléments sont présentés en parallèle (ils sont exécutés en même temps).

Les éléments multimédia qui forment un ParallelElement sont traités comme un seul et même élément multimédia. Par exemple, si un ParallelElement encapsule une image et un morceau de données audio, le ParallelElement se comportera comme s’il s’agit d’un seul MediaElement avec les caractéristiques audio du fichier audio et les caractéristiques d’affichage du fichier image.

En règle générale, un trait sur un ParallelElement est un composite ou une combinaison fusionnée de ce trait sur tous ses enfants. Lorsqu’un nouvel élément multimédia est ajouté en tant qu’enfant de la composition multimédia, ses traits ou les traits du composite sont ajustés pour rendre les traits de la composition multimédia et ses enfants cohérents.

En exemple du premier cas, considérez AudioTrait. Si un client ajoute un nouveau MediaElement avec un volume du AudioTrait sur 0,5 à un ParallelElement avec un volume du AudioTrait sur 0,3, le volume du AudioTrait du MediaElement enfant est défini sur 0,3 pour être compatible avec le trait du ParallelElement.

En exemple du second cas, considérez BufferTrait. Si le MediaElement ajouté a un BufferTrait, le BufferTrait du ParallelElement peut avoir besoin de "grandir" si le nouveau MediaElement possède une mémoire tampon plus grande que ses autres enfants. Dans ce cas, le tampon du ParallelElement s’adapte à la taille de son nouvel enfant.

Voici comment chaque trait est exprimé en parallèle :

AudioTrait - Le trait composite conserve les propriétés audio de tous les enfants synchronisés. Lorsque le volume d’un élément enfant (ou l’élément composite) est modifié, le volume est modifié de façon similaire pour tous les enfants audio (et pour le trait composite).
BufferTrait - Le trait composite est mis en mémoire tampon si un enfant est mis en mémoire tampon. La longueur et la taille correspondent à celles de l’enfant avec la mémoire tampon la plus longue. Sa position de départ est la position de départ minimum (première) de tous ses enfants.
DisplayObjectTrait - Si au moins un enfant du composite possède DisplayObjectTrait, les dimensions spatiales du trait composite sont définies par le cadre de sélection du DisplayObject référencé par la propriété displayObject du DisplayObjectTrait du composite. Si aucun des enfants du composite ne possède le DisplayObjectTrait, la mediaWidth du trait du composite correspond à la largeur de son enfant le plus large et sa mediaHeight à la hauteur de son enfant le plus grand.
DRMTrait - Le trait composite tente de conserver l’état DRM de tous les enfants synchronisés. Lorsqu’un élément enfant est authentifié, tous les enfants pour lesquels DRM est activé sont authentifiés en même temps.
DVRTrait - Le trait composite tente de conserver l’état DVR de tous les enfants synchronisés.
DynamicStreamTrait - Le trait composite tente de conserver l’état de flux dynamique de tous les enfants synchronisés. De façon plus spécifique, il tente de conserver la même propriété autoSwitch pour tous les éléments et les éléments de flux actuels dans une fourchette de vitesses de transmission similaire.
LoadTrait - Le trait composite conserve l’état de chargement de tous les enfants synchronisés. Lorsqu’un élément enfant (ou l’élément composite) est chargé, tous les enfants pouvant être chargés (et l’élément composite) sont chargés en même temps.
PlayTrait - Le trait composite conserve les états pause et lecture de tous les enfants synchronisés. Lorsqu’un élément enfant (ou l’élément composite) est sur pause, tous les enfants pouvant être mis sur pause (et l’élément composite) sont mis sur pause en même temps. Lorsqu’un élément enfant (ou l’élément composite) est lu, tous les enfants pouvant être lus (et l’élément composite) sont lus en même temps.
SeekTrait - Le trait composite conserve l’état de recherche de tous les enfants synchronisés. Lorsqu’un élément enfant (ou l’élément composite) effectue une recherche, tous les enfants pouvant faire l’objet d’une recherche (et l’élément composite) effectuent cette recherche en même temps.
TimeTrait - Le trait composite représente un montage qui encapsule les montages de tous les enfants. Sa durée est la durée maximale de tous les enfants. Sa position est maintenue en synchronisation pour tous les enfants, avec la mise en garde que la position ne sera jamais supérieure à sa durée.

Consulter les exemples

Propriétés publiques

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
		numChildren : int [lecture seule] Le nombre de MediaElements enfant dans cette composition multimédia.	CompositeElement
		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éthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		ParallelElement() Constructeur.	ParallelElement
		addChild(child:MediaElement):MediaElement Ajoute l’enfant spécifié à la fin de la liste.	CompositeElement
		addChildAt(child:MediaElement, index:Number):MediaElement Ajoute l’enfant à la liste à l’index spécifié.	CompositeElement
		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
		addMetadata(namespaceURL:String, metadata:Metadata):void Ajoute un objet Metadata à ce MediaElement sous l’URL d’espace de noms spécifié.	MediaElement
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		getChildAt(index:int):MediaElement Obtient l’enfant qui se trouve à l’index spécifié.	CompositeElement
		getChildIndex(child:MediaElement):int Renvoie l’index de l’enfant s’il se trouve dans la liste telle que getChildAt(index) == child.	CompositeElement
		getMetadata(namespaceURL:String):Metadata Renvoie l’objet Metadata qui est stocké sous ce MediaElement avec l’URL d’espace de noms indiqué.	MediaElement
		getTrait(type:String):org.osmf.traits:MediaTraitBase Renvoie le trait de support du type spécifié.	MediaElement
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		hasTrait(type:String):Boolean Détermine si cet élément média possède une caractéristique de média du type spécifié.	MediaElement
		isPrototypeOf(theClass:Object):Boolean 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
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		removeChild(child:MediaElement):MediaElement Supprime l’enfant indiqué et le renvoie.	CompositeElement
		removeChildAt(index:int):MediaElement Supprime l’enfant qui se trouve à l’index spécifié et le renvoie.	CompositeElement
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	EventDispatcher
		removeMetadata(namespaceURL:String):Metadata Supprime l’objet Metadata stocké sous ce MediaElement avec l’URL d’espace de noms indiqué.	MediaElement
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object
		willTrigger(type:String):Boolean 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éthodes protégées

Masquer les méthodes protégées héritées

Afficher les méthodes protégées héritées

	Méthode		Défini par
		addTrait(type:String, instance:org.osmf.traits:MediaTraitBase):void Ajoute une nouvelle caractéristique commune de média à cet élément multimédia.	MediaElement
		removeTrait(type:String):org.osmf.traits:MediaTraitBase Supprime une nouvelle caractéristique commune de média de cet élément multimédia.	MediaElement
		setupTraits():void Définit les traits de cet élément multimédia.	MediaElement

Evénements

Cliquez pour plus d’informations sur les événements

Masquer les événements hérités

Afficher les événements hérités

	Synthèse	Défini par
activate	[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.	EventDispatcher
containerChange	Distribué lorsque la propriété container de l’élément a été modifiée.	MediaElement
deactivate	[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.	EventDispatcher
mediaError	Distribué lorsqu’une erreur entraînant une dégradation du fonctionnement de l’élément multimédia se produit.	MediaElement
mediaInfo	Distribué lorsque des infos ayant un impact sur le fonctionnement de l’élément multimédia sont disponibles.	MediaElement
metadataAdd	Distribué lorsqu’un objet Metadata a été ajouté à cet élément multimédia.	MediaElement
metadataRemove	Distribué lorsqu’un objet Metadata a été supprimé de cet élément multimédia.	MediaElement
traitAdd	Distribué lorsqu’une caractéristique commune est ajoutée à l’élément multimédia.	MediaElement
traitRemove	Distribué lorsqu’une caractéristique commune est supprimée de l’élément multimédia.	MediaElement

Détails du constructeur

()

Constructeur

public function ParallelElement()

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.

Exemples Comment utiliser cet exemple

ParallelElementExample.as

package
{
    import flash.display.Sprite;
    import flash.display.StageAlign;
    import flash.display.StageScaleMode;
    
    import org.osmf.elements.LightweightVideoElement;
    import org.osmf.elements.ParallelElement;
    import org.osmf.elements.VideoElement;
    import org.osmf.layout.LayoutMetadata;
    import org.osmf.layout.LayoutMode;
    import org.osmf.media.MediaPlayer;
    import org.osmf.media.MediaPlayerSprite;
    import org.osmf.media.URLResource;
    
    public class ParallelElementExample extends Sprite
    {
        public function ParallelElementExample()
        {
            super();
            
            stage.scaleMode = StageScaleMode.NO_SCALE;
            stage.align = StageAlign.TOP_LEFT;
            
            var mediaPlayerSprite:MediaPlayerSprite = new MediaPlayerSprite();
            var parallelElement:ParallelElement = new ParallelElement();
                        
            var videoElement:LightweightVideoElement = new LightweightVideoElement();
            videoElement.resource = new URLResource("http://mediapm.edgesuite.net/strobe/content/test/AFaerysTale_sylviaApostol_640_500_short.flv");
            
            var videoElement2:LightweightVideoElement = new LightweightVideoElement();
            videoElement2.resource = new URLResource("http://mediapm.edgesuite.net/strobe/content/test/elephants_dream_768x428_24_short.flv");
                        
            parallelElement.addChild(videoElement);
            parallelElement.addChild(videoElement2);
            
            // Add a vertical layout
            var layout:LayoutMetadata = new LayoutMetadata();
            layout.layoutMode = LayoutMode.VERTICAL;
            parallelElement.addMetadata(LayoutMetadata.LAYOUT_NAMESPACE, layout);            
            
            addChild(mediaPlayerSprite);
            mediaPlayerSprite.media = parallelElement;    
            
        }
    }
}

Informations juridiques | Politique de confidentialité en ligne

ParallelElement - AS3 OSMF

Classes x

ParallelElement