| Package | org.osmf.elements |
| Classe | public class SerialElement |
| Héritage | SerialElement  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 |
Les éléments multimédia qui forment un SerialElement sont traités comme un seul et même élément multimédia. Par exemple, si un SerialElement encapsule une séquence de vidéos, le SerialElement se comportera comme s’il s’agit d’un seul VideoElement, mais qui lit plusieurs vidéos dans une même séquence.
En règle générale, un trait sur un SerialElement est un reflet de l’enfant "actuel" de la composition. Un SerialElement lit via ses enfants en série. Alors que l’enfant actuel termine son exécution, le prochain enfant dans la séquence devient l’enfant ’actuel’. Pour un client de la classe, les modifications d’un enfant actuel au suivant sont masquées. Ils sont uniquement visibles en modifiant les traits de cette classe.
Un SerialElement sans enfant n’a aucune notion d’un enfant ’actuel’. Il ne reflète donc aucun trait. Le premier enfant qui est ajouté à un SerialElement devient immédiatement l’enfant actuel de la composition. Si l’enfant actuel est supprimé, le prochain enfant dans la séquence devient le nouvel enfant actuel, s’il existe un prochain enfant. S’il n’y a pas de prochain enfant, le premier enfant dans la séquence devient l’enfant actuel.
Il est possible de transmettre l’état "actuel" d’un enfant à un autre uniquement lorsque l’état de l’un des traits de l’enfant actuel change de telle façon que le SerialElement sache qu’il a besoin de modifier son enfant actuel. Par exemple, si chaque enfant de la séquence possède le PlayTrait, l’état "actuel" passe d’un enfant au suivant dès qu’un enfant a terminé sa lecture et la propriété PlayState du PlayTrait passe de PLAYING à STOPPED. Un autre exemple : si le client d’un SerialElement avec un SeekTrait effectue une recherche d’un point à un autre, l’état "actuel" est susceptible de changer d’un enfant vers un autre.
Voici comment chaque trait est exprimé en série :
- 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 représente le trait de l’enfant actuel pouvant être mis en mémoire tampon dans la séquence. Toutes les modifications s’appliquent uniquement à l’enfant actuel.
- DisplayObjectTrait - Le trait composite représente le DisplayObjectTrait de l’enfant actuel dans la séquence.
- DRMTrait - Le trait composite représente le DRMTrait de l’enfant actuel dans la séquence.
- DVRTrait - Le trait composite représente le DVRTrait de l’enfant actuel dans la séquence.
- DynamicStreamTrait - Le trait composite représente le DynamicStreamTrait de l’enfant actuel dans la séquence. Toutes les modifications s’appliquent uniquement à l’enfant actuel.
- LoadTrait - Le trait composite représente le LoadTrait de l’enfant actuel dans la séquence. Toutes les modifications s’appliquent uniquement à l’enfant actuel.
- PlayTrait - Le trait composite représente le PlayTrait de l’enfant actuel dans la séquence. Toutes les modifications s’appliquent uniquement à l’enfant actuel.
- SeekTrait - Le trait composite représente le SeekTrait de l’enfant actuel dans la séquence. Une opération de recherche peut modifier l’enfant actuel.
- TimeTrait : la durée indiquée de TimeTrait d’un SerialElement est la somme de l’enfant en cours et des enfants terminés uniquement. La valeur indiquée ne reflète pas la somme de la durée de tous les enfants.
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 | |
| currentChild : MediaElement [lecture seule]
L’enfant actuellement actif de ce SerialElement. | SerialElement | ||
| 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éthode | Défini par | ||
|---|---|---|---|
Constructeur. | SerialElement | ||
|
Ajoute l’enfant spécifié à la fin de la liste. | CompositeElement | |
|
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 | |
|
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 | |
|
Obtient l’enfant qui se trouve à l’index spécifié. | CompositeElement | |
|
Renvoie l’index de l’enfant s’il se trouve dans la liste telle que getChildAt(index) == child. | CompositeElement | |
|
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 l’enfant indiqué et le renvoie. | CompositeElement | |
|
Supprime l’enfant qui se trouve à l’index spécifié et le renvoie. | CompositeElement | |
|
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 | |
currentChild | propriété |
currentChild:MediaElement [lecture seule] L’enfant actuellement actif de ce SerialElement.
Implémentation
public function get currentChild():MediaElementSerialElement | () | Constructeur |
public function SerialElement()| 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.
package
{
import flash.display.Sprite;
import flash.display.StageAlign;
import flash.display.StageScaleMode;
import org.osmf.elements.LightweightVideoElement;
import org.osmf.elements.SerialElement;
import org.osmf.media.MediaPlayerSprite;
import org.osmf.media.URLResource;
public class SerialElementExample extends Sprite
{
public function SerialElementExample()
{
super();
stage.scaleMode = StageScaleMode.NO_SCALE;
stage.align = StageAlign.TOP_LEFT;
var mediaPlayerSprite:MediaPlayerSprite = new MediaPlayerSprite();
var serialElement:SerialElement = new SerialElement();
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");
serialElement.addChild(videoElement);
serialElement.addChild(videoElement2);
addChild(mediaPlayerSprite);
mediaPlayerSprite.media = serialElement;
}
}
}
Tue Jun 12 2018, 09:30 AM Z