NetConnection  - AS3

Indica o objeto no qual os métodos de retorno de chamada são invocados. O padrão é esta ocorrência de NetConnection. Se você definir a propriedade client como outro objeto, os métodos de retorno de chamada serão invocados nesse objeto.

Indica se o aplicativo está conectado a um servidor por meio de uma conexão RTMP persistente (true) ou não (false). Quando ele estiver conectado via HTTP, essa propriedade será false, exceto no caso de uma conexão com os serviços do Flash Remoting em um servidor de aplicativos, o que definirá a propriedade como true.

O tipo de proxy usado para fazer uma conexão bem-sucedida com o Flash Media Server. Os valores possíveis são: "none", "HTTP", "HTTPS" ou "CONNECT".

O valor será "none" se a conexão não for tunelamento ou se for uma conexão SSL nativa.

O valor será "HTTP" se a conexão for em tunelamento sobre HTTP.

O valor será "HTTPS" se a conexão for em tunelameno sobre HTTPS,

O valor será "CONNECT" se a conexão for em tunelamento usando o método CONNECT através de um servidor proxy.

A codificação de objeto padrão para objetos NetConnections. Se um objeto for gravado ou lido de dados binários, a propriedade defaultObjectEncoding indica qual versão do AMF (Action Message Format) é usada para serializar os dados: o formato ActionScript 3.0 (ObjectEncoding.AMF3) ou os formatos ActionScript 1.0 e ActionScript 2.0 (ObjectEncoding.AMF0).

O valor padrão é ObjectEncoding.AMF3. Alterar NetConnection.defaultObjectEncoding não afeta as ocorrências existentes de NetConnection, afeta apenas as ocorrências que forem criadas subsequentemente.

Para definir a codificação de um objeto separadamente (em vez de definir a codificação de objeto para o aplicativo inteiro), defina a propriedade objectEncoding do objeto NetConnection.

Para obter informações mais detalhadas, consulte a descrição da propriedade objectEncoding.

Elementos da API relacionados

O identificador da ocorrência do Flash Media Server à qual essa ocorrência do Flash Player ou do Adobe AIR está conectada. Essa propriedade é importante somente para conexões RTMFP. O valor dessa propriedade ficará disponível somente depois que a conexão RTMFP for estabelecida.

Elementos da API relacionados

Um valor escolhido basicamente pelo Flash Media Server, exclusivo dessa conexão. Esse valor aparece para o servidor como seu valor client.nearNonce. Este valor é definido só para conexões RTMFP, RTMPE e RTMPTE.

O tempo, em milissegundos, de espera por uma resposta HTTP. O valor padrão é zero.

• O valor httpIdleTimeouté um Número.
• Ao usar uma conexão HTTP, um valor positivo indica o número de milissegundos em que uma conexão inativa deve permanecer aberta.
• O valor zero indica que o valor limite de tempo ocioso padrão da rede deverá ser usado para esta plataforma.
• Um valor negativo resultará em um RangeError.
• Se o valor httpIdleTimeout for excedido, o evento netStatus será despachado.
• Esta propriedade só afetará os objetos NetConnectioncriados com conexões HTTP. Os objetos apNetConnection criados com RTMP, RTMFP, ou outros canais HTTP permanecem não afetados por esta propriedade.

    //Set the timeout to 5 seconds
    connection = new NetConnection();
    connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
    connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
    connection.httpIdleTimeout = 5000;
    

O número total de conexões de mesmo nível de entrada e saída permitido por essa ocorrência do Flash Player ou Adobe AIR. O valor padrão é 8.

Esse valor não faz distinção entre conexões de editor e de assinante. Se esse valor for diminuído enquanto houver conexões de mesmo nível, o novo valor afetará somente as novas conexões de entrada. As conexões existentes não serão interrompidas.

O identificador dessa ocorrência do Flash Player ou do Adobe AIR para essa ocorrência de NetConnection. Essa propriedade é importante somente para conexões RTMFP.

Toda ocorrência de NetConnection tem uma propriedade nearID exclusiva. Nenhuma ocorrência do Flash Player, do Adobe AIR ou de NetConnection tem o mesmo identificador.

Outras ocorrências do Flash Player ou do Adobe AIR usam esse identificador como parâmetro peerID nas novas conexões NetStream com esse cliente. Posteriormente, esse identificador será o parâmetro farID em qualquer NetStream de mesmo nível que se conectar a essa ocorrência.

Elementos da API relacionados

Um valor escolhido basicamente por essa ocorrência do Flash Player ou do Adobe AIR, exclusivo dessa conexão. Esse valor aparece para o servidor como seu valor client.farNonce. Este valor é definido só para conexões RTMFP, RTMPE e RTMPTE.

A codificação de objeto para esta ocorrência de NetConnection.

Se um objeto for gravado ou lido de dados binários, a propriedade defaultObjectEncoding indica qual versão do AMF (Action Message Format) é usada para serializar os dados: o formato ActionScript 3.0 (ObjectEncoding.AMF3) ou os formatos ActionScript 1.0 e ActionScript 2.0 (ObjectEncoding.AMF0). Defina a propriedade objectEncoding de forma a determinar uma versão AMF para uma ocorrência de NetConnection.

É importante compreender essa propriedade se o Aplicativo precisar se comunicar com servidores lançados antes do Flash Player 9. Os três cenários a seguir são possíveis:

• Conexão com um servidor que oferece suporte ao AMF3 (por exemplo, Flex Data Services 2 ou Flash Media Server 3). O valor padrão de defaultObjectEncoding é ObjectEncoding.AMF3. Todas as instâncias NetConnections criadas neste arquivo usam a serialização AMF3, portanto, não é necessário definir a propriedade objectEncoding.
• Conexão com um servidor que não oferece suporte ao AMF3 (por exemplo, Flash Media Server 2). Nesse cenário, defina a propriedade estática NetConnection.defaultObjectEncoding como ObjectEncoding.AMF0. Todas as ocorrências de NetConnection criadas nesse arquivo SWF usam a serialização AMF0. Não é necessário definir a propriedade objectEncoding.
• Conexão com vários servidores que usam diferentes versões de codificação. Em vez de usar defaultObjectEncoding, defina a codificação de objetos em cada conexão, usando a propriedade objectEncoding para cada conexão. Defina como ObjectEncoding.AMF0 para se conectar a servidores que usam a codificação AMF0, como o Flash Media Server 2, e defina como ObjectEncoding.AMF3 para se conectar a servidores que usam a codificação AMF3, como o Flex Data Services 2.

Quando uma ocorrência de NetConnection estiver conectada, sua propriedade objectEncoding será somente leitura.

Se você usar a codificação incorreta para se conectar a um servidor, o objeto NetConnection irá despachar o evento netStatus. A propriedade NetStatusEvent.info contém um objeto de informações com um valor da propriedade code de NetConnection.Connect.Failed e uma descrição explicando que a codificação do objeto está incorreta.

Elementos da API relacionados

O protocolo usado para estabelecer conexão. Essa propriedade é importante quando estiver usando o Flash Media Server. Os valores possíveis são os seguintes:

• "rtmp": Real-Time Messaging Protocol (RTMP)
• "rtmpe": RTMP criptografado
• "rtmpt": RTMP com encapsulamento HTTP
• "rtmpte": RTMP criptografado com encapsulamento HTTP
• "rtmps": RTMP baseado em HTTPS
• "rtmfp": Real-Time Media Flow Protocol (RTMFP)

Determina quais métodos de recorrência (fallback) serão tentados se uma tentativa inicial de conexão com o servidor Flash Media Server falhar. Defina a propriedade proxyType antes de chamar o método NetConnection.connect().

Os valores aceitáveis são "none", "HTTP", "CONNECTOnly", "CONNECT" e "best". O valor padrão é "none".

Para usar SSL nativo, defina a propriedade como "best". Se o player não puder fazer uma conexão direta com o servidor (sobre a porta padrão 443 ou sobre outra porta que você especificar) e um servidor proxy estiver disponível, o player tentará usar o método CONNECT. Se essa tentativa falhar, o player fará um tunelamento sobre HTTPS.

Se a propriedade for definida como "CONNECTOnly", o player tentará usar primeiramente o método CONNECT. Em caso de falha, não haverá retorno.

Se a propriedade for definida como "HTTP" e uma conexão direta falhar, o tunelamento HTTP será usado. Se a propriedade for definida como "CONNECT" e uma conexão direta falhar, o método CONNECT de tunelamento será usado. Se isso falhar, a conexão não recorrerá ao tunelamento HTTP.

Esta propriedade é aplicável somente ao usar RTMP, RTMPS ou RTMPT. Os métodos CONNECT e CONNECTOnly são aplicáveis apenas para usuários que estão conectados à rede pelo servidor de proxy.

Um objeto que mantém todos os objetos NetStream de inscrição do mesmo nível que não estão associados aos objetos NetStream de publicação. Os objetos NetStream de assinante associados a objetos NetStream de publicação estão na matriz NetStream.peerStreams.

Elementos da API relacionados

O URI transmitido ao método NetConnection.connect(). Se NetConnection.connect() não tiver sido chamado ou se nenhum URI tiver sido transmitido, essa propriedade será undefined.

Indica se uma conexão segura foi feita usando TLS (Transport Layer Security) em vez de HTTPS. Essa propriedade somente é válida quando um objeto NetConnection está conectado.

Cria um objeto NetConnection. Chame o método connect() para estabelecer uma conexão.

Se um aplicativo precisar se comunicar com servidores lançados antes do Flash Player 9, talvez seja necessário definir a propriedade objectEncoding do objeto NetConnection.

O código a seguir cria um objeto NetConnection:

     var nc:NetConnection = new NetConnection();
     

Elementos da API relacionados

Adiciona um cabeçalho de contexto à estrutura de pacotes AMF (Action Message Format). Esse cabeçalho será despachado com qualquer pacote AMF futuro. Se você chamar NetConnection.addHeader() usando o mesmo nome, o novo cabeçalho substituirá o existente e o novo cabeçalho persistirá com base na duração do objeto NetConnection. É possível remover um cabeçalho chamando NetConnection.addHeader() com o nome do cabeçalho de forma a remover um objeto indefinido.

Parâmetros

Invoca um comando ou método no Flash Media Server ou em um servidor de aplicativos que esteja executando o Flash Remoting. Antes de chamar NetConnection.call(), você deve chamar NetConnection.connect() para se conectar ao servidor. É necessário criar uma função no lado do servidor a ser transmitida a esse método.

Não é possível conectar-se às portas normalmente reservadas. Para ver uma lista completa de portas bloqueadas, consulte "Restrição de APIs de rede" no Guia do Desenvolvedor do ActionScript 3.0.

Parâmetros

Elementos da API relacionados

Encerra a conexão que foi aberta localmente ou com o servidor e despacha um evento netStatus com uma propriedade code de NetConnection.Connect.Closed.

Esse método desconecta todos os objetos NetStream em execução por meio da conexão. Os dados em fila ainda não despachados serão descartados. (Para terminar fluxos locais ou de servidor sem encerrar a conexão, use NetStream.close().) Se você encerrar a conexão e, em seguida, quiser criar uma nova, deverá chamar um novo objeto NetConnection e chamar novamente o método connect().

O método close() também desconecta todos os objetos compartilhados remotos em execução por meio dessa conexão. Entretanto, não é necessário recriar o objeto compartilhado para se reconectar. Basta chamar SharedObject.connect() para restabelecer a conexão com o objeto compartilhado. Além disso, todos os dados no objeto compartilhado que tiverem sido colocados em fila na ocasião da emissão de NetConnection.close() serão despachados depois que você restabelecer uma conexão com esse objeto.

Com o Flash Media Server, a prática recomendada de desenvolvimento é chamar close() quando o cliente não precisar mais da conexão com o servidor. Chamar close() é a maneira mais rápida de limpar conexões não usadas. Você pode configurar o servidor de forma a encerrar conexões inativas automaticamente como medida de back-up. Para obter mais informações, consulte o Guia de Configuração e Administração do Flash Media Server.

Elementos da API relacionados

Cria uma conexão de duas vias com um aplicativo Flash Media Server ou Flash Remoting ou cria um ponto de extremidade de rede de duas vias para comunicação em grupo ponto a ponto RTMFP. Para reportar seu status ou uma condição de erro, uma chamada de NetConnection.connect() envia um evento netStatus.

Invoque NetConnection.connect() para fazer o seguinte:

• Transmite "null" para reproduzir arquivos e vídeo em MP3 a partir de um sistema de arquivos local ou de um servidor web.
• Envie um URL "http" para se conectar a um servidor de aplicativos que esteja executando o Flash Remoting. Use a classe NetServices para chamar funções e retornar resultados de servidores de aplicativos via objeto NetConnection. Para obter mais informações, consulte Documentação do Flash Remoting.
• Envie um URL "rtmp/e/s" para se conectar a um servidor de aplicativos Flash Media Server.
• Transmita um URL "rtmfp" para criar o ponto de extremidade de rede bidirecional para o servidor- cliente RTMFP ponto a ponto e uma comunicação de multicast de IP.
• Passe a string "rtmfp:" para criar um ponto de extremidade de rede bidirecional sem servidor para a comunicação multicast de IP do RTMFP.

Considere o seguinte modelo de segurança:

• Por padrão, o Flash Player ou o AIR nega acesso entre caixas de proteção. Um site da Web pode permitir o acesso a um recurso usando um arquivo de diretivas de URL.
• O seu aplicativo pode negar acesso a um recurso no servidor. Em um aplicativo Flash Media Server, use o código ActionScript do lado dos servidor para negar o acesso. Consulte a documentação do Flash Meia Server .
• Não será possível usar NetConnection.connect() se o arquivo de chamada estiver na caixa de proteção local com sistema de arquivos.
• Não é possível conectar-se às portas normalmente reservadas. Para ver uma lista completa de portas bloqueadas, consulte "Restrição de APIs de rede" no Guia do Desenvolvedor do ActionScript 3.0.
• Você pode impedir o arquivo SWF de usar esse método configurando o parâmetro allowNetworking das marcas object e embed na página HTML que tem o conteúdo SWF.

Contudo, no Adobe AIR, o conteúdo na caixa de proteção de segurança application (conteúdo instalado com o Adobe AIR) não é restringido por essas limitações de segurança.

Para obter mais informações relacionadas à segurança, consulte o Centro dos Desenvolvedores do Flash Player:Segurança.

Parâmetros

Elementos da API relacionados

Despachado quando uma exceção é lançada assincronamente – ou seja, a partir do código assíncrono nativo.

Esse evento tem as seguintes propriedades:

Despachado quando ocorre um erro de entrada ou saída que resulta na falha de uma operação de rede.

Esse evento tem as seguintes propriedades:

Despachado quando um objeto NetConnection está relatando seu status ou uma condição de erro. O evento netStatus contém uma propriedade info, que é um objeto de informações contendo informações específicas sobre esse evento; por exemplo, se uma tentativa de conexão foi bem-sucedida ou se falhou.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Despachado se uma chamada para NetConnection.call() tentar se conectar a um servidor fora da área de segurança do chamador.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Nesse exemplo, o código que cria os objetos Video e NetStream e chama os métodos Video.attachNetStream() e NetStream.play() é inserido em uma função de manipulador. O manipulador apenas será chamado se uma tentativa de conexão com o objeto NetConnection for bem-sucedida; ou seja, quando o evento netStatus retorna um objeto info com uma propriedade code que indica êxito. Convém aguardar uma conexão bem-sucedida antes de chamar NetStream.play().

package {
    import flash.display.Sprite;
    import flash.events.NetStatusEvent;
    import flash.events.SecurityErrorEvent;
    import flash.media.Video;
    import flash.net.NetConnection;
    import flash.net.NetStream;
    import flash.events.Event;

    public class NetConnectionExample extends Sprite {
        private var videoURL:String = "http://www.helpexamples.com/flash/video/cuepoints.flv";
        private var connection:NetConnection;
        private var stream:NetStream;
        private var video:Video = new Video();        

        public function NetConnectionExample() {
            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("Stream not found: " + videoURL);
                    break;
            }
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

        private function connectStream():void {
            addChild(video);
            var stream:NetStream = new NetStream(connection);
            stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            stream.client = new CustomClient();
            video.attachNetStream(stream);
            stream.play(videoURL);
        }
    }
}

class CustomClient {
    public function onMetaData(info:Object):void {
        trace("metadata: duration=" + info.duration + " width=" + info.width + " height=" + info.height + " framerate=" + info.framerate);
    }
    public function onCuePoint(info:Object):void {
        trace("cuepoint: time=" + info.time + " name=" + info.name + " type=" + info.type);
    }
}