包 | org.osmf.elements |
类 | public class AudioElement |
继承 | AudioElement LoadableElementBase MediaElement EventDispatcher Object |
语言版本: | ActionScript 3.0 |
产品版本: | OSMF 1.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
AudioElement 可以加载和显示任何 MP3 或 AAC 文件。它支持通过 HTTP 的 MP3 文件,以及来自 Flash Media Server 的只有音频的流。
创建和使用 AudioElement 的基本步骤:
- 创建新的 URLResource,该 URLResource 指向音频流的 URL 或包含要加载的声音的文件。
- 创建新的 AudioElement,将 URLResource 作为参数传递。
- 创建新的 MediaPlayer。
- 将 AudioElement 指定给 MediaPlayer 的
media
属性。 - 使用 MediaPlayer 的方法、属性和事件控制媒体。
- 完成有关 AudioElement 的操作后,将 MediaPlayer 的
media
属性设置为 null。这将卸载 AudioElement。
相关 API 元素
公共属性
属性 | 由以下参数定义 | ||
---|---|---|---|
constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | ||
container : IMediaContainer [只读]
此元素使用的媒体容器。 | MediaElement | ||
defaultDuration : Number
定义元素的 TimeTrait 在加载元素的内容之前将公开的持续时间。 | AudioElement | ||
metadataNamespaceURLs : Vector.<String> [只读]
包含存储在此 MediaElement 内的所有 Metadata 对象的命名空间 URL 的矢量。 | MediaElement | ||
resource : MediaResourceBase
此媒体元素对其执行操作的媒体资源。 | MediaElement | ||
traitTypes : Vector.<String> [只读]
MediaTraitType 值的矢量,表示此媒体元素的特征类型。 | MediaElement |
受保护的属性
公共方法
方法 | 由以下参数定义 | ||
---|---|---|---|
构造函数。 | AudioElement | ||
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 |
受保护的方法
属性详细信息
defaultDuration | 属性 |
构造函数详细信息
AudioElement | () | 构造函数 |
public function AudioElement(resource:URLResource = null, loader:LoaderBase = null)
语言版本: | ActionScript 3.0 |
产品版本: | OSMF 1.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
构造函数。
参数resource:URLResource (default = null ) — 指向 AudioElement 将使用的音频源的 URLResource。
| |
loader:LoaderBase (default = null ) — 用于加载声音的加载器。这必须是 NetLoader(用于流式音频)或 SoundLoader(用于渐进式音频)。如果为 null,将根据资源类型创建适当的加载器。
|
引发
ArgumentError — 如果加载器既不是 NetLoader 也不是 SoundLoader。
|
相关 API 元素
示例 如何使用本示例
AudioElementExample.as
package { import flash.display.Sprite; import org.osmf.elements.AudioElement; import org.osmf.media.MediaPlayer; import org.osmf.media.URLResource; public class AudioElementExample extends Sprite { public function AudioElementExample() { super(); var mediaPlayer:MediaPlayer = new MediaPlayer(); var audioElement:AudioElement = new AudioElement(); audioElement.resource = new URLResource("http://mediapm.edgesuite.net/osmf/content/test/train_1500.mp3"); mediaPlayer.media = audioElement; } } }
Tue Jun 12 2018, 11:04 AM Z