SystemUpdater

Paquete	flash.system
Clase	public class SystemUpdater
Herencia	SystemUpdater EventDispatcher Object

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 10.1

La clase SystemUpdater permite actualizar módulos del Flash Player como, por ejemplo, el módulo DRM para Adobe Access, así como el propio Flash Player. Los módulos disponibles se enumeran en la clase SystemUpdaterType.

Flash Player identifica la necesidad de utilizar una actualización del módulo Adobe-Access mediante la distribución de un evento NetStatusEvent. El evento tiene una propiedad code con un valor de "DRM.UpdateNeeded". Para las actualizaciones del módulo Adobe Access, no se requiere consentimiento por parte del usuario. Detecte el evento e inicie la actualización llamando a update("DRM").

Flash Player identifica la necesidad de utilizar una actualización del reproductor mediante la distribución de un evento StatusEvent, con varios posibles valores de la propiedad code (consulte el evento status). Si hay actualizaciones del reproductor, se requiere el consentimiento por parte del usuario. Detecte el evento y presente al usuario la opción de actualización. El usuario debe aceptar la actualización real e iniciar la actualización, por ejemplo, haciendo clic en el botón correspondiente de la interfaz de usuario. A continuación, puede iniciar el reproductor actualización directamente en ActionScript llamando a update("SYSTEM").

Nota: la API SystemUpdater se admite en todas las plataformas de escritorio.

Elementos de API relacionados

flash.system.SystemUpdaterType

Propiedades públicas

Ocultar propiedades públicas heredadas

Mostrar propiedades públicas heredadas

	Propiedad		Definido por
		constructor : Object Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.	Object

Métodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	Método		Definido por
		SystemUpdater() Constructor.	SystemUpdater
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento.	EventDispatcher
		cancel():void Cancela una actualización activa.	SystemUpdater
		dispatchEvent(event:Event):Boolean Distribuye un evento en el flujo del evento.	EventDispatcher
		hasEventListener(type:String):Boolean Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica si un objeto tiene definida una propiedad especificada.	Object
		isPrototypeOf(theClass:Object):Boolean Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.	Object
		propertyIsEnumerable(name:String):Boolean Indica si existe la propiedad especificada y si es enumerable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Elimina un detector del objeto EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		toLocaleString():String Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.	Object
		toString():String Devuelve la representación de cadena del objeto especificado.	Object
		update(type:String):void Inicia una actualización de un tipo determinado.	SystemUpdater
		valueOf():Object Devuelve el valor simple del objeto especificado.	Object
		willTrigger(type:String):Boolean Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto.	EventDispatcher

Eventos

Haga clic para obtener más información sobre los eventos

Ocultar eventos heredados

Mostrar eventos heredados

	Resumen	Definido por
activate	[evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos.	EventDispatcher
cancel	Se distribuye cuando una actualización del propio reproductor se cancela por el usuario.	SystemUpdater
complete	Se distribuye cuando finaliza la actualización.	SystemUpdater
deactivate	[evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos.	EventDispatcher
ioError	Se distribuye cuando se produce un error de E/S.	SystemUpdater
open	Se distribuye cuando comienza una actualización.	SystemUpdater
progress	Se distribuye para indicar el progreso de la descarga.	SystemUpdater
securityError	Se distribuye al encontrar un error de seguridad.	SystemUpdater
status	Se distribuye cuando falla la actualización.	SystemUpdater

Información sobre constructores

()

Información sobre

public function SystemUpdater()

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 10.1

Constructor.

Información sobre métodos

cancel

()

método

public function cancel():void

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 10.1

Cancela una actualización activa.

update

()

método

public function update(type:String):void

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 10.1

Inicia una actualización de un tipo determinado. Los tipos de actualización son una de las constantes de cadena definidas en la clase SystemUpdaterType. Sólo se permite una actualización a la vez en todos los navegadores.

Después del arranque de la actualización, detecte los eventos definidos de esta clase. Los siguientes eventos eventos indican el final de una actualización y permiten una nueva actualización o un intento de actualización para continuar, al igual que llamar a la función update():

complete
cancel
securityError
ioError
status

Parámetros

type:String

Elementos de API relacionados

flash.system.SystemUpdaterType

Información sobre eventos

cancel

Evento

Tipo de objeto de evento: flash.events.Event
propiedad Event.type = flash.events.Event.CANCEL

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 10.1

Se distribuye cuando una actualización del propio reproductor se cancela por el usuario. Este evento se distribuye sólo cuando una actualización de tipo SystemUpdaterType.SYSTEM se solicita y el usuario cancela la actualización.

La constante Event.CANCEL define el valor de la propiedad type de un objeto de evento cancel.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	Referencia al objeto en el que se cancela la operación.

complete

Evento

Tipo de objeto de evento: flash.events.Event
propiedad Event.type = flash.events.Event.COMPLETE

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 10.1

Se distribuye cuando finaliza la actualización.

La constante Event.COMPLETE define el valor de la propiedad type de un objeto de evento complete.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	Objeto de red que ha terminado de cargarse.

ioError

Evento

Tipo de objeto de evento: flash.events.IOErrorEvent
propiedad IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 10.1

Se distribuye cuando se produce un error de E/S. Por ejemplo, un error que puede provocar este evento es una pérdida de conexión a Internet.

Define el valor de la propiedad type de un objeto de evento ioError.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`errorID`	Un número de referencia asociado al error concreto (sólo AIR).
`target`	El objeto de red en el que se produce el error de entrada/salida.
`text`	Texto que se mostrará como mensaje de error.

open

Evento

Tipo de objeto de evento: flash.events.Event
propiedad Event.type = flash.events.Event.OPEN

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 10.1

Se distribuye cuando comienza una actualización. La actualización cuando se envía un evento "complete", o cuando se envía un evento IOErrorEvent, SecurityErrorEvent o StatusEvent.

La constante Event.OPEN define el valor de la propiedad type de un objeto de evento open.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	Objeto de red que ha abierto una conexión.

progress

Evento

Tipo de objeto de evento: flash.events.ProgressEvent
propiedad ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 10.1

Se distribuye para indicar el progreso de la descarga. Este evento es como el evento progress en las clases Loader y URLLoader.

Define el valor de la propiedad type de un objeto de evento progress.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`bytesLoaded`	Número de elementos o bytes cargados en el momento en que el detector procesa el evento.
`bytesTotal`	Número total de elementos o bytes que se cargarán en última instancia si el proceso de carga se realiza correctamente.
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	El objeto que informa sobre el progreso.

securityError

Evento

Tipo de objeto de evento: flash.events.SecurityErrorEvent
propiedad SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 10.1

Se distribuye al encontrar un error de seguridad. Por ejemplo, un error de seguridad que puede desencadenar este evento se si el reproductor intenta realizar una actualización cuando no se permiten las actualizaciones por política de seguridad.

La constante SecurityErrorEvent.SECURITY_ERROR define el valor de la propiedad type de un objeto de evento securityError.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	El objeto de red que informa sobre le error de seguridad.
`text`	Texto que se mostrará como mensaje de error.

status

Evento

Tipo de objeto de evento: flash.events.StatusEvent
propiedad StatusEvent.type = flash.events.StatusEvent.STATUS

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 10.1

Se distribuye cuando falla la actualización. Una actualización puede fallar por uno de los siguientes motivos:

La llamada se ejecuta en una plataforma o arquitectura no admitida. En este caso, el valor de la propiedad code es "DRM.UpdateFailedNotSupported" y el valor de la propiedad level es "error".
El paquete de actualización solicitado no se encuentra en el servidor. En este caso, el valor de la propiedad code es "DRM.UpdateFailedNotCurrentlyAvailable" y el valor de la propiedad level es "error".
El módulo Adobe Access no está instalado. Este error es similar al código "DRM.UpdateNeeded", que se distribuye por NetStatusEvent. Sin embargo, en este caso, una versión más reciente de Flash Player debe descargarse primero. En este caso, el valor de la propiedad code es "DRM.UpdateNeededButIncompatible" y el valor de la propiedad level es "error". Para realizar una actualización de Flash Player, llame a SystemUpdater.update(SystemUpdaterType.SYSTEM).
El nuevo módulo DRM no se pudo descargar. En este caso, el valor de la propiedad code es "DRM.UpdateFailed" y el valor de la propiedad level es "error".

Define el valor de la propiedad type de un objeto de evento status.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`code`	Descripción del estado del objeto.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`level`	La categoría del mensaje, por ejemplo, `"status"`, `"warning"` o `"error"`.
`target`	El objeto que informa sobre su estado.

Avisos legales | Política de privacidad en línea

SystemUpdater - AS3

Paquetesx

Elementos del lenguaje

Apéndices

Paquete flash.system

SystemUpdater

cancel

update

cancel

complete

ioError

open

progress

securityError

status