LocalConnection  - AS3

Indica el objeto en el que se invocan los métodos callback. El objeto predeterminado es this (la conexión local que se está creando). Se puede establecer la propiedad client en otro objeto y los métodos callback se invocarán en dicho objeto.

Una cadena que representa el dominio de la ubicación del archivo actual.

En el contenido ejecutado en el entorno limitado de seguridad de la aplicación de Adobe AIR (contenido instalado con la aplicación de AIR), el motor de ejecución utiliza la cadena app# seguida del ID de la aplicación de AIR (definido en el archivo descriptor de la aplicación) en el lugar del superdominio. Por ejemplo, connectionName en una aplicación con com.example.air.MyApp como ID de aplicación, connectionName se resuelve como "app#com.example.air.MyApp:connectionName".

En archivos SWF publicados para Flash Player 9 o posterior, la cadena devuelta es el dominio exacto del archivo, incluidos los subdominios. Por ejemplo, si el archivo está situado en www.adobe.com, este comando devolverá "www.adobe.com".

Si el archivo actual es un archivo local que reside en el equipo cliente ejecutado en Flash Player, este comando devolverá "localhost".

Esta propiedad se utiliza habitualmente incluyendo el nombre del dominio del objeto LocalConnection emisor como parámetro del método que tiene previsto invocar en el objeto LocalConnection receptor o para su uso con LocalConnection.allowDomain() para aceptar comandos de un dominio determinado. Si desea permitir la comunicación sólo entre objetos LocalConnection que se encuentren en el mismo dominio, probablemente no necesite utilizar esta propiedad.

Elementos de API relacionados

Indica si el objeto LocalConnection está limitado al usuario actual (true) o si todos los usuarios pueden acceder globalmente en el equipo (false). Esta propiedad solo afecta al contenido que se ejecuta en Mac OS X; en otras plataformas, este parámetro se omite. Las conexiones en sistemas operativos Windows y Linux siempre se realizan por usuario independiente.

En Flash Player 10.0.22 y versiones anteriores, y en AIR 1.5.1 y versiones anteriores, todos los objetos LocalConnection en Mac OS X tienen un ámbito global. Establezca esta propiedad en true a menos que necesite para mantener la compatibilidad con versiones anteriores. En versiones futuras, el valor predeterminado de esta propiedad puede cambiar a true.

El valor predeterminado es false.

La propiedad isSupported se establece en true si la clase LocalConnection se admite en la plataforma actual; en caso contrario, se establece en false.

Crea un objeto LocalConnection. Los objetos LocalConnection se pueden utilizar para habilitar la comunicación entre distintos archivos que se ejecuten en el mismo equipo cliente.

Elementos de API relacionados

Especifica uno o varios dominios que pueden enviar las llamadas a LocalConnection a esta instancia de LocalConnection.

Este método no se puede utilizar para hacer que los archivos alojados mediante un protocolo seguro (HTTPS) permitan el acceso desde los archivos alojados en protocolos no seguros; para ello, se deberá utilizar el método allowInsecureDomain().

Es posible que desee utilizar este método para que un archivo secundario de un dominio diferente pueda hacer llamadas LocalConnection al archivo principal, cuando no conoce el dominio final del que proviene el archivo secundario. Por ejemplo, esto puede ocurrir cuando se utilizan redirecciones de reparto de carga o servidores de terceros. En este caso, puede utilizar la propiedad url del objeto LoaderInfo usado con la carga, para obtener el dominio que se utilizará con el método allowDomain(). Por ejemplo, si utiliza un objeto Loader para cargar un archivo secundario, una vez que se haya cargado el archivo, puede comprobar la propiedad contentLoaderInfo.url del objeto Loader y analizar el dominio fuera de la cadena URL completa. Si lo hace, asegúrese de que espera a que se cargue el archivo, ya que la propiedad contentLoaderInfo.url no dispondrá de su valor final correcto hasta que el archivo esté completamente cargado.

También puede darse la situación contraria: puede crear un archivo secundario que quiera aceptar llamadas LocalConnection de su archivo principal pero que no conozca el dominio de su archivo principal. En este caso, para implementar este método, compruebe si el argumento de dominio coincide con el dominio de la propiedad loaderInfo.url en el archivo que se ha cargado. Una vez más, deberá analizar el dominio fuera de la URL completa de loaderInfo.url. En este caso, no tendrá que esperar a que se cargue el archivo principal; el archivo principal ya estará cargado en el momento en que se cargue el archivo secundario.

Cuando utilice este método, tenga en cuenta el modelo de seguridad de Flash Player. De forma predeterminada, un objeto LocalConnection está asociado con el entorno limitado del archivo que lo creó y no se admiten llamadas de varios dominios a objetos LocalConnection a menos que se haya llamado al método LocalConnection.allowDomain() en el archivo receptor. 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, consulte el tema del Centro de desarrollo de Flash Player Seguridad.

Nota: el método allowDomain() ha cambiado desde ActionScript 1.0 y 2.0. En dichas versiones anteriores, allowDomain era un método callback que se implementaba. En ActionScript 3.0, allowDomain() es un método incorporado de LocalConnection que puede recibir llamadas. Con este cambio, el funcionamiento de allowDomain() es muy similar al de flash.system.Security.allowDomain().

Parámetros

Elementos de API relacionados

Especifica uno o varios dominios que pueden enviar las llamadas a LocalConnection a este objeto LocalConnection.

El funcionamiento del método allowInsecureDomain() es exactamente igual que el del método allowDomain(), con la excepción de que el método allowInsecureDomain() también permite que los archivos que no proceden de HTTPS puedan enviar llamadas LocalConnection a archivos SWF que sí proceden de HTTPS. Esta diferencia sólo es importante si se llama al método allowInsecureDomain() desde un archivo cargado con HTTPS. Debe llamar al método allowInsecureDomain() aunque atraviese una zona no HTTPS/HTTPS dentro del mismo dominio; de forma predeterminada, las llamadas LocalConnection nunca están permitidas desde archivos que no procedan de HTTPS a archivos HTTPS, incluso si se encuentran en el mismo dominio.

No se recomienda llamar a allowInsecureDomain(), ya que podría poner en riesgo la seguridad que ofrece HTTPS. Si carga un archivo mediante HTTPS, puede tener la seguridad razonable de que dicho archivo no se modificará durante su envío por la red. Si permite que un archivo que no procede de HTTPS realice llamadas LocalConnection al archivo HTTPS, estará aceptando llamadas de un archivo que podría, en realidad, haberse modificado durante su envío. Esto suele requerir una mayor vigilancia, ya que no se puede confiar en la autenticidad de las llamadas LocalConnection que llegan al archivo HTTPS.

De manera predeterminada, sólo los archivos alojados mediante un protocolo HTTPS pueden acceder a otros archivos alojados mediante el protocolo HTTPS. Esta implementación mantiene la integridad que ofrece el protocolo HTTPS.

No es recomendable utilizar este método para sustituir el comportamiento predeterminado, ya que pone en riesgo la seguridad de HTTPS. Sin embargo, es posible que tenga que hacerlo, por ejemplo, si necesita permitir el acceso a archivos HTTPS SWF publicados para Flash Player 9 o posterior desde archivos HTTP SWF publicados para Flash Player 6 o versiones anteriores.

Para obtener más información, consulte el tema del Centro de desarrollo de Flash Player Seguridad.

Parámetros

Elementos de API relacionados

Cierra (desconecta) un objeto LocalConnection. Envíe este comando cuando ya no desee que el objeto acepte comandos (por ejemplo, cuando desee enviar un comando connect() utilizando el mismo parámetro connectionName en otro archivo SWF).

Elementos de API relacionados

Prepara un objeto LocalConnection para recibir comandos de un comando send() (denominado objeto LocalConnection emisor). El objeto utilizado con el método connect() se conoce como objeto LocalConnection receptor. Los objetos receptor y emisor deben estar en ejecución en el mismo equipo cliente.

Para evitar una situación precipitada, defina los métodos asociados al objeto LocalConnection receptor antes de llamar a este método, tal como se indica en el ejemplo de la clase LocalConnection.

De forma predeterminada, el argumento connectionName se resuelve como un valor "superdomain:connectionName", donde superdomain es el superdominio del archivo que contiene el comando connect(). Por ejemplo, si el archivo que contiene el objeto LocalConnection receptor está ubicado en www.someDomain.com, connectionName se resuelve como "someDomain.com:connectionName". (Si un archivo ejecutado en Flash Player está situado en un equipo cliente, el valor asignado a superdomain es "localhost").

En el contenido ejecutado en el entorno limitado de seguridad de la aplicación de Adobe AIR (contenido instalado con la aplicación de AIR), el motor de ejecución utiliza la cadena app# seguida del ID de la aplicación de AIR (definido en el archivo descriptor de la aplicación) en el lugar del superdominio. Por ejemplo, connectionName en una aplicación con com.example.air.MyApp como ID de aplicación, connectionName se resuelve como "app#com.example.air.MyApp:connectionName".

Asimismo, de forma predeterminada, Flash Player permite que el objeto LocalConnection receptor acepte solamente comandos de objetos LocalConnection emisores cuyo nombre de conexión también se resuelva en el valor "superdomain:connectionName". De esta forma, Flash Player facilita la comunicación entre archivos situados en el mismo dominio.

Sí sólo va a implementar la comunicación entre archivos del mismo dominio, especifique una cadena para connectionName que no comience por un carácter de subrayado (_) y que no especifique un nombre de dominio (por ejemplo, "myDomain:connectionName"). Utilice la misma cadena en el método connect(connectionName).

Si va a implementar comunicación entre archivos de diferentes dominios, la especificación de una cadena para connectionName que comience por un carácter de subrayado (_) permitirá que el archivo que tiene el objeto LocalConnection receptor presente una mayor portabilidad entre dominios. Estos son los dos casos posibles:

• Si la cadena para connectionName no comienza por un carácter de subrayado (_), se añade un prefijo con el superdominio y dos puntos (por ejemplo, "myDomain:connectionName"). Aunque esto garantiza que la conexión no entre en conflicto con conexiones de otros dominios que tengan el mismo nombre, los objetos LocalConnection emisores deben especificar este superdominio (por ejemplo, "myDomain:connectionName"). Si el archivo que contiene el objeto LocalConnection receptor se traslada a otro dominio, el reproductor cambiará el prefijo para reflejar el nuevo superdominio (por ejemplo, "anotherDomain:connectionName"). Sería necesario editar manualmente todos los objetos LocalConnection emisores para que apuntaran al nuevo superdominio.
• Si la cadena de connectionName comienza por un carácter de subrayado (por ejemplo, "_connectionName"), no se añade ningún prefijo a la cadena. Esto significa que los objetos LocalConnection receptores y emisores utilizarán idénticas cadenas para connectionName. Si el objeto receptor utiliza allowDomain() para especificar que se acepten las conexiones de cualquier dominio, el que contiene el objeto LocalConnection receptor podrá trasladarse a otro dominio sin modificar ningún objeto LocalConnection emisor.

Para más información, consulte la descripción de la presentación general de la clase y la descripción de connectionName en send(). Consulte también las entradas allowDomain() y domain.

Nota: los dos puntos se utilizan como caracteres especiales que separan el superdominio de la cadena connectionName. La cadena de connectionName no puede incluir dos puntos.

Cuando utilice este método, tenga en cuenta el modelo de seguridad de Flash Player. De forma predeterminada, un objeto LocalConnection está asociado con el entorno limitado del archivo que lo creó y no se admiten llamadas de varios dominios a objetos LocalConnection a menos que se haya llamado al método LocalConnection.allowDomain() en el archivo receptor. Asimismo, se puede impedir que un archivo 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, consulte el tema del Centro de desarrollo de Flash Player Seguridad.

Parámetros

Elementos de API relacionados

Invoca el método denominado methodName en una conexión abierta con el método connect(connectionName) (el objeto LocalConnection receptor). El objeto utilizado con el método send() se conoce como objeto LocalConnection emisor. Los archivos SWF que contienen los objetos emisor y receptor deben estar en ejecución en el mismo equipo cliente.

Existe un límite de 40 kilobytes para la cantidad de datos que puede pasar en forma de parámetros a este comando. Si send() emite un ArgumentError pero la sintaxis es correcta, intente dividir las solicitudes de send() en varios comandos, cada uno con menos de 40 Kb de datos.

Tal como se ha visto en la entrada connect(), el superdominio actual se agrega a connectionName de forma predeterminada. Si está implementando la comunicación entre diferentes dominios, debe definir connectionName en los objetos LocalConnection emisor y receptor de manera que no añadir el superdominio actual a connectionName. Puede hacerlo de una de las dos formas siguientes:

• Utilice un carácter de subrayado (_) al comienzo de connectionName en los objetos LocalConnection emisor y receptor. En el archivo que contiene el objeto receptor, utilice LocalConnection.allowDomain() para especificar que se acepten las conexiones procedentes de cualquier dominio. Esta implementación le permite almacenar los archivos emisor y receptor en cualquier dominio.
• Incluya el superdominio en connectionName en el objeto LocalConnection emisor (por ejemplo, myDomain.com:myConnectionName). En el objeto receptor, utilice LocalConnection.allowDomain() para especificar que se acepten las conexiones desde el superdominio especificado (en este caso, myDomain.com) o que se acepten las conexiones desde cualquier dominio.

Nota: no puede especificar un superdominio en connectionName en el objeto LocalConnection receptor (sólo puede hacerlo en el objeto LocalConnection emisor).

Cuando utilice este método, tenga en cuenta el modelo de seguridad de Flash Player. De forma predeterminada, un objeto LocalConnection está asociado con el entorno limitado del archivo que lo creó y no se admiten llamadas de varios dominios a objetos LocalConnection a menos que se haya llamado al método LocalConnection.allowDomain() en el archivo receptor. En contenido SWF ejecutado en el navegador, se puede impedir que un archivo 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, consulte el tema del Centro de desarrollo de 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 si una llamada a LocalConnection.send() intenta enviar datos a un entorno limitado de seguridad distinto.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

Se distribuye cuando un objeto LocalConnection informa sobre su estado. Si la llamada LocalConnection.send() se realiza correctamente, el valor de la propiedad level del objeto de evento status es "status"; si se produce un error en la llamada, la propiedad level es "error". Si el archivo receptor rechaza la conexión, la llamada podría producir un error y no notificarlo al archivo emisor.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

En el archivo SWF LocalConnectionSenderExample, se crea una instancia de LocalConnection y, al pulsar el botón, se utiliza el método call() para llamar al método lcHandler del archivo SWF con la conexión denominada "myConnection" y se transfiere el contenido de TextField como un parámetro.

En el archivo SWF LocalConnectionReceiverExample, se crea una instancia de LocalConnection y se llama al método connect() para designar este archivo SWF como destinatario de los mensajes dirigidos a la conexión denominada "myConnection". Además, esta clase contiene un método público llamado lcHandler(); este método es al que llama el archivo SWF LocalConnectionSenderExample. Cuando realiza la llamada, el texto transferido como parámetro se añade a TextField en el escenario.

Nota: para probar este ejemplo, los dos archivos SWF deben estar cargados en el mismo equipo al mismo tiempo.

// Code in LocalConnectionSenderExample.as
package {
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import flash.net.LocalConnection;
    import flash.text.TextField;
    import flash.text.TextFieldType;
    import flash.events.StatusEvent;
    import flash.text.TextFieldAutoSize;

    public class LocalConnectionSenderExample extends Sprite {
        private var conn:LocalConnection;
        
        // UI elements
        private var messageLabel:TextField;
        private var message:TextField;
        private var sendBtn:Sprite;
        
        public function LocalConnectionSenderExample() {
            buildUI();
            sendBtn.addEventListener(MouseEvent.CLICK, sendMessage);
            conn = new LocalConnection();
            conn.addEventListener(StatusEvent.STATUS, onStatus);
        }
        
        private function sendMessage(event:MouseEvent):void {
            conn.send("myConnection", "lcHandler", message.text);
        }
        
        private function onStatus(event:StatusEvent):void {
            switch (event.level) {
                case "status":
                    trace("LocalConnection.send() succeeded");
                    break;
                case "error":
                    trace("LocalConnection.send() failed");
                    break;
            }
        }
        
        private function buildUI():void {
            const hPadding:uint = 5;
            // messageLabel
            messageLabel = new TextField();
            messageLabel.x = 10;
            messageLabel.y = 10;
            messageLabel.text = "Text to send:";
            messageLabel.autoSize = TextFieldAutoSize.LEFT;
            addChild(messageLabel);
            
            // message
            message = new TextField();
            message.x = messageLabel.x + messageLabel.width + hPadding;
            message.y = 10;
            message.width = 120;
            message.height = 20;
            message.background = true;
            message.border = true;
            message.type = TextFieldType.INPUT;
            addChild(message);
            
            // sendBtn
            sendBtn = new Sprite();
            sendBtn.x = message.x + message.width + hPadding;
            sendBtn.y = 10;
            var sendLbl:TextField = new TextField();
            sendLbl.x = 1 + hPadding;
            sendLbl.y = 1;
            sendLbl.selectable = false;
            sendLbl.autoSize = TextFieldAutoSize.LEFT;
            sendLbl.text = "Send";
            sendBtn.addChild(sendLbl);
            sendBtn.graphics.lineStyle(1);
            sendBtn.graphics.beginFill(0xcccccc);
            sendBtn.graphics.drawRoundRect(0, 0, (sendLbl.width + 2 + hPadding + hPadding), (sendLbl.height + 2), 5, 5);
            sendBtn.graphics.endFill();
            addChild(sendBtn);
        }
    }
}