MediaElement

包	org.osmf.media
类	public class MediaElement
继承	MediaElement EventDispatcher Object
子类	BeaconElement, CompositeElement, HTMLElement, LoadableElementBase, ProxyElement

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

MediaElement 表示统一的媒体体验。可能包含简单的媒体项，例如视频或声音。不同的实例（或子类）可以表示不同类型的媒体。MediaElement 也可以表示由多个项（例如视频、广告条幅、SWF 覆盖、背景页面标记等）组成的复杂的媒体体验。

媒体元素以编程方式封装一组媒体特征和状态空间。媒体特征表示媒体元素的功能并且本质上是动态的。媒体元素有时可以搜索，有时却不可搜索。例如，如果媒体元素是包含不可跳过的广告的视频序列，则会发生这种情况。

媒体元素对媒体资源执行操作。例如，如果媒体元素表示视频播放器，则媒体资源可以将 URL 封装到视频流。如果媒体元素表示复杂的媒体组合，则媒体资源 URL 可能为引用媒体组合中使用的多种资源的文档。

相关 API 元素

MediaTraitBase
MediaResourceBase

公共属性

隐藏继承的公共属性

显示继承的公共属性

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

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		MediaElement() 构造函数。	MediaElement
		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
		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

属性详细信息

metadataNamespaceURLs

属性

metadataNamespaceURLs:Vector.<String> [只读]

包含存储在此 MediaElement 内的所有 Metadata 对象的命名空间 URL 的矢量。

实现
public function get metadataNamespaceURLs():Vector.<String>

构造函数详细信息

方法详细信息

事件详细信息

法律声明 | 在线隐私策略

MediaElement - AS3 OSMF

包x

语言元素

附录

包 org.osmf.media

container

metadataNamespaceURLs

resource

traitTypes

addMetadata

addTrait

getMetadata

getTrait

hasTrait

removeMetadata

removeTrait

setupTraits

containerChange

mediaError

mediaInfo

metadataAdd

metadataRemove

traitAdd

traitRemove

	`namespaceURL:String` — 用于存储 Metadata 的命名空间 URL。

	`metadata:Metadata` — 要添加的 Metadata。

	`type:String` — 要添加的媒体特征的 MediaTraitType。

	`instance:org.osmf.traits:MediaTraitBase` — 要添加的媒体特征。