ParallelElement

包	org.osmf.elements
类	public class ParallelElement
继承	ParallelElement CompositeElement MediaElement EventDispatcher Object

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

ParallelElement 是一个媒体组合，其元素平行（并行）显示。

组成 ParallelElement 的媒体元素被视为单个统一的媒体元素。例如，如果 ParallelElement 封装一个图像和一段音频，则 ParallelElement 的行为等同于它是一个具有音频文件的音频特征以及图像文件的显示特征的 MediaElement 的行为。

通常，ParallelElement 的特征是其所有子级的特征的组合或合并后的组合。当将新媒体元素添加为媒体组合的子级时，将调整其特征或组合的特征以使媒体组合的特征与其子级的特征保持一致。

请考虑将 AudioTrait 作为第一种情况的示例。如果客户端将新 MediaElement（其 AudioTrait 音量为 0.5）添加到 ParallelElement（其 AudioTrait 音量为 0.3），则会将子级 MediaElement 的 AudioTrait 音量设置为 0.3 以与 ParallelElement 的特征保持一致。

请考虑将 BufferTrait 作为第二种情况的示例。如果添加的 MediaElement 具有 BufferTrait，则当新 MediaElement 的缓冲区大于任何其它子级的缓冲区时，ParallelElement 的 BufferTrait 可能需要“增大”。在这种情况下，ParallelElement 的缓冲区将调整到其新子级的大小。

以下是平行排列的各个特征的表示方式：

AudioTrait – 组合特征使所有子级的有声属性保持同步。更改子元素（或组合元素）的音量时，将同时更改所有有声子级（和组合特征）的音量。
BufferTrait – 在缓冲任何子级时，都将缓冲组合特征。其长度和大小是缓冲区最长的子级的长度和大小。其起始位置是所有其子级中起始位置的最小值（最早起始位置）。
DisplayObjectTrait – 如果组合的一个或多个子级具有 DisplayObjectTrait，则组合特征的空间尺寸由该组合的 DisplayObjectTrait 的 displayObject 属性引用的 DisplayObject 的边界框定义。如果任何组合的子级都不具有 DisplayObjectTrait，则组合特征的 mediaWidth 是其最宽的子级的宽度，其 mediaHeight 是其最高的子级的高度。
DRMTrait – 组合特征尝试使所有子级的 DRM 状态保持同步。对一个子元素进行身份验证时，将同时对所有启用 DRM 的子级进行身份验证。
DVRTrait - 组合特征尝试使所有子级的 DVR 状态保持同步。
DynamicStreamTrait – 组合特征尝试使所有子级的动态流状态保持同步。具体而言，它尝试使所有元素的 autoSwitch 属性都相同，且当前流项位于相似的比特率范围内。
LoadTrait - 组合特征尝试使所有子级的加载状态保持同步。加载子元素（或组合元素）时，将同时加载所有可加载的子级（和组合元素）。
PlayTrait - 组合特征使所有子级的暂停和播放状态保持同步。暂停一个子元素（或组合元素）时，将同时暂停所有可暂停的子级（和组合元素）。播放一个子元素（或组合元素）时，将同时播放所有可播放的子级（和组合元素）。
SeekTrait - 组合特征使所有子级的搜索状态保持同步。对一个子元素（或组合元素）执行搜索时，将同时对所有可搜索的子级（和组合元素）执行相同搜索。
TimeTrait – 组合特征表示一个时间轴，它可以封装所有子级的时间轴。其持续时间是所有子级持续时间的最大值。其位置对所有子级保持同步，显而易见的是子级的位置绝不会大于其持续时间。

查看示例

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		container : IMediaContainer [只读] 此元素使用的媒体容器。	MediaElement
		metadataNamespaceURLs : Vector.<String> [只读] 包含存储在此 MediaElement 内的所有 Metadata 对象的命名空间 URL 的矢量。	MediaElement
		numChildren : int [只读] 此媒体组合中子级 MediaElement 的数目。	CompositeElement
		resource : MediaResourceBase 此媒体元素对其执行操作的媒体资源。	MediaElement
		traitTypes : Vector.<String> [只读] MediaTraitType 值的矢量，表示此媒体元素的特征类型。	MediaElement

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		ParallelElement() 构造函数。	ParallelElement
		addChild(child:MediaElement):MediaElement 将指定的子级添加到列表的末尾。	CompositeElement
		addChildAt(child:MediaElement, index:Number):MediaElement 将子级添加到列表的指定索引处。	CompositeElement
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		addMetadata(namespaceURL:String, metadata:Metadata):void 将 Metadata 对象添加到指定命名空间 URL 下的此 MediaElement 中。	MediaElement
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		getChildAt(index:int):MediaElement 获取指定索引处的子级。	CompositeElement
		getChildIndex(child:MediaElement):int 如果子级位于列表中（这样的话 getChildAt(index) == child），则返回该子级的索引。	CompositeElement
		getMetadata(namespaceURL:String):Metadata 返回存储在此 MediaElement 下具有指定命名空间 URL 的 Metadata 对象。	MediaElement
		getTrait(type:String):org.osmf.traits:MediaTraitBase 返回指定类型的媒体特征。	MediaElement
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		hasTrait(type:String):Boolean 确定此媒体元素是否包含指定类型的媒体特征。	MediaElement
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeChild(child:MediaElement):MediaElement 删除指定的子级并返回该子级。	CompositeElement
		removeChildAt(index:int):MediaElement 删除指定索引处的子级并返回该子级。	CompositeElement
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		removeMetadata(namespaceURL:String):Metadata 删除存储在此 MediaElement 下具有指定命名空间 URL 的 Metadata 对象。	MediaElement
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

受保护的方法

隐藏继承的受保护方法

显示继承的受保护方法

	方法		由以下参数定义
		addTrait(type:String, instance:org.osmf.traits:MediaTraitBase):void 将新的媒体特征添加到此媒体元素。	MediaElement
		removeTrait(type:String):org.osmf.traits:MediaTraitBase 从此媒体元素中删除媒体特征。	MediaElement
		setupTraits():void 设置此媒体元素的特征。	MediaElement

事件

单击此处了解有关事件的更多信息

隐藏继承的事件

显示继承的事件

	摘要	由以下参数定义
activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
containerChange	在元素的容器属性发生变化时调度。	MediaElement
deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher
mediaError	在发生影响媒体元素的操作的错误时调度。	MediaElement
mediaInfo	当影响媒体元素操作的信息可用时调度。	MediaElement
metadataAdd	在将 Metadata 对象添加到此媒体元素时调度。	MediaElement
metadataRemove	在从此媒体元素中删除 Metadata 对象时调度。	MediaElement
traitAdd	在将某一特征添加到媒体元素时调度。	MediaElement
traitRemove	在从媒体元素中删除某一特征时调度。	MediaElement

构造函数详细信息

()

构造函数

public function ParallelElement()

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

构造函数。

示例如何使用本示例

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;    
            
        }
    }
}

法律声明 | 在线隐私策略

ParallelElement - AS3 OSMF

类 x

ParallelElement