| Pacote | flash.system |
| Classe | public class SystemUpdater |
| Herança | SystemUpdater  EventDispatcher Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 10.1 |
O Flash Player identifica a necessidade de uma atualização de módulo Adobe Access enviando um evento NetStatusEvent. O evento tem uma propriedade code com um valor "DRM.UpdateNeeded" . Para atualizações do módulo Adobe Access, o consentimento do usuário não é necessário. Escute o evento e inicie a atualização chamando update("DRM").
Flash Player identifica a necessidade de uma atualização do player enviaando um evento StatusEvent, com vários valores de propriedade code possíveis (consulte o evento status). Para atualizações do player, o consentimento do usuário é necessário. Escute o evento e dê ao usuário a opção de atualizar. O usuário deve concordar com a atualização real e iniciar a atualização, por exemplo, clicando em um botão na interface do usuário. Você pode então iniciar a atualização do player diretamente em ActionScript chamando update ("SYSTEM").
Observação: a API SystemUpdater é suportada em todas as plataformas de dektop.
Elementos da API relacionados
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Método | Definido por | ||
|---|---|---|---|
Construtor. | SystemUpdater | ||
 | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. | EventDispatcher | |
Cancela uma atualização ativa. | SystemUpdater | ||
|
Envia um evento para o fluxo de eventos. | EventDispatcher | |
|
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | EventDispatcher | |
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
|
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | |
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
|
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
|
Retorna a representação de string do objeto especificado. | Object | |
Começa uma atualização de um certo tipo. | SystemUpdater | ||
|
Retorna o valor primitivo do objeto especificado. | Object | |
|
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. | EventDispatcher | |
| Evento | Resumo | Definido por | ||
|---|---|---|---|---|
| [transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo. | EventDispatcher | ||
| Despachado quando uma atualização do próprio player é cancelada pelo usuário. | SystemUpdater | |||
| Despachado quando a atualização é concluída. | SystemUpdater | |||
| [transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo. | EventDispatcher | ||
| Despachado quando ocorre um erro de entrada/saída. | SystemUpdater | |||
| Despachado quando começa uma atualização. | SystemUpdater | |||
| Despachado para indicar o progresso do download. | SystemUpdater | |||
| Despachado ao encontrar um erro de segurança. | SystemUpdater | |||
| Despachado quando a atualização falha. | SystemUpdater | |||
SystemUpdater | () | Construtor |
public function SystemUpdater()| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 10.1 |
Construtor.
cancel | () | método |
public function cancel():void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 10.1 |
Cancela uma atualização ativa.
update | () | método |
public function update(type:String):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 10.1 |
Começa uma atualização de um certo tipo. Os tipos de atualização são uma das constantes de string definidas na classe SystemUpdaterType. apenas uma atualização é permitida por vez em todos os navegadores.
Depois que a atualização começar, escute os eventos definidos nesta classe. Os seguintes eventos indicam o fim de uma atualização e permitem uma nova atualização ou atualizam a tentativa de prosseguir, como ocorre ao chamar a função update():
completecancelsecurityErrorioErrorstatus
Parâmetros
type:String |
Elementos da API relacionados
cancel | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.CANCEL| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 10.1 |
Despachado quando uma atualização do próprio player é cancelada pelo usuário. Este evento é despachado apenas quando uma atualização do tipo SystemUpdaterType. SYSTEM é solicitada e o usuário cancela a atualização.
Event.CANCEL define o valor da propriedade type de um objeto de evento cancel.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | Uma referência ao objeto no qual a operação é cancelada. |
complete | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.COMPLETE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 10.1 |
Despachado quando a atualização é concluída.
A constanteEvent.COMPLETE define o valor da propriedade type de um objeto de evento complete.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto de rede que concluiu o carregamento. |
ioError | Evento |
flash.events.IOErrorEventpropriedade IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 10.1 |
Despachado quando ocorre um erro de entrada/saída. Por exemplo, um erro que pode causar este evento é uma perda da conexão com a Internet.
Define o valor da propriedadetype de um objeto de evento ioError.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
errorID | Um número de referência associado ao erro específico (somente AIR). |
target | O objeto de rede que está recebendo o erro de entrada/saída. |
text | Texto a ser exibido como uma mensagem de erro. |
open | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.OPEN| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 10.1 |
Despachado quando começa uma atualização. A atualização é concluída quando um evento 'complete' é despachado ou quando um IOErrorEvent, SecurityErrorEvent ou StatusEvent é despachado.
A constanteEvent.OPEN define o valor da propriedade type de um objeto de evento open.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto de rede que abriu uma conexão. |
progress | Evento |
flash.events.ProgressEventpropriedade ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 10.1 |
Despachado para indicar o progresso do download. Este evento assemelha-se ao evento progress nas classes Loader e URLLoader.
type de um objeto de evento progress.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
bytesLoaded | O número de itens ou bytes carregados no momento em que o ouvinte processa o evento. |
bytesTotal | O número total de itens ou bytes que serão carregados no final se o processo de carregamento tiver êxito. |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto que está informando o andamento. |
securityError | Evento |
flash.events.SecurityErrorEventpropriedade SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 10.1 |
Despachado ao encontrar um erro de segurança. Por exemplo, um erro de segurança que pode causar este evento ocorre quando o player tenta executar uma atualização e isso não é permitido pela política de segurança.
A constanteSecurityErrorEvent.SECURITY_ERROR define o valor da propriedade type de um objeto de evento securityError.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto de rede que reporta o erro de segurança. |
text | Texto a ser exibido como uma mensagem de erro. |
status | Evento |
flash.events.StatusEventpropriedade StatusEvent.type =
flash.events.StatusEvent.STATUS| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 10.1 |
Despachado quando a atualização falha. Uma atualização pode falhar por uma das seguintes razões:
- O chamador está executando em uma plataforma ou arquitetura não suportada. Neste caso, o valor da propriedade
codeé "DRM.UpdateFailedNotSupported", e o valor da propriedadelevelé "error". - O pacote de atualização solicitado não pode ser localizado no servidor. Neste caso, o valor da propriedade
codeé "DRM.UpdateFailedNotCurrentlyAvailable", e o valor da propriedadelevelé "error". - O módulo Adobe Access não está instalado. Este erro é semelhante ao código "DRM.UpdateNeeded" que é despachado pelo NetStatusEvent. Contudo, neste caso, uma versão mais recente do Flash Player deve ser carregada primeiro. Nesta caixa, o valor da propriedade
codeé "DRM.UpdateNeededButIncompatible", e o valor da propriedadelevelé "error". Para executar uma atualização de Flash Player, invoqueSystemUpdater.update (SystemUpdaterType.SYSTEM). - Não foi possível carregar o novo módulo DRM. Nesta caixa, o valor da propriedade
codeé "DRM.UpdateFailed" e o valor da propriedadelevelé "error".
type de um objeto de evento status.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
code | Uma descrição do status do objeto. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
nível | A categoria da mensagem, como "status", "warning" ou "error". |
target | O objeto que está reportando o status. |
Wed Jun 13 2018, 11:10 AM Z