Pacote | flash.events |
Classe | public class NetStatusEvent |
Herança | NetStatusEvent Event Object |
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
NetStatusEvent.NET_STATUS
.
Elementos da API relacionados
Propriedade | Definido por | ||
---|---|---|---|
bubbles : Boolean [somente leitura]
Indica se um evento é do tipo bubbling. | Event | ||
cancelable : Boolean [somente leitura]
Indica se o comportamento associado ao evento pode ser impedido. | Event | ||
constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | ||
currentTarget : Object [somente leitura]
O objeto que está processando ativamente o objeto Event com um ouvinte de evento. | Event | ||
eventPhase : uint [somente leitura]
A fase atual no fluxo de eventos. | Event | ||
info : Object
Um objeto com propriedades que descrevem o status ou condição de erro do objeto. | NetStatusEvent | ||
target : Object [somente leitura]
O destino de evento. | Event | ||
type : String [somente leitura]
O tipo de evento. | Event |
Método | Definido por | ||
---|---|---|---|
NetStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, info:Object = null)
Cria um objeto Event que contém informações sobre eventos netStatus. | NetStatusEvent | ||
[substituir]
Cria uma cópia do objeto NetStatusEvent e define o valor de cada propriedade para corresponder ao do original. | NetStatusEvent | ||
Uma função de utilitário para implementar o método toString() em classes ActionScript 3.0 Event personalizadas. | Event | ||
Indica se um objeto tem uma propriedade especificada definida. | Object | ||
Verifica se o método preventDefault() foi chamado no evento. | Event | ||
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | ||
Cancela um comportamento padrão de evento se esse comportamento puder ser cancelado. | Event | ||
Indica se a propriedade especificada existe e é enumerável. | Object | ||
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | ||
Impede o processamento de qualquer ouvinte de evento no nó atual e qualquer nó subsequente no fluxo de eventos. | Event | ||
Impede o processamento de algum ouvinte de evento em nós subsequentes ao nó atual no fluxo de eventos. | Event | ||
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | ||
[substituir]
Retorna uma string que contém todas as propriedades do objeto NetStatusEvent. | NetStatusEvent | ||
Retorna o valor primitivo do objeto especificado. | Object |
Constante | Definido por | ||
---|---|---|---|
NET_STATUS : String = "netStatus" [estático]
Define o valor da propriedade de tipo de um objeto de evento netStatus. | NetStatusEvent |
info | propriedade |
info:Object
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Um objeto com propriedades que descrevem o status ou condição de erro do objeto.
O objeto de informação pode ter uma propriedade code
contendo uma string que representa um evento específico ou uma propriedade level
contendo uma string que seja "status"
ou "error"
.
O objeto de informação também pode ser algo diferente. As propriedades code
e level
talvez não funcionem em algumas implementações e pode ser que alguns servidores enviem objetos diferentes.
As conexões P2P enviam mensagens para um NetConnection
com um parâmetro stream
no objeto information que indica a que NetStream
a mensagem pertence.
Por exemplo, o Flex Data Services envia objetos Message que provocam erros de coerção se você tentar acessar a propriedade code
ou level
.
A tabela a seguir descreve os valores de string possíveis das propriedades code
e level
.
Propriedade code | Propriedade level | Significado |
---|---|---|
"NetConnection.Call.BadVersion" | "error" | Pacote codificado em um formato não identificado. |
"NetConnection.Call.Failed" | "error" | O método NetConnection.call() não foi capaz de chamar o método ou comando do lado do servidor. |
"NetConnection.Call.Prohibited" | "error" | Uma operação AMF (Action Message Format)é impedida por motivos de segurança. O URL do AMF não está no mesmo domínio do arquivo que contém o código que chama o método NetConnection.call() ou o servidor AMF não possui um arquivo de política que confie no domínio do arquivo que contém o código que chama o método NetConnection.call() . |
"NetConnection.Connect.AppShutdown" | "error" | O aplicativo do lado do servidor está sendo fechado. |
"NetConnection.Connect.Closed" | "status" | A conexão foi fechada com sucesso. |
"NetConnection.Connect.Failed" | "error" | Falha na tentativa de conexão. |
"NetConnection.Connect.IdleTimeout" | "status" | O Flash Media Server desconectou o cliente porque o cliente ficou ocioso por mais tempo do que o valor configurado em <MaxIdleTime> . No Flash Media Server, <AutoCloseIdleClients> fica desativado por padrão. Quando ativado, o valor de tempo limite padrão é 3600 segundos (1 hora). Para obter mais informações, consulte Close idle connections. |
"NetConnection.Connect.InvalidApp" | "error" | O nome do aplicativo especificado na chamada a NetConnection.connect() é inválido. |
"NetConnection.Connect.NetworkChange" | "status" | O Flash Player descobriu uma mudança de rede, por exemplo, uma conexão sem fios desconectada, uma conexão sem fios bem sucedida, ou uma perda de cabo de rede. Use este evento para procurar uma mudança de interface de rede. Não use este evento para implementar a lógica de nova conexão do NetConnection. Use |
"NetConnection.Connect.Rejected" | "error" | A tentativa de conexão não teve permissão para acessar o aplicativo. |
"NetConnection.Connect.Success" | "status" | Tentativa de conexão bem-sucedida. |
"NetGroup.Connect.Failed" | "error" | Falha na tentativa de conexão do NetGroup. A propriedade info.group indica qual NetGroup falhou. |
"NetGroup.Connect.Rejected" | "error" | O NetGroup não está autorizado a funcionar. A propriedade info.group indica qual NetGroup foi negado. |
"NetGroup.Connect.Success" | "status" | O NetGroup é construído e autorizado a funcionar com sucesso. A propriedade info.group indica qual NetGroup foi bem-sucedido. |
"NetGroup.LocalCoverage.Notify" | "status" | Despachado quando uma porção do espaço do endereço de grupo pelo qual este nó é responsável se altera. |
"NetGroup.MulticastStream.PublishNotify" | "status" | Despachado quando um novo fluxo contínuo denominado é detectado no Grupo de NetGroup. A propriedade informações name:String é o nome do fluxo contínuo detectado. |
"NetGroup.MulticastStream.UnpublishNotify" | "status" | Despachado quando um fluxo contínuo denominado não estiver mais disponível no Grupo. A propriedade informações name:String é o nome do fluxo contínuo que desapareceu. |
"NetGroup.Neighbor.Connect" | "status" | Despachado quando um vizinho se conecta a este nó. A propriedade informações neighbor:String é o endereço de grupo do vizinho. A propriedade peerID:String é ID do par do vizinho. |
"NetGroup.Neighbor.Disconnect" | "status" | Despachado quando um vizinho se desconecta deste nó. A propriedade informações neighbor:String é o endereço de grupo do vizinho. A propriedade peerID:String é ID do par do vizinho. |
"NetGroup.Posting.Notify" | "status" | Despachado quando uma nova Nomeação de Grupo é recebida. A propriedade informações message:Object é a mensagem. A propriedade informações messageID:String é messageID desta mensagem. |
"NetGroup.Replication.Fetch.Failed" | "status" | Despachado quando uma solicitação de transferência de um objeto (anteriormente anunciado com NetGroup.Replication.Fetch.SendNotify) falha ou é negada. Uma nova tentativa do objeto será feita se ainda for desejado. A propriedade info.index:Number é o índice do objeto que tinha sido solicitado. |
"NetGroup.Replication.Fetch.Result" | "status" | Despachado quando uma solicitação de transferência foi satisfeita por um vizinho. A propriedade informações index:Number é o índice de objeto deste resultado. A propriedade informações object:Object é o valor deste objeto. Este índice será automaticamente removido do conjunto Want. Se o objeto for inválido, este índice pode ser adicionado novamente ao conjunto Want com NetGroup.addWantObjects() . |
"NetGroup.Replication.Fetch.SendNotify" | "status" | Despachado quando o sistema de Réplica de Objeto está a ponto de enviar uma solicitação de um objeto a um vizinho. A propriedade info.index:Number é o índice do objeto que está sendo solicitado. |
"NetGroup.Replication.Request" | "status" | Despachado quando um vizinho solicitou um objeto que este nó anunciou com NetGroup.addHaveObjects() . Esta solicitação deve eventualmente ser respondida com NetGroup.writeRequestedObject() ou NetGroup.denyRequestedObject() . Observe que a resposta pode ser assíncrona. A propriedade info.index:Number é o índice do objeto que tinha sido solicitado. A propriedade info.requestID:int é o ID desta solicitação, para ser usada por NetGroup.writeRequestedObject() ou NetGroup.denyRequestedObject() . |
"NetGroup.SendTo.Notify" | "status" | Despachado quando uma mensagem dirigida a este nó é recebida. A propriedade informações message:Object é a mensagem. A propriedade informações from:String é o groupAddress do qual a mensagem foi recebida. A propriedade info.fromLocal:Boolean é TRUE se a mensagem foi enviada por este nó (significa que o nó local é o mais próximo do endereço de grupo de destino), e FALSE se a mensagem foi recebida de um nó diferente. Para implementar o encaminhamento recursivo, a mensagem deve ser reenviada com NetGroup.sendToNearest() se info.fromLocal for FALSE . |
"NetStream.Buffer.Empty" | "status" | O Flash Player não está recebendo dados rapidamente para encher o buffer. O fluxo de dados será interrompido até que o buffer seja preenchido novamente, no momento em que uma mensagem NetStream.Buffer.Full será enviada e o fluxo começará a reproduzir novamente. |
"NetStream.Buffer.Flush" | "status" | Os dados concluíram o fluxo e o buffer restante será esvaziado. Nota: Não suportado no AIR 3.0 para iOS. |
"NetStream.Buffer.Full" | "status" | O buffer está cheio e o fluxo iniciará a reprodução. |
"NetStream.Connect.Closed" | "status" | A conexão P2P foi fechada com sucesso. A propriedade info.stream indica qual fluxo foi fechado. Nota: Não suportado no AIR 3.0 para iOS. |
"NetStream.Connect.Failed" | "error" | Falha na tentativa de conexão P2P. A propriedade info.stream indica qual fluxo falhou. Nota: Não suportado no AIR 3.0 para iOS. |
"NetStream.Connect.Rejected" | "error" | A tentativa de conexão P2P não teve permissão para acessar o outro par. A propriedade info.stream indica qual fluxo foi rejeitado. Nota: Não suportado no AIR 3.0 para iOS. |
"NetStream.Connect.Success" | "status" | Tentativa de conexão P2P bem-sucedida. A propriedade info.stream indica qual fluxo foi bem-sucedido. Nota: Não suportado no AIR 3.0 para iOS. |
"NetStream.DRM.UpdateNeeded" | "status" | Um objeto de NetStream está tentando reproduzir o conteúdo protegido, mas o módulo Flash Access necessário não está presente, não é permitido pela política de conteúdo eficaz ou não compatível com o player atual. Para atualizar o módulo ou player, utilize o método update() de flash.system.SystemUpdater. Nota: Não suportado no AIR 3.0 para iOS. |
"NetStream.Failed" | "error" | (Flash Media Server) Ocorreu um erro por um motivo diferente dos relacionados em outros códigos de eventos. |
"NetStream.MulticastStream.Reset" | "status" | Uma assinatura do multicast alterou o foco para uma fluxo contínuo diferente publicado com o mesmo nome no mesmo grupo. As substituições de local de parâmetros de fluxo de multicast são perdidas. Aplique novamente as substituições de local ou os novos parâmetros padrão do fluxo serão usados. |
"NetStream.Pause.Notify" | "status" | O fluxo é pausado. |
"NetStream.Play.Failed" | "error" | Ocorreu um erro na reprodução por um motivo diferente dos relacionados em algum local desta tabela, como o assinante não ter acesso de leitura. Nota: Não suportado no AIR 3.0 para iOS. |
"NetStream.Play.FileStructureInvalid" | "error" | (AIR e Flash Player 9.0.115.0) O aplicativo detecta uma estrutura de arquivo inválida e não tentará executar esse tipo de arquivo. Nota: Não suportado no AIR 3.0 para iOS. |
"NetStream.Play.InsufficientBW" | "warning" | (Flash Media Server) O cliente não tem largura de banda suficiente para reproduzir os dados na velocidade normal. Nota: Não suportado no AIR 3.0 para iOS. |
"NetStream.Play.NoSupportedTrackFound" | "status" | (AIR e Flash Player 9.0.115.0) O aplicativo não detecta qualquer faixa aceita (vídeo, áudio ou dados) e não tentará executar o arquivo. Nota: Não suportado no AIR 3.0 para iOS. |
"NetStream.Play.PublishNotify" | "status" | A publicação inicial em um fluxo é enviada a todos os assinantes. |
"NetStream.Play.Reset" | "status" | Causado por uma redefinição de lista. Nota: Não suportado no AIR 3.0 para iOS. |
"NetStream.Play.Start" | "status" | Reprodução iniciada. |
"NetStream.Play.Stop" | "status" | Reprodução interrompida. |
"NetStream.Play.StreamNotFound" | "error" | O FLV transmitido para o método NetStream.play() não pôde ser localizado. |
"NetStream.Play.Transition" | "status" | (Flash Media Server 3.5) O servidor recebeu o comando para transicionar para outro fluxo como resultado da alternância do fluxo de taxa de bits. Esse código indica um evento de status de êxito para a chamada NetStream.play2() iniciar uma alternância de fluxo. Se a alternância não for bem-sucedida, o servidor enviará um evento NetStream.Play.Failed . Quando ocorre a alternância de fluxo, é despachado um evento onPlayStatus com o código "NetStream.Play.TransitionComplete". Para o Adobe Flash Player 10 e versões posteriores. Nota: Não suportado no AIR 3.0 para iOS. |
"NetStream.Play.UnpublishNotify" | "status" | Uma não publicação de um fluxo é enviada a todos os assinantes. |
"NetStream.Publish.BadName" | "error" | Tentativa de publicar um fluxo que já está sendo publicado por alguém. |
"NetStream.Publish.Idle" | "status" | O editor do fluxo está ocioso e não está transmitindo dados. |
"NetStream.Publish.Start" | "status" | Publicação bem-sucedida. |
"NetStream.Record.AlreadyExists" | "status" | O fluxo que está sendo gravado é mapeado para um arquivo que já está sendo gravado por outro fluxo. Isso pode acontecer devido a diretórios virtuais mal configurados. |
"NetStream.Record.Failed" | "error" | Falha na tentativa de gravar um fluxo. |
"NetStream.Record.NoAccess" | "error" | Tentativa de gravar um fluxo que ainda está sendo reproduzido ou o cliente não tem direito de acesso. |
"NetStream.Record.Start" | "status" | Gravação iniciada. |
"NetStream.Record.Stop" | "status" | Gravação interrompida. |
"NetStream.SecondScreen.Start" | "status" | Enviado quando a sessão PlayTo começa. O campo de descrição anexado a este evento contém o nome do dispositivo que receberá o vídeo. Aplica-se somente ao Windows 8.1, IE11, modo moderno. |
"NetStream.SecondScreen.Stop" | "status" | Enviado quando a sessão PlayTo termina. Aplica-se somente ao Windows 8.1, IE11, modo moderno. |
"NetStream.Seek.Failed" | "error" | A busca falhará, o que ocorre se o fluxo não for passível de busca. |
"NetStream.Seek.InvalidTime" | "error" | Para vídeo baixado com download progressivo, o usuário tentou buscar ou reproduzir após o final dos dados de vídeo que foram baixados até então, ou após o final do vídeo depois que o arquivo inteiro foi baixado. A propriedade info.details do objeto de evento que contém um time code que indica a última posição válida para a qual o usuário pode procurar. |
"NetStream.Seek.Notify" | "status" | A operação de busca está concluída. Despachado quando |
"NetStream.Step.Notify" | "status" | A operação de etapa está concluída. Nota: Não suportado no AIR 3.0 para iOS. |
"NetStream.Unpause.Notify" | "status" | O fluxo é reiniciado. |
"NetStream.Unpublish.Success" | "status" | A operação de não publicação foi bem-sucedida. |
"SharedObject.BadPersistence" | "error" | Foi feita uma solicitação para um objeto compartilhado com sinalizadores persistentes, mas a solicitação não pode ser concedida porque o objeto já foi criado com sinalizadores diferentes. |
"SharedObject.Flush.Failed" | "error" | O status "pendente" é resolvido, mas a chamada SharedObject.flush() apresenta falha. |
"SharedObject.Flush.Success" | "status" | O status "pendente" é resolvido e a chamada SharedObject.flush() é bem-sucedida. |
"SharedObject.UriMismatch" | "error" | Foi feita uma tentativa de conexão com um objeto NetConnection que tem um URI (URL) diferente do objeto compartilhado. |
"NetStream.Video.DimensionChange" | "status" | As dimensões vídeo estão disponíveis ou foram alteradas. Use a propriedade Video ou StageVideo videoWidth/videoHeight para consultar novas dimensões de vídeo. Novo no Flash Player 11.4/AIR 3.4. |
Se você encontrar erros consistentemente em relação ao buffer, tente alterá-lo, usando a propriedade NetStream.bufferTime
.
Implementação
public function get info():Object
public function set info(value:Object):void
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
"NetStream.Seek.InvalidTime"
em busca de erros. O erro "NetStream. Seek.InvalidTime"
ocorre quando o usuário tenta buscar além do fim do fluxo carregado. O exemplo testa o valor da propriedade info.code
do objeto de evento. No caso de ocorrência do erro, a propriedade eventObj.info.details
será atribuída a uma variável para usar como um parâmetro para o método seek()
do fluxo. O eventObj.info.details
contém a última posição válida disponível para processar o erro. Deste modo, o usuário vai para um local válido no fim do fluxo carregada.
function videoStatus(eventObj:NetStatusEvent):Void { switch(eventObj.info.code) { case "NetStream.Seek.InvalidTime": { var validSeekTime:Number = eventObj.info.details; nStream.seek(validSeekTime); break; } } }
NetStatusEvent | () | Construtor |
public function NetStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, info:Object = null)
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Cria um objeto Event que contém informações sobre eventos netStatus
. Objetos Event são transmitidos como parâmetros para ouvintes de eventos.
type:String — O tipo de evento. Ouvintes de eventos podem acessar essas informações por meio da propriedade type herdada. Só existe um tipo de evento de status: NetStatusEvent.NET_STATUS .
| |
bubbles:Boolean (default = false ) — Determina se o objeto Event participa do estágio de bubbling do fluxo de eventos. Ouvintes de eventos podem acessar essas informações por meio da propriedade bubbles herdada.
| |
cancelable:Boolean (default = false ) — Determina se o objeto Event pode ser cancelado. Ouvintes de eventos podem acessar essas informações por meio da propriedade cancelable herdada.
| |
info:Object (default = null ) — Um objeto contendo propriedades que descrevem o status do objeto. Ouvintes de eventos podem acessar esse objeto por meio da propriedade info .
|
Elementos da API relacionados
clone | () | método |
override public function clone():Event
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Cria uma cópia do objeto NetStatusEvent e define o valor de cada propriedade para corresponder ao do original.
RetornaEvent — Um novo objeto NetStatusEvent com valores de propriedade que correspondem aos do original.
|
toString | () | método |
override public function toString():String
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retorna uma string que contém todas as propriedades do objeto NetStatusEvent. A string está no seguinte formato:
[NetStatusEvent type=value bubbles=value cancelable=value info=value]
String — Uma string que contém todas as propriedades do objeto NetStatusEvent.
|
NET_STATUS | Constante |
public static const NET_STATUS:String = "netStatus"
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Define o valor da propriedade type
de um objeto de evento netStatus
.
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. |
info | Um objeto com propriedades que descrevem o status ou condição de erro do objeto. |
target | O objeto NetConnection ou o NetStream reportando o respectivo status. |
Elementos da API relacionados
Neste exemplo, o método netStatusHandler
é registrado como um ouvinte do evento NetStatusEvent NetConnection.netStatus
. Quando o status (êxito ou falha) da tentativa do NetConnection.connect()
for determinado, o evento netStatus
dispara este método. Se a tentativa de conexão com o objeto NetConnection tiver êxito (ou seja, se a propriedade info
do objeto NetStatusEvent despachado pelo evento netStatus
tiver uma propriedade code
que indique êxito), o código criará os objetos Video e NetStream, e chamará os métodos Video.attachNetStream()
e NetStream.play()
.
Observação: Para executar este exemplo, você precisa de um arquivo FLV cujo nome e local correspondam à variável transmitida ao videoURL
; neste caso, um arquivo FLV chamado Video.flv que se encontra no mesmo diretório do arquivo SWF.
package { import flash.display.Sprite; import flash.events.*; import flash.media.Video; import flash.net.NetConnection; import flash.net.NetStream; public class NetStatusEventExample extends Sprite { private var videoURL:String = "Video.flv"; private var connection:NetConnection; private var stream:NetStream; public function NetStatusEventExample() { connection = new NetConnection(); connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); connection.connect(null); } private function netStatusHandler(event:NetStatusEvent):void { switch (event.info.code) { case "NetConnection.Connect.Success": connectStream(); break; case "NetStream.Play.StreamNotFound": trace("Unable to locate video: " + videoURL); break; } } private function connectStream():void { var stream:NetStream = new NetStream(connection); stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); var video:Video = new Video(); video.attachNetStream(stream); stream.play(videoURL); addChild(video); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } private function asyncErrorHandler(event:AsyncErrorEvent):void { // ignore AsyncErrorEvent events. } } }
Wed Jun 13 2018, 11:10 AM Z