VideoElement

包	org.osmf.elements
类	public class VideoElement
继承	VideoElement LightweightVideoElement LoadableElementBase MediaElement EventDispatcher Object

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

VideoElement 是专门为视频播放创建的媒体元素。它支持流格式和渐进式格式以及 HTTP 流和 MBR 流（对于 RTMP 和 HTTP）。

相对于 LightweightVideoElement，VideoElement 功能更为齐全。LightweightVideoElement 仅支持视频传送模式的一个子集（具体来说是指渐进式和简单的 RTMP 流模式），而 VideoElement 支持所有视频传送模式。

VideoElement 使用 NetLoader 类加载和卸载其媒体。需要自定义视频加载逻辑的开发人员可将自己的加载器传递到 LightweightVideoElement 构造函数。这些加载器应是 NetLoader 的子类。

创建和使用 LightweightVideoElement 的基本步骤：

创建新的 URLResource，该 URLResource 指向视频流的 URL 或包含要加载的视频的文件。
创建新的 NetLoader。
创建新的 VideoElement，将 NetLoader 和 URLResource 作为参数传递。
创建新的 MediaPlayer。
将 VideoElement 指定给 MediaPlayer 的 media 属性。
使用 MediaPlayer 的方法、属性和事件控制媒体。
完成有关 VideoElement 的操作后，将 MediaPlayer 的 media 属性设置为 null。这将卸载 VideoElement。

VideoElement 支持 Flash Media 标记身份验证，以通过 NetConnection 传递身份验证标记。

VideoElement 支持 Flash Player 的 DRM 实现。请注意，在开始播放之前，此元素中 DRMTrait 的 startDate、endDate 和 period 属性对应于凭证有效性。开始播放后，这些属性对应于播放时间窗口（可在 flash.net.drm.DRMVoucher 中找到）。

查看示例

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		client : NetClient [只读] 由此对象的 NetStream 使用的 NetClient。	LightweightVideoElement
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		container : IMediaContainer [只读] 此元素使用的媒体容器。	MediaElement
		currentFPS : Number [只读] 每秒显示的帧的数目。	LightweightVideoElement
		deblocking : int 表示作为后处理的一部分应用于已解码视频的滤镜的类型。	LightweightVideoElement
		defaultDuration : Number 定义元素的 TimeTrait 在加载元素的内容之前将公开的持续时间。	LightweightVideoElement
		metadataNamespaceURLs : Vector.<String> [只读] 包含存储在此 MediaElement 内的所有 Metadata 对象的命名空间 URL 的矢量。	MediaElement
		resource : MediaResourceBase 此媒体元素对其执行操作的媒体资源。	MediaElement
		smoothing : Boolean 指定在缩放视频时是否应进行平滑处理（插补数据）。	LightweightVideoElement
		traitTypes : Vector.<String> [只读] MediaTraitType 值的矢量，表示此媒体元素的特征类型。	MediaElement

受保护的属性

隐藏继承的受保护属性

显示继承的受保护属性

	属性		由以下参数定义
		loader : LoaderBase 此元素用于加载资源的 LoaderBase。	LoadableElementBase

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		VideoElement(resource:MediaResourceBase = null, loader:NetLoader = null) 构造函数。	VideoElement
		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
		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
		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
		createLoadTrait(resource:MediaResourceBase, loader:LoaderBase):org.osmf.traits:LoadTrait 子类可以覆盖此方法以返回自定义 LoadTrait 子类。	LoadableElementBase
		processLoadingState():void 当媒体元素进入 LOADING 状态时，子类可以覆盖此方法以执行处理。	LoadableElementBase
		processReadyState():void 当媒体元素进入 READY 状态时，子类可以覆盖此方法以执行处理。	LoadableElementBase
		processUnloadingState():void 当媒体元素进入 UNLOADING 状态时，子类可以覆盖此方法以执行处理。	LoadableElementBase
		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

构造函数详细信息

示例如何使用本示例

VideoElementExample.as

package
{
    import flash.display.Sprite;
    import flash.display.StageAlign;
    import flash.display.StageScaleMode;
    
    import org.osmf.elements.VideoElement;
    import org.osmf.media.MediaPlayer;
    import org.osmf.media.MediaPlayerSprite;
    import org.osmf.media.URLResource;
    import org.osmf.net.DynamicStreamingItem;
    import org.osmf.net.DynamicStreamingResource;
    
    public class VideoElementExample extends Sprite
    {
        public function VideoElementExample()
        {
            super();
            
            stage.scaleMode = StageScaleMode.NO_SCALE;
            stage.align = StageAlign.TOP_LEFT;
            
            var mediaPlayerSprite:MediaPlayerSprite = new MediaPlayerSprite();
            var videoElement:VideoElement = new VideoElement();
            var dynResource:DynamicStreamingResource = new DynamicStreamingResource("rtmp://cp67126.edgefcs.net/ondemand");
            
            dynResource.streamItems = Vector.<DynamicStreamingItem>(
                [     new DynamicStreamingItem("mp4:mediapm/ovp/content/demo/video/elephants_dream/elephants_dream_768x428_24.0fps_408kbps.mp4", 408, 768, 428)
                    , new DynamicStreamingItem("mp4:mediapm/ovp/content/demo/video/elephants_dream/elephants_dream_768x428_24.0fps_608kbps.mp4", 608, 768, 428)
                    , new DynamicStreamingItem("mp4:mediapm/ovp/content/demo/video/elephants_dream/elephants_dream_1024x522_24.0fps_908kbps.mp4", 908, 1024, 522)
                    , new DynamicStreamingItem("mp4:mediapm/ovp/content/demo/video/elephants_dream/elephants_dream_1024x522_24.0fps_1308kbps.mp4", 1308, 1024, 522)
                    , new DynamicStreamingItem("mp4:mediapm/ovp/content/demo/video/elephants_dream/elephants_dream_1280x720_24.0fps_1708kbps.mp4", 1708, 1280, 720)
                ]);
            
            videoElement.resource = dynResource;
            
            addChild(mediaPlayerSprite);
            mediaPlayerSprite.media = videoElement;    
        }    
    }
}

法律声明 | 在线隐私策略

VideoElement - AS3 OSMF

包x

语言元素

附录

包 org.osmf.elements

	`resource:MediaResourceBase` (default = `null`) — 指向 VideoElement 将使用的视频源的 URLResource。对于动态流内容，请使用 DynamicStreamingResource。

	`loader:NetLoader` (default = `null`) — 用于加载视频的 NetLoader。如果为 null，将基于资源类型创建适当的 NetLoader。