LightweightVideoElement

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

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

LightweightVideoElement 是专门为视频播放创建的媒体元素。它支持流格式和渐进式格式。

LightweightVideoElement 是 VideoElement 的一个简单替代。LightweightVideoElement 仅支持视频传送模式的一个子集（具体来说是指渐进式和简单的 RTMP 流模式），而 VideoElement 支持所有视频传送模式。

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

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

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

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

LightweightVideoElement 支持 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

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		LightweightVideoElement(resource:MediaResourceBase = null, loader:NetLoader = null) 构造函数。	LightweightVideoElement
		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

属性详细信息

client

属性

client:NetClient [只读]

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

由此对象的 NetStream 使用的 NetClient。在完成加载此对象之前一直为 null（由其进入 READY 状态的 LoadTrait 指示）。

实现
public function get client():NetClient

currentFPS

属性

currentFPS:Number [只读]

每秒显示的帧的数目。在加载完视频且播放之前一直为零。

实现
public function get currentFPS():Number

deblocking

属性

deblocking:int

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

表示作为后处理的一部分应用于已解码视频的滤镜的类型。默认值为 0，表示允许视频压缩程序根据需要应用消除马赛克的滤镜。有关消除马赛克模式的详细信息，请参阅 flash.media.Video。

实现
public function get deblocking():int
public function set deblocking(value:int):void

defaultDuration

属性

defaultDuration:Number

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

定义元素的 TimeTrait 在加载元素的内容之前将公开的持续时间。将此属性设置为正值会导致元素变为临时元素。任何其它值都将删除元素的 TimeTrait，除非加载的内容正在公开持续时间。

实现
public function get defaultDuration():Number
public function set defaultDuration(value:Number):void

smoothing

属性

smoothing:Boolean

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

指定在缩放视频时是否应进行平滑处理（插补数据）。为顺畅工作，运行时必须处于高品质模式（默认值）。默认值是 false（不进行平滑处理）。将此属性设置为 true 以利用 mipmap 图像优化。

实现
public function get smoothing():Boolean
public function set smoothing(value:Boolean):void

()

构造函数

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

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

构造函数。

参数

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

	`loader:NetLoader` (default = `null`) — 用于加载视频的 NetLoader。如果为 null，则将使用 NetLoader。

引发

ArgumentError — 如果资源不是 URLResource。

示例如何使用本示例

LightweightVideoElementExample.as

package asdoc.org.osmf.elements
{
    import flash.display.Sprite;
    import flash.display.StageAlign;
    import flash.display.StageScaleMode;
    
    import org.osmf.elements.LightweightVideoElement;
    import org.osmf.elements.VideoElement;
    import org.osmf.media.MediaPlayer;
    import org.osmf.media.MediaPlayerSprite;
    import org.osmf.media.URLResource;
    
    public class LightweightVideoElementExample extends Sprite
    {
        public function LightweightVideoElementExample()
        {
            super();
            
            stage.scaleMode = StageScaleMode.NO_SCALE;
            stage.align = StageAlign.TOP_LEFT;
            
            var mediaPlayerSprite:MediaPlayerSprite = new MediaPlayerSprite();
            var videoElement:LightweightVideoElement = new LightweightVideoElement();
            videoElement.resource = new URLResource("http://mediapm.edgesuite.net/strobe/content/test/AFaerysTale_sylviaApostol_640_500_short.flv");
            
            addChild(mediaPlayerSprite);
            mediaPlayerSprite.media = videoElement;    
        }
    }
}

法律声明 | 在线隐私策略

LightweightVideoElement - AS3 OSMF

类 x

client

currentFPS

deblocking

defaultDuration

smoothing

LightweightVideoElement