NetConnection  - AS3

Indica el objeto en el que se invocan los métodos callback. El valor predeterminado es esta instancia de NetConnection. Si establece la propiedad client en otro objeto, los métodos callback se invocarán en dicho objeto.

Indica si la aplicación está conectada a un servidor mediante una conexión RTMP persistente (true) o no (false). Cuando se conecta a través de HTTP, esta propiedad es false, salvo cuando se conecta a servicios de Flash Remoting en un servidor de aplicaciones, en cuyo caso es true.

El tipo de proxy utilizado para realizar con éxito una conexión con Flash Media Server. Los valores posibles son: "none", "HTTP", "HTTPS" o "CONNECT".

El valor es "none" si la conexión no tiene tunelado o si se trata de un conexión SSL nativa.

El valor es "http" si el tunelado de la conexión es a través de HTTP.

El valor es "HTTPS" si el tunelado de la conexión es a través de HTTPS,

El valor es "CONNECT" si el tunelado de la conexión es mediante el método CONNECT a través de un servidor proxy.

La codificación predeterminada del objeto para objetos NetConnection. Cuando se lee o se escribe un objeto con datos binarios, la propiedad defaultObjectEncoding indica qué versión de formato de mensaje de acción (AMF) se utiliza para serializar los datos: en formato ActionScript 3.0 (ObjectEncoding.AMF3) o en formato ActionScript 1.0 y ActionScript 2.0 (ObjectEncoding.AMF0).

El valor predeterminado es ObjectEncoding.AMF3. Al cambiar NetConnection.defaultObjectEncoding, las instancias existentes de NetConnection no se ven afectadas; el cambio sólo afecta a las instancias creadas posteriormente.

Para establecer la codificación de un objeto de forma independiente (en vez de establecerla para toda la aplicación), establezca la propiedad objectEncoding del objeto NetConnection.

Para información más detallada, consulte la descripción de la propiedad objectEncoding.

Elementos de API relacionados

Identificador de la instancia de Flash Media Server al que se conecta esta instancia de Flash Player o Adobe AIR. Esta propiedad sólo es importante para conexiones RTMFP. El valor de esta propiedad únicamente está disponible una vez se haya establecido una conexión RTMFP.

Elementos de API relacionados

Un valor elegido en gran parte por Flash Media Server, exclusivo para esta conexión. Este valor aparece en el servidor como su valor client.nearNonce. Este valor sólo se define para conexiones RTMFP, RTMPE y RTMPTE.

Tiempo, en milisegundos, que se espera para una respuesta HTTP. El valor predeterminado es cero.

• El valor de httpIdleTimeout es un Number.
• Cuando se utiliza una conexión HTTP, un valor positivo indica el número de milisegundos que una conexión inactiva debe permanecer abierta.
• Un valor de cero indica que debe utilizarse el valor predeterminado de espera por inactividad de la red de la plataforma.
• Un valor negativo producirá un RangeError.
• Si se supera el valor de httpIdleTimeout, se distribuye un evento netStatus.
• Esta propiedad solo afecta a objetos NetConnection creados con conexiones HTTP. Los objetos NetConnection creados con RTMP, RTMFP u otros canales HTTP no se ven afectados por esta propiedad.

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

Número total de conexiones homólogas de entrada y salida que permite esta instancia de Flash Player o Adobe AIR. El valor predeterminado es 8.

Este valor no distingue entre conexiones de suscriptor y editor. Si este valor se reduce mientras las conexiones homólogas están presentes, el nuevo valor sólo afecta a las nuevas conexiones de entrada. Las conexiones existentes no se verán interrumpidas.

Identificador de esta instancia de Flash Player o Adobe AIR para esta instancia de NetConnection. Esta propiedad sólo es importante para las conexiones RTMFP.

Todas las instancias de NetConnection tienen un nearID exclusivo. Ninguna instancia de Flash Player, Adobe AIR o NetConnection tiene el mismo identificador.

Otras instancias de Flash Player o Adobe AIR utilizan este identificador como peerID para las nuevas conexiones de NetStream con este cliente. Posteriormente, este identificador será farID en cualquier NetStream homólogo que se conecte con esta instancia.

Elementos de API relacionados

Un valor elegido en gran parte por esta instancia de Flash Player o Adobe AIR, exclusivo para esta conexión. Este valor aparece en el servidor como su valor client.farNonce. Este valor sólo se define para conexiones RTMFP, RTMPE y RTMPTE.

La codificación del objeto para esta instancia de NetConnection.

Cuando se lee o se escribe un objeto con datos binarios, la propiedad defaultObjectEncoding indica qué versión de formato de mensaje de acción (AMF) se utiliza para serializar los datos: en formato ActionScript 3.0 (ObjectEncoding.AMF3) o en formato ActionScript 1.0 y ActionScript 2.0 (ObjectEncoding.AMF0). Establezca la propiedad objectEncodingpara que defina una versión de AMF para una instancia de NetConnection.

Es importante comprender esta propiedad si la aplicación necesita comunicarse con los servidores publicados antes de la aparición de Flash Player 9. Los tres casos siguientes son posibles:

• Conectarse a un servidor que admite AMF3 (por ejemplo, Flex Data Services 2 o Flash Media Server 3). El valor predeterminado de defaultObjectEncoding es ObjectEncoding.AMF3. Todas las instancias de NetConnection creadas en este archivo utilizan serialización AMF3, por lo que no es necesario definir la propiedad objectEncoding.
• Conectarse a un servidor que no admite AMF3 (por ejemplo, Flash Media Server 2). En este caso, defina la propiedad estática NetConnection.defaultObjectEncoding como ObjectEncoding.AMF0. Todas las instancias de NetConnection creadas en este archivo SWF utilizan la serialización AMF0. No es necesario establecer la propiedad objectEncoding.
• Una conexión a varios servidores que utilizan distintas versiones de codificación. En lugar de utilizar defaultObjectEncoding, establezca la codificación del objeto conexión por conexión utilizando la propiedad objectEncoding de cada una de las conexiones. Establézcala como ObjectEncoding.AMF0 para conectarse a servidores que utilicen la codificación AMF0, como Flash Media Server 2; establézcala como ObjectEncoding.AMF3 para conectarse a servidores que utilicen la codificación AMF3, como Flex 2.

Una vez conectada una instancia de NetConnection, su propiedad objectEncoding pasa a ser de sólo lectura.

Si utiliza la codificación equivocada para realizar la conexión con el servidor, el objeto NetConnection distribuirá el evento netStatus. La propiedad NetStatusEvent.info contiene un objeto de información con un valor de propiedad code de NetConnection.Connect.Failed, así como una descripción en la que se explica por qué la codificación del objeto es incorrecta.

Elementos de API relacionados

El protocolo utilizado para establecer la conexión. Esta propiedad es importante cuando se utiliza Flash Media Server. Los posibles valores son los siguientes:

• "rtmp": protocolo de mensajería en tiempo real (RTMP)
• "rtmpe": RTMP cifrado
• "rtmpt": RTMP con tunelación HTTP
• "rtmpte": RTMP cifrado con tunelación HTTP
• "rtmps": RTMP basado en HTTPS
• "rtmfp": protocolo de flujo de medios en tiempo real (RTMFP)

Determina qué métodos de opción se prueban si el intento inicial de conexión a Flash Media Server produce un error. Establezca la propiedad proxyType antes de llamar al método NetConnection.connect().

Los valores aceptables son "none", "HTTP", "CONNECTOnly", "CONNECT" y "best". El predeterminado es "none".

Para utilizar SSL nativo, establezca la propiedad como best. Si el reproductor no puede realizar la conexión directa con el servidor (a través del puerto predeterminado 443 u otro puerto que especifique) y un servidor proxy está en su lugar, el reproductor intenta utilizar el método CONNECT. Si el intento falla, el reproductor tunela a través de HTTPS.

Si la propiedad se establece en "CONNECTOnly", el reproductor intenta usar primero el método CONNECT. En caso de fallar, no hay opción alternativa.

Si la propiedad se establece como "HTTP" y la conexión directa falla, se empleará el método de tunelación HTTP. Si la propiedad se establece como "CONNECT" y la conexión directa falla, se empleará el método CONNECT de tunelación. Si éste falla, no se volverá a la tunelación HTTP para volver a intentar la conexión.

Esta propiedad sólo se aplica si se utiliza RTMP, RTMPS o RTMPT. Los métodos CONNECT y CONNECTOnly son aplicables únicamente a usuarios conectados a la red mediante un servidor proxy.

Un objeto que alberga todos los objetos NetStream del suscriptor homólogo que no estén asociados a ningún objeto NetStream de publicación. Los objetos NetStream del suscriptor que se asocian con los objetos NetStream de publicación se encuentran en el conjunto NetStream.peerStreams.

Elementos de API relacionados

El URI transferido al método NetConnection.connect(). Si aún no se ha llamado a NetConnection.connect() o si no se ha transferido ningún URI, esta propiedad es undefined.

Indica si se ha realizado una conexión segura con el protocolo de seguridad de capas de transporte (TLS) nativo y no mediante HTTPS. Esta propiedad sólo es válida si hay conectado un objeto NetConnection.

Crea un objeto NetConnection. Llame al método connect() para realizar una conexión.

Si una aplicación necesita comunicarse con servidores publicados antes de la aparición de Flash Player 9, establezca la propiedad objectEncoding del objeto NetConnection.

El código siguiente crea un objeto NetConnection.

     var nc:NetConnection = new NetConnection();
     

Elementos de API relacionados

Añade un encabezado de contexto a la estructura del paquete de formato de mensaje de acción (AMF). El encabezado se envía con cada paquete AMF futuro. Si llama a NetConnection.addHeader() con el mismo nombre, el nuevo encabezado reemplazará al existente y se conservará durante la duración del objeto NetConnection. Se puede eliminar un encabezado llamando a NetConnection.addHeader() con el nombre del encabezado para eliminar un objeto no definido.

Parámetros

Llama a un comando o método en Flash Media Server o en un servidor de aplicaciones que ejecute Flash Remoting. Antes de llamar al método NetConnection.call(), es necesario llamar a NetConnection.connect() para conectarse al servidor. Es preciso crear una función en el lado del servidor para transferirla a este método.

No es posible conectar con puertos reservados comúnmente. Para obtener una lista completa de los puertos bloqueados, consulte la sección “Restricción de API de red” en el Guía del desarrollador de ActionScript 3.0.

Parámetros

Elementos de API relacionados

Cierra la conexión abierta localmente o en el servidor y distribuye el evento netStatus con una propiedad code de NetConnection.Connect.Closed.

Este método desconecta todos los objetos NetStream que se ejecutan con la conexión. Todos los datos incluidos en la cola que no se enviaron se descartan. (Para finalizar transmisiones locales o del servidor sin cerrar la conexión, utilice NetStream.close().) Si cierra la conexión y desea crear una nueva, deberá crear un nuevo objeto NetConnection y volver a llamar al método connect().

El método close() también desconecta todos los objetos compartidos remotos que se ejecutan con esta conexión. Sin embargo, no es necesario crear de nuevo el objeto compartido para volver a conectarse. Basta simplemente con llamar a SharedObject.connect() para restablecer la conexión con el objeto compartido. Asimismo, todos los datos del objeto compartido que estaban en cola al emitir NetConnection.close() se envían tras restablecer una conexión con el objeto compartido.

Con Flash Media Server, la mejor práctica de desarrollo consiste en llamar al método close() cuando el cliente ya no necesite la conexión al servidor. La llamada a close() es la forma más rápida de borrar conexiones que no se utilizan. Se puede configurar el servidor para que cierre automáticamente las conexiones inactivas como medida de seguridad. Para obtener más información, consulte la Guía de administración y configuración de Flash Media Server (en inglés).

Elementos de API relacionados

Crea una conexión bidireccional a una aplicación en Flash Media Server o a Flash Remoting, o bien crea un punto final de red de dos direcciones para comunicación P2P entre grupos de RTMFP. Para informar sobre su estado o una situación de error, la llamada a NetConnection.connect() distribuye un evento netStatus.

Llame a NetConnection.connect() para realizar lo siguiente:

• Transfiera "null" para reproducir archivos de vídeo y mp3 desde un sistema de archivos local o desde un servidor web.
• Transfiera una URL "http" para conectarse a un servidor de aplicaciones que ejecute Flash Remoting. Utilice la clase NetServices para llamar a funciones y devolver resultados de servidores de aplicaciones a través de un objeto NetConnection. Para obtener información, consulte la documentación de Flash Remoting (en inglés).
• Transfiera una URL "rtmp/e/s" para conectarse a una aplicación Flash Media Server.
• Transfiera una URL "rtmfp" para crear un punto final de red bidireccional para comunicación RTMFP cliente-servidor, P2P y multidifusión IP.
• Transfiera la cadena "rtmfp:" para crear un punto final de red de dos direcciones para comunicación con multidifusión IP RTMFP.

Tenga en cuenta el modelo de seguridad siguiente:

• De forma predeterminada, Flash Player o AIR deniega el acceso entre entornos limitados. Un sitio web puede activar el acceso a un recurso utilizando un archivo de política URL.
• Su aplicación puede denegar el acceso a un recurso del servidor. En una aplicación de Flash Media Server, utilice código ActionScript del lado del servidor para denegar el acceso. Consulte la documentación de Flash Media Server.
• No se puede llamar a NetConnection.connect() si el archivo que realiza la llamada se encuentra en el entorno limitado local con sistema de archivos.
• No es posible conectar con puertos reservados comúnmente. Para obtener una lista completa de los puertos bloqueados, consulte la sección “Restricción de API de red” en el Guía del desarrollador de ActionScript 3.0.
• Asimismo, se puede impedir que un archivo SWF utilice este método si define el parámetro allowNetworking de las etiquetas object y embed de la página HTML que aloja el contenido SWF.

Sin embargo, en Adobe AIR, el contenido del entorno limitado de seguridad de la aplicación (contenido instalado con la aplicación de AIR) no está limitado por estas restricciones de seguridad.

Para obtener más información sobre la seguridad, consulte el Centro de desarrollo de Adobe Flash Player: Seguridad.

Parámetros

Elementos de API relacionados

Se distribuye cuando se emite una excepción de forma asíncrona, es decir, desde un código asíncrono nativo.

Este evento tiene las propiedades siguientes:

Se distribuye cuando se produce un error de entrada o salida que provoca que una operación de red se realice incorrectamente.

Este evento tiene las propiedades siguientes:

Se distribuye cuando un objeto NetConnection informa sobre su estado o situación de error. El evento netStatus incluye una propiedad info, que es un objeto de información que contiene información específica sobre el evento, por ejemplo, si el intento de conexión se realizó correctamente o si falló.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

Se distribuye si se intenta llamar a NetConnection.call() para conectarse con un servidor situado fuera del entorno limitado de seguridad del elemento que realiza la llamada.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

En este ejemplo, el código que crea los objetos Video y NetStream y llama a los métodos Video.attachNetStream() y NetStream.play() se coloca en una función de controlador. Sólo se llamará al controlador si el intento de conexión con el objeto NetConnection se realiza correctamente; es decir, si el evento netStatus devuelve un objeto info con una propiedad a code que indica una correcta realización. Se recomienda que espere a establecer una conexión correcta antes de llamar a 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);
    }
}