콜백 Methods가 불려 가는 object를 나타냅니다. 디폴트의 object는, 작성되는 로컬 접속 this 입니다. client property를 다른 object로 설정해, 콜백 Methods를 그 다른 object로 호출할 수가 있습니다.

See also

현재의 SWF 파일이 존재하는 도메인을 나타내는 string입니다.

Flash Player 9 이후용으로 Publish 된 SWF 에서는, 현재의 SWF 파일의 서브 도메인을 포함한 도메인을 나타내는 string를 돌려줍니다. 예를 들어, 현재의 SWF 파일이 www.adobe.com 에 있는 경우는,"www.adobe.com" 를 돌려줍니다.

현재의 SWF 파일이 클라이언트 컴퓨터상의 로컬 파일인 경우는,"localhost" 를 돌려줍니다.

이 property의 가장 일반적인 사용 방법은, 호출하는 수신측 LocalConnection object의 Methods의 Parameters로서 송신측 LocalConnection object의 도메인명을 건네주는지,LocalConnection.allowDomain() 와 조합해 사용해, 특정의 도메인의 커멘드를 받아들인다고 하는 것입니다. 같은 도메인내에 있는 LocalConnection object간에서만 통신하는 경우는, 통상, 이 property를 사용할 필요는 없습니다.

See also

LocalConnection object를 작성합니다. LocalConnection object를 사용하면, 같은 클라이언트 컴퓨터상에서 실행하고 있는 다른 SWF 파일간에 통신할 수 있게 됩니다.

See also

이 LocalConnection 인스턴스에 LocalConnection 호출을 송신할 수 있는 1 개 이상의 도메인을 지정합니다.

이 Methods를 사용할 때는, Flash Player 시큐러티 모델을 고려해 주세요. 디폴트에서는, LocalConnection object는 그것을 작성한 SWF 파일의 샌드 박스에 관련 지을 수 있어 LocalConnection object의 크로스 도메인에서의 호출은, 받는 SWF 파일로 LocalConnection.allowDomain() Methods가 불려 가지 않은 한 허가되지 않습니다.

상세한 것에 대하여는, 다음의 주제를 참조해 주세요.

• 「ActionScript 3.0 의 프로그래밍」의시큐러티의 장과 LiveDocs 의 최신 코멘트
• Flash Player 9 시큐러티에 관한 화이트 페이퍼

메모 :allowDomain() Methods는, ActionScript 1.0 및 2.0 의 형식으로부터 변경되고 있습니다. 이러한 이전의 버젼에서는,allowDomain 는 Implements하는 콜백 Methods였습니다. ActionScript 3.0 에서는,allowDomain() 는 유저가 호출하는 LocalConnection 의 빌트인 Methods입니다. 이 변경을 위해,allowDomain() 는 flash.system.Security.allowDomain() 와 거의 똑같이 동작합니다.

See also

이 LocalConnection object에 LocalConnection 호출을 송신할 수 있는 1 개 이상의 도메인을 지정합니다.

allowInsecureDomain() Methods는 allowDomain() Methods와 같이 동작합니다만,allowInsecureDomain() Methods는, HTTPS 이외에 밤 SWF 파일로부터, HTTPS 에 의한 SWF 파일에의 LocalConnection 호출의 송신을 허가하는 점이 다릅니다. 이 차이는, HTTPS 를 사용해 로드 된 SWF 파일로부터 allowInsecureDomain() Methods를 호출하는 경우에게만 의미가 있습니다. 같은 도메인내의 비 HTTPS 와 HTTPS 의 경계를 넘는 경우에서도,allowInsecureDomain() Methods를 호출할 필요가 있습니다. 디폴트로, 같은 도메인내에서도 비 HTTPS SWF 파일로부터 HTTPS SWF 파일에의 LocalConnection 호출은 허가되지 않습니다.

allowInsecureDomain() 를 호출하는 것은, HTTPS 에 의해 제공되는 시큐러티가 손상되기 (위해)때문에, 추천하지 않습니다. HTTPS 에 의해 SWF 파일을 로드하는 경우는, SWF 파일이 네트워크에 의한 전달중에 부정 조작을 받지 않는 것을 충분히 확신할 수 있습니다. 비 HTTPS SWF 파일에 의한 HTTPS SWF 파일에의 LocalConnection 호출을 허가했을 경우, 전달중에 부정 조작된 가능성이 있는 SWF 로부터의 호출을 받아들이게 됩니다. 이것은, HTTPS SWF 파일에 도착한 LocalConnection 호출의 정당성을 신뢰할 수 없기 때문에, 일반적으로 특별한 경계를 필요로 합니다.

디폴트에서는, HTTPS 프로토콜을 사용해 호스트 된 SWF 파일은, HTTPS 프로토콜을 사용해 호스트 된 SWF 파일에게만 액세스 할 수 있습니다. 이 Implements 방법에 의해, HTTPS 프로토콜이 제공하는 정합성이 유지됩니다.

이 Methods로 디폴트의 행동을 변경하는 것은 추천할 수 없습니다. 디폴트의 행동을 변경하면, HTTPS 의 시큐러티가 손상됩니다. 다만, 디폴트의 동작을 변경하지 않을 수 없는 경우도 있습니다. 예를 들어, Flash Player 9 이후용으로 Publish 된 HTTPS 파일에 대해서, Flash Player 6 또는 그 이전의 버젼용으로 Publish 된 HTTP 파일로부터의 액세스를 허가해야 하는 경우 등입니다.

상세한 것에 대하여는, 다음의 주제를 참조해 주세요.

• 「ActionScript 3.0 의 프로그래밍」의시큐러티의 장과 LiveDocs 의 최신 코멘트
• Flash Player 9 시큐러티에 관한 화이트 페이퍼

See also

LocalConnection object를 닫습니다 (절단 합니다). 이 커멘드는, LocalConnection object로 그 이상 커멘드를 받아들이지 않는 경우에 실행합니다. 예를 들어, 다른 SWF 파일로 같은 connectionName Parameters를 사용해 connect() 커멘드를 실행하는 경우 등입니다.

See also

send() 커멘드 (송신측 LocalConnection object)로부터의 커멘드를 받도록(듯이) LocalConnection object를 준비합니다. 이 커멘드를 사용하는 object는 "수신측 LocalConnection object" 로 불립니다. 수신측과 송신측의 object는, 같은 클라이언트 컴퓨터상에서 실행할 필요가 있습니다.

경합 상황을 피하기 (위해)때문에, 이 Methods를 호출하기 전에, LocalConnection 클래스의 예와 같이, 수신측의 LocalConnection object에 관련지을 수 있고 있는 Methods를 정의합니다.

디폴트에서는, Flash Player 는 connectionName 를 해결해 "superdomain:connectionName" 로 합니다. 여기서,superdomain 는,connect() 커멘드를 포함한 SWF 파일의 super 도메인을 나타냅니다. 예를 들어, 수신측 LocalConnection object를 포함한 SWF 파일이 www.someDomain.com 에 배치되고 있는 경우,connectionName 는 "someDomain.com:connectionName" 에 해결됩니다. SWF 파일이 클라이언트 컴퓨터에 배치되고 있는 경우,superdomain 에는 "localhost" 를 할당할 수 있습니다.

또 디폴트에서는, 수신측 LocalConnection object는, 접속명이 "superdomain:connectionName" 의 값에 해결되는 송신측 LocalConnection object로부터의 커멘드만을 받아들입니다. 이 때문에, 같은 도메인에 놓여져 있는 SWF 파일간의 통신은 간단합니다.

같은 도메인의 SWF 파일간에서만 통신을 실시하는 경우는,connectionName 에 대해서, 선두가 언더 스코아 (_) 이외로, 도메인명을 포함하지 않는 string를 지정합니다 ("myDomain:connectionName" 등). connect(connectionName) Methods와 같은 string를 사용해 주세요.

다른 도메인내의 SWF 파일간의 통신을 Implements하는 경우는,connectionName 에 언더 스코아 (_)로 시작되는 string를 지정하면, 수신측 LocalConnection object를 포함한 SWF 의 도메인간에서의 portability가 높아집니다. 생각되는 2 개의 상황을 다음에 나타냅니다.

• connectionName 의 string가 언더 스코아 (_)로 시작되지 않은 경우, Flash Player 에 의해,"myDomain:connectionName" 와 같이, super 도메인과 구두점의 접두사가 추가됩니다. 이것에 의해, 다른 도메인의 같은 이름을 가지는 접속과의 충돌은 회피할 수 있습니다만, 모든 송신측 LocalConnection object는,"myDomain:connectionName" 와 같이 이 super 도메인을 지정할 필요가 있습니다. 수신측 LocalConnection object를 포함한 SWF 파일이 다른 도메인에 이동되었을 경우는,"anotherDomain:connectionName" 와 같이, 새로운 super 도메인에 응해 접두사가 변경됩니다. 모든 송신측 LocalConnection object는, 새로운 super 도메인을 참조하도록(듯이) 수동으로 편집할 필요가 있습니다.
• connectionName 의 string가,"_connectionName" 와 같이 언더 스코아로 시작되어 있는 경우, string에 접두사는 추가되지 않습니다. 즉, 수신측 및 송신측 LocalConnection object는,connectionName 에 완전히 같은 string를 사용합니다. 수신측 object가 allowDomain() 를 사용해, 모든 도메인으로부터의 통신을 받아들이도록(듯이) 지정했을 경우는, 송신측 LocalConnection object를 변경하지 않고 , 수신측 LocalConnection object를 포함한 SWF 파일을 다른 도메인에 이동시킬 수가 있습니다.

상세한 것에 대하여는, 클래스의 개요의 설명,send() 의 connectionName 의 설명, 및 allowDomain() 엔트리와 domain 엔트리를 참조해 주세요.

메모 :구두점은,connectionName 의 string와 super 도메인을 단락짓는 특수 캐릭터로서 사용됩니다. connectionName 에 구두점을 포함한 string를 지정하는 것은 무효입니다.

See also

connect(connectionName) Methods (수신측 LocalConnection object)로 확립한 접속을 사용해,methodName 로 지정된 Methods를 호출합니다. 이 커멘드를 사용하는 object는 "송신측 LocalConnection object" 로 불립니다. 송신측 object와 수신측 object를 포함한 SWF 파일은, 같은 클라이언트 컴퓨터상에서 실행할 필요가 있습니다.

이 커멘드에 Parameters로서 건네줄 수가 있는 데이터의 양은 40 KB 에 제한됩니다. 문장구조법이 올바름에도 불구하고,send() 가 ArgumentError 를 슬로우 하는 경우는,send() 요구를 복수에 분할해 각각을 40 KB 보다 작게 해 보세요.

connect() 엔트리로 설명되고 있도록(듯이), 디폴트에서는 connectionName 에 현재의 super 도메인이 추가됩니다. 다른 도메인간에 통신을 실시하는 경우는, 송신측과 수신측의 양쪽 모두의 LocalConnection object로, 현재의 super 도메인이 추가되지 않게 connectionName 를 정의할 필요가 있습니다. 이것에는, 다음의 2 개의 방법이 있습니다.

• 송신측과 수신측의 양쪽 모두의 LocalConnection object로,connectionName 의 선두에 언더 스코아 (_)를 사용합니다. 수신측 object를 포함한 SWF 파일에서는 LocalConnection.allowDomain() 를 사용해, 모든 도메인으로부터의 접속을 받아들이도록(듯이) 지정합니다. 이 방법에서는, 송신측과 수신측의 SWF 파일을 임의의 도메인에 배치할 수 있습니다.
• 송신측 LocalConnection object의 connectionName 에 super 도메인을 포함합니다. 예를 들어,myDomain.com:myConnectionName 와 지정합니다. 수신측 object에서는,LocalConnection.allowDomain() 를 사용해, 지정한 super 도메인 (이 예에서는 myDomain.com)으로부터의 접속을 받아들이는지, 또는 모든 도메인으로부터의 접속을 받아들이도록(듯이) 지정합니다.

메모 :수신측 LocalConnection object의 connectionName 에서는 super 도메인을 지정할 수 없습니다. super 도메인을 지정할 수 있는 것은 송신측 LocalConnection object 뿐입니다.

이 Methods를 사용할 때는, Flash Player 시큐러티 모델을 고려해 주세요. 디폴트에서는, LocalConnection object는 그것을 작성한 SWF 파일의 샌드 박스에 관련 지을 수 있어 LocalConnection object의 크로스 도메인에서의 호출은, 받는 SWF 파일로 LocalConnection.allowDomain() Methods가 불려 가지 않은 한 허가되지 않습니다.

상세한 것에 대하여는, 다음의 주제를 참조해 주세요.

• 「ActionScript 3.0 의 프로그래밍」의시큐러티의 장과 LiveDocs 의 최신 코멘트
• Flash Player 9 시큐러티에 관한 화이트 페이퍼

See also

비동기 형식에서, 즉 네이티브비동기 코드로부터 예외가 슬로우 되면 dispatch됩니다.

AsyncErrorEvent.ASYNC_ERROR 정수는,asyncError event object의 type property치를 정의합니다.

이 이벤트에는, 다음의 property가 있습니다.

LocalConnection.send() 에의 호출로, 다른 시큐러티 샌드 박스에 데이터를 송신하려고 하면 dispatch됩니다.

SecurityErrorEvent.SECURITY_ERROR 정수는,securityError event object의 type property치를 정의합니다.

이 이벤트에는, 다음의 property가 있습니다.

See also

LocalConnection object가 스테이터스를 보고할 때 dispatch됩니다. LocalConnection.send() 가 정상적으로 실행되었을 경우,status event object의 level property의 값은 "status" 가 됩니다. 또, 호출해에 실패했을 경우,level property의 값은 "error" 가 됩니다. 수신측 SWF 파일로 접속이 거부되면, 송신측 SWF 파일에의 통지없이 호출이 실패할 가능성이 있습니다.

status event object의 type property의 값을 정의합니다.

이 이벤트에는, 다음의 property가 있습니다.

See also

LocalConnectionSenderExample SWF 파일에서는, LocalConnection 인스턴스가 작성되어 버튼을 누르면,call() Methods가 사용되어 "myConnection" 라고 하는 접속명의 SWF 파일에 존재하는 lcHandler 라고 하는 Methods가 불려 갑니다. 이 때, Parameters로서 TextField 의 컨텐츠가 건네받습니다.

LocalConnectionReceiverExample SWF 파일에서는, LocalConnection 인스턴스가 작성되어 이 SWF 파일을 메세지의 수신자로서 지정하기 위한 connect() Methods가 불려 갑니다. 이 수신자는, "myConnection" 라고 하는 접속에 할당할 수 있습니다. 또, 이 클래스에는, LocalConnectionSenderExample SWF 파일로부터 불려 가는 lcHandler() 라고 한다 Public Methods가 포함됩니다. Methods가 불려 가면, Parameters로서 건네받는 텍스트가 Stage 상의 TextField 에 추가됩니다.

메모: 이 예를 테스트하려면 , 양쪽 모두의 SWF 파일을 같은 컴퓨터상에 동시에 로드할 필요가 있습니다.

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