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 事件來識別播放程式更新的需求 (請參閱 status 事件)。對於播放程式的更新，則需要使用者同意。偵聽事件並提供使用者更新的選項。使用者必須同意實際更新並起始更新，方法是 (例如) 按一下使用者介面中的按鈕。您可以呼叫 update("SYSTEM")，以便直接在 ActionScript 中起始播放程式更新。

注意：在所有桌面平台上支援 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	當使用者取消播放程式的更新時傳送。	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

相關 API 元素

flash.system.SystemUpdaterType

事件詳細資訊

cancel

事件

事件物件類型: flash.events.Event
屬性 Event.type = flash.events.Event.CANCEL

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 10.1

當使用者取消播放程式的更新時傳送。當要求類型 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 錯誤時傳送。例如，網際網路連線的中斷，可能會造成此事件的錯誤。

定義 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

當發生安全性錯誤時傳送。例如，如果播放程式嘗試在安全性原則不允許更新的情況下執行更新，就會造成安全性錯誤。

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 模組。此錯誤類似於 "DRM.UpdateNeeded" 程式碼，會由 NetStatusEvent 傳送。不過，在此情況下，必須先下載 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

語言元素

附錄

套件 flash.system

SystemUpdater

cancel

update

cancel

complete

ioError

open

progress

securityError

status