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

构造函数详细信息

()

构造函数

public function VideoElement(resource:MediaResourceBase = null, loader:NetLoader = null)

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

构造函数。

参数

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

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

引发

ArgumentError — 如果资源不是 URLResource。

示例如何使用本示例

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

VideoElement