SystemUpdater

包	flash.system
类	public class SystemUpdater
继承	SystemUpdater EventDispatcher Object

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 10.1

通过 SystemUpdater 类，您可以更新 Flash Player 的模块（如 Adobe Access 的 DRM 模块）以及 Flash Player 本身。SystemUpdaterType 类中列出了可用的模块。

Flash Player 通过调度 NetStatusEvent 事件确定是否需要进行 Adobe Access 模块更新。此事件包含一个其值为 "DRM.UpdateNeeded" 的 code 属性。更新 Adobe Access 模块无需经过用户同意。侦听该事件，然后通过调用 update("DRM") 启动更新。

Flash Player 通过使用几种可能的 code 属性值调度 StatusEvent 事件来确定是否需要进行 Player 更新（请参阅 status 事件）。更新 Player 需要经过用户同意。侦听该事件并为用户提供要更新的选项。用户必须同意进行实际更新并通过，例如，单击用户界面中的按钮来启动更新。然后，您可以通过调用 update("SYSTEM") 直接在 ActionScript 中启动 Player 更新。

注意：所有桌面平台上都支持 SystemUpdater API。

相关 API 元素

flash.system.SystemUpdaterType

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		SystemUpdater() 构造函数。	SystemUpdater
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		cancel():void 取消活动的更新。	SystemUpdater
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		update(type:String):void 开始指定类型的更新。	SystemUpdater
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

事件

单击此处了解有关事件的更多信息

隐藏继承的事件

显示继承的事件

	摘要	由以下参数定义
activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
cancel	当用户取消对 Player 本身的更新时进行调度。	SystemUpdater
complete	当更新完成时进行调度。	SystemUpdater
deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher
ioError	当发生 I/O 错误时进行调度。	SystemUpdater
open	当更新开始时进行调度。	SystemUpdater
progress	调度以表示下载进度。	SystemUpdater
securityError	当遇到安全错误时进行调度。	SystemUpdater
status	当更新失败时进行调度。	SystemUpdater

构造函数详细信息

()

构造函数

public function SystemUpdater()

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 10.1

构造函数。

方法详细信息

cancel

()

方法

public function cancel():void

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 10.1

取消活动的更新。

update

()

方法

public function update(type:String):void

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 10.1

开始指定类型的更新。更新类型是在 SystemUpdaterType 类中定义的一个字符串常量。在同一时刻，各浏览器中只允许存在一个进行的更新。

更新开始后，侦听在此类中定义的事件。下列事件表示更新结束并允许进行新的更新或继续尝试进行更新，与调用 update() 函数相同：

complete
cancel
securityError
ioError
status

参数

type:String

cancel

事件

事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.CANCEL

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 10.1

当用户取消对 Player 本身的更新时进行调度。仅当请求 SystemUpdaterType.SYSTEM 类型的更新且用户取消更新时调度此事件。

Event.CANCEL 常量定义 cancel 事件对象的 type 属性的值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	对已取消其操作的对象的引用。

complete

事件

事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.COMPLETE

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 10.1

当更新完成时进行调度。

Event.COMPLETE 常量定义 complete 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	已完成加载的网络对象。

ioError

事件

事件对象类型: flash.events.IOErrorEvent
属性 IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 10.1

当发生 I/O 错误时进行调度。例如，可导致此事件的一个错误是断开 Internet 连接。

定义 ioError 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`errorID`	与特定错误关联的引用编号（仅限 AIR）。
`target`	发生输入/输出错误的网络对象。
`text`	要显示为错误消息的文本。

open

事件

事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.OPEN

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 10.1

当更新开始时进行调度。当发送“complete”事件或者发送 IOErrorEvent、SecurityErrorEvent 或 StatusEvent 后，更新完成。

Event.OPEN 常量用于定义 open 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	已打开连接的网络对象。

progress

事件

事件对象类型: flash.events.ProgressEvent
属性 ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 10.1

调度以表示下载进度。此事件类似于 Loader 和 URLLoader 类中的 progress 事件。

定义 progress 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`bytesLoaded`	在侦听器处理事件时加载的项数或字节数。
`bytesTotal`	如果加载进程成功，最终将加载的项目或字节总数。
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	报告进度的对象。

securityError

事件

事件对象类型: flash.events.SecurityErrorEvent
属性 SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 10.1

当遇到安全错误时进行调度。例如，如果 Player 在安全策略不允许更新时尝试执行更新，则将出现可导致此事件的安全错误。

SecurityErrorEvent.SECURITY_ERROR 常量定义 securityError 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	报告安全错误的网络对象。
`text`	要显示为错误消息的文本。

status

事件

事件对象类型: flash.events.StatusEvent
属性 StatusEvent.type = flash.events.StatusEvent.STATUS

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 10.1

当更新失败时进行调度。更新会由于下列其中一个原因失败：

调用方在不支持的平台或体系结构上运行。在这种情况下，code 属性的值为“DRM.UpdateFailedNotSupported”，level 属性的值为“error”。
请求的更新包不能位于服务器上。在这种情况下，code 属性的值为“DRM.UpdateFailedNotCurrentlyAvailable”，level 属性的值为“error”。
未安装 Adobe Access 模块。此错误与由 NetStatusEvent 调度的“DRM.UpdateNeeded”代码类似。然而，在这种情况下，必须先下载 Flash Player 的最新版本。在这种情况下，code 属性的值为“DRM.UpdateNeededButIncompatible”，level 属性的值为“error”。要执行 Flash Player 更新，请调用 SystemUpdater.update(SystemUpdaterType.SYSTEM)。
无法下载此新 DRM 模块。在这种情况下，code 属性的值为“DRM.UpdateFailed”，level 属性的值为“error”。

定义 status 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`code`	对象状态的描述。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`level`	消息类别，例如 `"status"`、`"warning"` 或 `"error"`。
`target`	报告其状态的对象。

法律声明 | 在线隐私策略

SystemUpdater - AS3

类 x

SystemUpdater

cancel

update

cancel

complete

ioError

open

progress

securityError

status