| 包 | 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 |
媒体元素以编程方式封装一组媒体特征和状态空间。媒体特征表示媒体元素的功能并且本质上是动态的。媒体元素有时可以搜索，有时却不可搜索。例如，如果媒体元素是包含不可跳过的广告的视频序列，则会发生这种情况。
媒体元素对媒体资源执行操作。例如，如果媒体元素表示视频播放器，则媒体资源可以将 URL 封装到视频流。如果媒体元素表示复杂的媒体组合，则媒体资源 URL 可能为引用媒体组合中使用的多种资源的文档。
相关 API 元素
MediaTraitBase
MediaResourceBase
MediaResourceBase
公共属性
隐藏继承的公共属性
显示继承的公共属性| 属性 | 由以下参数定义 | ||
|---|---|---|---|
 | constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| container : IMediaContainer [只读]
此元素使用的媒体容器。 | MediaElement | ||
| metadataNamespaceURLs : Vector.<String> [只读]
包含存储在此 MediaElement 内的所有 Metadata 对象的命名空间 URL 的矢量。 | MediaElement | ||
| resource : MediaResourceBase
此媒体元素对其执行操作的媒体资源。 | MediaElement | ||
| traitTypes : Vector.<String> [只读]
MediaTraitType 值的矢量，表示此媒体元素的特征类型。 | MediaElement | ||
公共方法
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
构造函数。 | MediaElement | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。 | EventDispatcher | |
将 Metadata 对象添加到指定命名空间 URL 下的此 MediaElement 中。 | MediaElement | ||
|
将事件调度到事件流中。 | EventDispatcher | |
返回存储在此 MediaElement 下具有指定命名空间 URL 的 Metadata 对象。 | MediaElement | ||
返回指定类型的媒体特征。 | MediaElement | ||
|
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | |
|
表示对象是否已经定义了指定的属性。 | Object | |
确定此媒体元素是否包含指定类型的媒体特征。 | MediaElement | ||
|
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
|
表示指定的属性是否存在、是否可枚举。 | Object | |
|
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | |
删除存储在此 MediaElement 下具有指定命名空间 URL 的 Metadata 对象。 | MediaElement | ||
|
设置循环操作动态属性的可用性。 | Object | |
|
返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。 | Object | |
|
返回指定对象的字符串表示形式。 | Object | |
|
返回指定对象的原始值。 | Object | |
|
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。 | EventDispatcher | |
受保护的方法
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
将新的媒体特征添加到此媒体元素。 | MediaElement | ||
从此媒体元素中删除媒体特征。 | MediaElement | ||
设置此媒体元素的特征。 | MediaElement | ||
事件
| 事件 | 摘要 | 由以下参数定义 | ||
|---|---|---|---|---|
| [广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。 | EventDispatcher | ||
| 在元素的容器属性发生变化时调度。 | MediaElement | |||
| [广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。 | EventDispatcher | ||
| 在发生影响媒体元素的操作的错误时调度。 | MediaElement | |||
| 当影响媒体元素操作的信息可用时调度。 | MediaElement | |||
| 在将 Metadata 对象添加到此媒体元素时调度。 | MediaElement | |||
| 在从此媒体元素中删除 Metadata 对象时调度。 | MediaElement | |||
| 在将某一特征添加到媒体元素时调度。 | MediaElement | |||
| 在从媒体元素中删除某一特征时调度。 | MediaElement | |||
属性详细信息
container | 属性 |
container:IMediaContainer [只读] | 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
此元素使用的媒体容器。
实现
public function get container():IMediaContainermetadataNamespaceURLs | 属性 |
resource | 属性 |
resource:MediaResourceBase| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
此媒体元素对其执行操作的媒体资源。
实现
public function get resource():MediaResourceBase public function set resource(value:MediaResourceBase):voidtraitTypes | 属性 |
构造函数详细信息
MediaElement | () | 构造函数 |
public function MediaElement()| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
构造函数。
方法详细信息
addMetadata | () | 方法 |
public function addMetadata(namespaceURL:String, metadata:Metadata):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
将 Metadata 对象添加到指定命名空间 URL 下的此 MediaElement 中。
参数
namespaceURL:String — 用于存储 Metadata 的命名空间 URL。
| |
metadata:Metadata — 要添加的 Metadata。
|
引发
ArgumentError — 如果 namespaceURL 或 Metadata 为 null。
|
addTrait | () | 方法 |
protected function addTrait(type:String, instance:org.osmf.traits:MediaTraitBase):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
将新的媒体特征添加到此媒体元素。如果成功，则调度 MediaElementEvent。
参数
type:String — 要添加的媒体特征的 MediaTraitType。
| |
instance:org.osmf.traits:MediaTraitBase — 要添加的媒体特征。
|
引发
ArgumentError — 如果任一参数为 null，或者如果指定类型和媒体特征的类型不匹配，或者如果已添加特定特征类的其它实例。
|
getMetadata | () | 方法 |
public function getMetadata(namespaceURL:String):Metadata| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
返回存储在此 MediaElement 下具有指定命名空间 URL 的 Metadata 对象。
参数
namespaceURL:String — 要检索的 Metadata 对象的命名空间 URL。
|
Metadata |
引发
ArgumentError — 如果 namespaceURL 为 null。
|
getTrait | () | 方法 |
public function getTrait(type:String):org.osmf.traits:MediaTraitBase| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
返回指定类型的媒体特征。
参数
type:String — 要返回的媒体特征的 MediaTraitType。
|
org.osmf.traits:MediaTraitBase — 检索的特征；如果此媒体元素中不存在此类特征，则为 null。
|
引发
ArgumentError — 如果此参数为 null。
|
hasTrait | () | 方法 |
public function hasTrait(type:String):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
确定此媒体元素是否包含指定类型的媒体特征。
参数
type:String — 要检查的媒体特征的 MediaTraitType。
|
Boolean — 如果此媒体元素包含指定类的媒体特征，则返回 true，否则返回 false。
|
引发
ArgumentError — 如果此参数为 null。
|
removeMetadata | () | 方法 |
public function removeMetadata(namespaceURL:String):Metadata| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
删除存储在此 MediaElement 下具有指定命名空间 URL 的 Metadata 对象。
参数
namespaceURL:String — 要删除的 Metadata 的命名空间 URL。
|
Metadata |
引发
ArgumentError — 如果 namespaceURL 为 null。
|
removeTrait | () | 方法 |
protected function removeTrait(type:String):org.osmf.traits:MediaTraitBase| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
从此媒体元素中删除媒体特征。如果成功，则调度 MediaElementEvent。
参数
type:String — 要删除的媒体特征的 MediaTraitType。
|
org.osmf.traits:MediaTraitBase — 删除的特征；如果没有删除任何特征，则为 null。
|
引发
ArgumentError — 如果此参数为 null。
|
setupTraits | () | 方法 |
protected function setupTraits():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
设置此媒体元素的特征。在构建期间发生。子类应覆盖此方法并针对其自己的各个特征调用 addTrait。
事件详细信息
containerChange | 事件 |
事件对象类型:
属性 ContainerChangeEvent.type =
org.osmf.events.ContainerChangeEvent属性 ContainerChangeEvent.type =
org.osmf.events.ContainerChangeEvent.CONTAINER_CHANGE| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
在元素的容器属性发生变化时调度。
ContainerChangeEvent.CONTAINER_CHANGE 常量为 containerChange 事件定义事件对象的 type 属性的值。mediaError | 事件 |
事件对象类型:
属性 MediaErrorEvent.type =
org.osmf.events.MediaErrorEvent属性 MediaErrorEvent.type =
org.osmf.events.MediaErrorEvent.MEDIA_ERROR| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
在发生影响媒体元素的操作的错误时调度。
MediaErrorEvent.MEDIA_ERROR 常量为 mediaError 事件定义事件对象的 type 属性的值。mediaInfo | 事件 |
事件对象类型:
属性 MediaErrorEvent.type =
org.osmf.events.MediaErrorEvent属性 MediaErrorEvent.type =
org.osmf.events.MediaErrorEvent.MEDIA_INFO| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 2.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
当影响媒体元素操作的信息可用时调度。MEDIA_INFO 事件是非致命事件。
metadataAdd | 事件 |
事件对象类型:
属性 MediaElementEvent.type =
org.osmf.events.MediaElementEvent属性 MediaElementEvent.type =
org.osmf.events.MediaElementEvent.METADATA_ADD| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
在将 Metadata 对象添加到此媒体元素时调度。
MediaElementEvent.METADATA_ADD 常量为 metadataAdd 事件定义事件对象的 type 属性的值。metadataRemove | 事件 |
事件对象类型:
属性 MediaElementEvent.type =
org.osmf.events.MediaElementEvent属性 MediaElementEvent.type =
org.osmf.events.MediaElementEvent.METADATA_REMOVE| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
在从此媒体元素中删除 Metadata 对象时调度。
MediaElementEvent.METADATA_REMOVE 常量为 metadataRemove 事件定义事件对象的 type 属性的值。traitAdd | 事件 |
事件对象类型:
属性 MediaElementEvent.type =
org.osmf.events.MediaElementEvent属性 MediaElementEvent.type =
org.osmf.events.MediaElementEvent.TRAIT_ADD| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
在将某一特征添加到媒体元素时调度。
MediaElementEvent.TRAIT_ADD 常量为 traitAdd 事件定义事件对象的 type 属性的值。traitRemove | 事件 |
事件对象类型:
属性 MediaElementEvent.type =
org.osmf.events.MediaElementEvent属性 MediaElementEvent.type =
org.osmf.events.MediaElementEvent.TRAIT_REMOVE| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
在从媒体元素中删除某一特征时调度。
MediaElementEvent.TRAIT_REMOVE 常量为 traitRemove 事件定义事件对象的 type 属性的值。Tue Jun 12 2018, 11:04 AM Z