SystemUpdater

Пакет	flash.system
Класс	public class SystemUpdater
Наследование	SystemUpdater EventDispatcher Object

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 10.1

Класс SystemUpdater позволяет обновлять модули Flash Player, такие как модуль DRM для Adobe Access, а также сам проигрыватель Flash Player. Доступные модули перечисляются в классе SystemUpdaterType.

Flash Player определяет необходимость обновления модуля Adobe Access путем отправки события NetStatusEvent. Это событие имеет свойство code со значением "DRM.UpdateNeeded". Для обновления модуля Adobe Access не требуется согласия пользователя. Прослушивайте событие и запустите обновление, вызвав метод update("DRM").

Flash Player определяет необходимость обновления проигрывателя, отправляя событие StatusEvent, его свойство code может иметь одно из нескольких значений (см. описание события status). Для обновления проигрывателя требуется согласие пользователя. Прослушивайте событие и предложите пользователю возможность обновления. Пользователь должен дать согласие на фактическое обновление и запустить процесс, например, нажав кнопку в интерфейсе приложения. После этого можно инициировать обновление проигрывателя непосредственно в коде ActionScript, вызвав метод update("SYSTEM").

Примечание. API SystemUpdater поддерживается для всех стационарных компьютеров.

Связанные элементы 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	Отправляется в случае ошибки ввода-вывода.	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 определяет значение свойства 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

Отправляется в случае ошибки ввода-вывода. Например, это событие может отправляться, если прерывается подключение к Интернету.

Задает значение свойства 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

Отправляется для обозначения хода выполнения загрузки. Напоминает событие progress классов Loader и URLLoader.

Задает значение свойства 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 не установлен. Эта ошибка аналогична коду DRM.UpdateNeeded, который отправляется в событии NetStatusEvent. Однако в этом случае сначала необходимо загрузить более свежую версию 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`	Объект, сообщающий свое состояние.

Юридическая информация | Политика конфиденциальности онлайн

SystemUpdater - AS3

Классы x

SystemUpdater

cancel

update

cancel

complete

ioError

open

progress

securityError

status