| 包 | org.osmf.traits |
| 类 | public class LoadTrait |
| 继承 | LoadTrait  MediaTraitBase EventDispatcher Object |
| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
如果 hasTrait(MediaTraitType.LOAD) 返回 true，则使用 MediaElement.getTrait(MediaTraitType.LOAD) 方法获取一个此类型的对象。
相关 API 元素
公共属性
隐藏继承的公共属性
显示继承的公共属性| 属性 | 由以下参数定义 | ||
|---|---|---|---|
| bytesLoaded : Number [只读]
已加载的数据的字节数。 | LoadTrait | ||
| bytesTotal : Number [只读]
正加载的数据的总大小（以字节为单位）。 | LoadTrait | ||
 | constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| loadState : String [只读]
此特征的加载状态。 | LoadTrait | ||
| resource : MediaResourceBase [只读]
表示要加载到此 LoadTrait 中的媒体片段的资源。 | LoadTrait | ||
| traitType : String [只读]
此特征的 MediaTraitType。 | MediaTraitBase | |
公共方法
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
构造函数。 | LoadTrait | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。 | EventDispatcher | |
|
将事件调度到事件流中。 | EventDispatcher | |
|
处理此特征使用的任何资源。 | MediaTraitBase | |
|
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | |
|
表示对象是否已经定义了指定的属性。 | Object | |
|
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
将此媒体加载到此 LoadTrait。 | LoadTrait | ||
|
表示指定的属性是否存在、是否可枚举。 | Object | |
|
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | |
|
设置循环操作动态属性的可用性。 | Object | |
|
返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。 | Object | |
|
返回指定对象的字符串表示形式。 | Object | |
卸载此 LoadTrait。 | LoadTrait | ||
|
返回指定对象的原始值。 | Object | |
|
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。 | EventDispatcher | |
受保护的方法
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
在 bytesLoaded 属性更改后立即调用。 | LoadTrait | ||
在 bytesLoaded 属性更改的前一刻调用。 | LoadTrait | ||
在 bytesTotal 属性更改后立即调用。 | LoadTrait | ||
在 bytesTotal 属性更改的前一刻调用。 | LoadTrait | ||
在 loadState 属性更改后立即调用。 | LoadTrait | ||
在 loadState 属性更改的前一刻调用。 | LoadTrait | ||
设置已加载的数据的字节数。 | LoadTrait | ||
设置正加载的数据的总大小（以字节为单位）。 | LoadTrait | ||
设置此 LoadTrait 的加载状态。 | LoadTrait | ||
事件
| 事件 | 摘要 | 由以下参数定义 | ||
|---|---|---|---|---|
| [广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。 | EventDispatcher | ||
| 在正加载的数据的总大小（以字节为单位）更改时调度。 | LoadTrait | |||
| [广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。 | EventDispatcher | ||
| 在 LoadTrait 的状态发生变化时调度。 | LoadTrait | |||
属性详细信息
bytesLoaded | 属性 |
bytesTotal | 属性 |
loadState | 属性 |
resource | 属性 |
resource:MediaResourceBase [只读] | 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
表示要加载到此 LoadTrait 中的媒体片段的资源。
实现
public function get resource():MediaResourceBase构造函数详细信息
LoadTrait | () | 构造函数 |
public function LoadTrait(loader:LoaderBase, resource:MediaResourceBase)| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
构造函数。
参数loader:LoaderBase — 将用于为具有此特征的媒体元素加载媒体的 LoaderBase 实例。
| |
resource:MediaResourceBase — 表示要加载的媒体资源的 MediaResourceBase 实例。
|
方法详细信息
bytesLoadedChangeEnd | () | 方法 |
protected function bytesLoadedChangeEnd():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
在 bytesLoaded 属性更改后立即调用。
bytesLoadedChangeStart | () | 方法 |
bytesTotalChangeEnd | () | 方法 |
protected function bytesTotalChangeEnd():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
在 bytesTotal 属性更改后立即调用。调度 bytesTotalChange 事件。
进行覆盖的子类应调用此方法以调度 bytesTotalChange 事件。
bytesTotalChangeStart | () | 方法 |
load | () | 方法 |
public function load():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
将此媒体加载到此 LoadTrait。更新加载状态。在每个状态发生变化时调度 loadStateChange 事件。
媒体加载时的常见状态是 LOADING，成功完成加载后为 READY，如果未完成加载，则为 LOAD_ERROR。
在调用方法时，如果 LoadState 是 LOADING 或 READY，将引发错误。
引发
IllegalOperationError — 如果此特征无法自行加载，或者 LoadState 为 LOADING 或 READY。
|
相关 API 元素
loadStateChangeEnd | () | 方法 |
protected function loadStateChangeEnd():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
在 loadState 属性更改后立即调用。
loadStateChangeStart | () | 方法 |
setBytesLoaded | () | 方法 |
protected final function setBytesLoaded(value:Number):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
设置已加载的数据的字节数。
参数
value:Number |
引发
ArgumentError — 如果值为负、NaN 或大于 bytesTotal。
|
setBytesTotal | () | 方法 |
protected final function setBytesTotal(value:Number):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
设置正加载的数据的总大小（以字节为单位）。
参数
value:Number |
引发
ArgumentError — 如果值为负或小于 bytesLoaded。
|
setLoadState | () | 方法 |
unload | () | 方法 |
public function unload():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
卸载此 LoadTrait。更新加载状态。在每个状态发生变化时调度 loadStateChange 事件。
媒体卸载时的常见状态是 UNLOADING，成功完成卸载后为 UNINITIALIZED，如果未完成卸载，则为 LOAD_ERROR。
在调用方法时，如果 LoadState 不是 READY，将引发错误。
引发
IllegalOperationError — 如果此特征无法自行卸载，或者 LoadState 不是 READY。
|
相关 API 元素
事件详细信息
bytesTotalChange | 事件 |
事件对象类型:
属性 LoadEvent.type =
org.osmf.events.LoadEvent属性 LoadEvent.type =
org.osmf.events.LoadEvent.BYTES_TOTAL_CHANGE| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
在正加载的数据的总大小（以字节为单位）更改时调度。
LoadEvent.BYTES_TOTAL_CHANGE 常量可为 bytesTotalChange 事件定义事件对象的 type 属性的值。loadStateChange | 事件 |
事件对象类型:
属性 LoadEvent.type =
org.osmf.events.LoadEvent属性 LoadEvent.type =
org.osmf.events.LoadEvent.LOAD_STATE_CHANGE| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
在 LoadTrait 的状态发生变化时调度。
LoadEvent.LOAD_STATE_CHANGE 常量可为 loadStateChange 事件定义事件对象的 type 属性的值。Tue Jun 12 2018, 11:04 AM Z