| パッケージ | flash.system |
| クラス | public class SystemUpdater |
| 継承 | SystemUpdater  EventDispatcher Object |
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0, Flash Player 10.1 |
Flash Player では、NetStatusEvent イベントの送出によって、Adobe Access モジュールの更新が必要であることが示されます。イベントには、"DRM.UpdateNeeded" の値が設定された code プロパティがあります。Adobe Access モジュールに対する更新では、ユーザーの承諾は必要ありません。イベントを監視し、update("DRM") を呼び出して、更新を開始します。
Flash Player では、いくつかの有効な code プロパティ値が指定された StatusEvent イベントを送出することによって、プレーヤーの更新が必要であることが示されます（status を参照)。プレーヤーに対する更新では、ユーザーの承諾は必要ありません。イベントを監視し、更新するオプションをユーザーに表示します。ユーザーは、ユーザーインターフェイス内のボタンをクリックするなどして、実際の更新に対して同意して更新を開始する必要があります。次に、update("SYSTEM") を呼び出すことによって、ActionScript 内で直接プレーヤーの更新を開始できます。
注意：SystemUpdater API はすべてのデスクトッププラットフォームでサポートされます。
関連する API エレメント
継承されるパブリックプロパティを隠す
継承されるパブリックプロパティを表示| メソッド | 定義元 | ||
|---|---|---|---|
コンストラクターです。 | SystemUpdater | ||
 | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。 | EventDispatcher | |
アクティブな更新をキャンセルします。 | SystemUpdater | ||
|
イベントをイベントフローに送出します。 | EventDispatcher | |
|
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。 | EventDispatcher | |
|
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
|
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
|
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
|
EventDispatcher オブジェクトからリスナーを削除します。 | EventDispatcher | |
|
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
|
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | |
|
指定されたオブジェクトのストリング表現を返します。 | Object | |
指定されたタイプの更新を開始します。 | SystemUpdater | ||
|
指定されたオブジェクトのプリミティブな値を返します。 | Object | |
|
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。 | EventDispatcher | |
| イベント | 概要 | 定義元 | ||
|---|---|---|---|---|
| [ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。 | EventDispatcher | ||
| プレーヤー自体の更新がユーザーによってキャンセルされたときに送出されます。 | SystemUpdater | |||
| 更新が完了したときに送出されます。 | SystemUpdater | |||
| [ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。 | EventDispatcher | ||
| I/O エラーが発生したときに送出されます。 | SystemUpdater | |||
| 更新を開始したときに送出されます。 | SystemUpdater | |||
| ダウンロードの進捗状況を示すために送出されます。 | SystemUpdater | |||
| セキュリティエラーが発生したときに送出されます。 | SystemUpdater | |||
| 更新に失敗したときに送出されます。 | SystemUpdater | |||
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 クラスで定義されているストリング定数の 1 つです。すべてのブラウザーで、一度に 1 つの更新だけが許可されます。
更新が開始された後は、このクラスで定義されているイベントを監視します。次のイベントは更新の終了を示し、update() 関数の呼び出しと同様に、新しい更新を許可するか更新の試行を続行します。
completecancelsecurityErrorioErrorstatus
パラメーター
type:String |
関連する API エレメント
cancel | イベント |
flash.events.Eventプロパティ Event.type =
flash.events.Event.CANCEL| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0, Flash Player 10.1 |
プレーヤー自体の更新がユーザーによってキャンセルされたときに送出されます。SystemUpdaterType.SYSTEM 型の更新が要求され、ユーザーが更新をキャンセルした場合にのみ、このイベントは送出されます。
Event.CANCEL 定数は、type プロパティ（cancel イベントオブジェクト）の値を定義します。
このイベントには、次のプロパティがあります。
| プロパティ | 値 |
|---|---|
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 定数は、type プロパティ（complete イベントオブジェクト）の値を定義します。
このイベントには、次のプロパティがあります。
| プロパティ | 値 |
|---|---|
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 エラーが発生したときに送出されます。例えば、このイベントを発生させるエラーの 1 つに、インターネット接続の切断があります。
type プロパティ（ioError イベントオブジェクト）の値を定義します。
このイベントには、次のプロパティがあります。
| プロパティ | 値 |
|---|---|
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 定数は、type プロパティ（open イベントオブジェクト）の値を定義します。
このイベントには、次のプロパティがあります。
| プロパティ | 値 |
|---|---|
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 イベントと類似しています。
type プロパティ（progress イベントオブジェクト）の値を定義します。
このイベントには、次のプロパティがあります。
| プロパティ | 値 |
|---|---|
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 定数は、type プロパティ（securityError イベントオブジェクト）の値を定義します。
このイベントには、次のプロパティがあります。
| プロパティ | 値 |
|---|---|
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" です。
type プロパティ（status イベントオブジェクト）の値を定義します。
このイベントには、次のプロパティがあります。
| プロパティ | 値 |
|---|---|
bubbles | false |
cancelable | false は、キャンセルするデフォルトの動作がないことを示します。 |
code | オブジェクトのステータスの説明です。 |
currentTarget | イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
level | "status"、"warning"、"error" など、メッセージのカテゴリです。 |
target | そのステータスをレポートするオブジェクトです。 |
Tue Jun 12 2018, 10:34 AM Z