Indica el objeto en el que se deberían invocar 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 Flash Player está conectado 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 llamada NetConnection.connect() a Flash Media Server: "none", "HTTP", "HTTPS" o "CONNECT". El valor es "none" si la conexión no tiene tunelado, "HTTP" si el tunelado de la conexión es a través de HTTP, "HTTPS" si es a través de HTTPS y "CONNECT" si es a través del método HTTP CONNECT.

La codificación predeterminada del objeto para los objetos NetConnection creados en el archivo SWF. 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 todo el archivo SWF), establezca la propiedad objectEncoding del objeto NetConnection.

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

Véase también

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) debería utilizarse 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 el archivo SWF de ActionScript 3.0 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 SWF utilizan la serialización AMF3, por lo que no es necesario indicar a Flash Player qué codificación AMF debe utilizar.
• 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 la conexión con el servidor, Flash Player 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.

Véase también

Determina qué métodos de opción se prueban si el intento inicial de conexión al servidor produce un error. Se debe establecer la propiedad proxyType antes de llamar al método NetConnection.connect().

Los valores aceptables son "none", "HTTP", "CONNECT" y "best".

En Flash Player 9, el valor predeterminado de esta propiedad es "none"; si no cambia este valor, Flash Player utilizará la tunelación HTTPS para RTMPS. Si la propiedad se establece como "best", el cliente intenta conectarse con SSL nativo. Si falla la conexión, se intentan otros métodos de conexión. 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.

Nota: en Flash Player 9, esta propiedad sólo se aplica si se utiliza RTMP, RTMPS o RTMPT. El método CONNECT se aplica sólo a los usuarios conectados a la red mediante un servidor proxy.

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 el archivo SWF necesita comunicarse con servidores publicados antes de la aparición de Flash Player 9, debe establecer la propiedad objectEncoding del objeto NetConnection.

Véase también

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

Invoca 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.

Parámetros

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 enviarán 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 más información, consulte la guía de configuración y administración de Flash Media Server.

Véase también

Crea una conexión bidireccional entre Flash Player y una aplicación de Flash Media Server. El objeto NetConnection es como un canal entre el cliente y el servidor. Utilice los objetos NetStream para enviar transmisiones a través del canal. Para obtener información sobre los códecs y formatos de archivo compatibles con Flash Media Server, consulte la documentación de Flash Media Server.

Sin Flash Media Server, llame al método NetConnection.connect() para reproducir archivos de vídeo y MP3 desde un sistema de archivos local o desde un servidor Web. Para más información sobre los códecs y formatos de archivo compatibles, consulte http://www.adobe.com/go/hardware_scaling_es.

Crea una conexión bidireccional entre Flash Player y un servidor de aplicaciones que ejecuta el servicio 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 más información, consulte la documentación de Flash Remoting.

Cuando utilice este método, tenga en cuenta el modelo de seguridad de Flash Player y las siguientes consideraciones sobre seguridad:

• De forma predeterminada, Flash Player deniega el acceso entre entornos limitados. Un sitio Web puede activar el acceso a un recurso utilizando un archivo de política entre distintos dominios.
• Su aplicación puede denegar el acceso a un recurso del servidor. En una aplicación de Flash Media Server, necesita añadir código en el servidor para denegar el acceso. Consulte la documentación de Flash Media Server para ver información detallada.
• No se puede utilizar NetConnection.connect() si el archivo SWF que realiza la llamada se encuentra en el entorno limitado local con sistema de archivos.
• 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.

Para más información, consulte las siguientes secciones:

• El capítulo de seguridad de la guía Programación con ActionScript 3.0 y los últimos comentarios realizados en LiveDocs.
• El documento técnico sobre la seguridad de Flash Player 9.

Parámetros

Véase también

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:

Véase también

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:

Véase también

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 = "Video.flv";
        private var connection:NetConnection;
        private var stream:NetStream;

        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 {
            stream = new NetStream(connection);
            stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            stream.client = new CustomClient();
            var video:Video = new Video();
            video.attachNetStream(stream);
            stream.play(videoURL);
            addChild(video);
        }
    }
}

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);
    }
}