콜백 Methods가 불려 가는 object를 나타냅니다. 디폴트치는 이 NetConnection 인스턴스입니다. client property를 다른 object로 설정하는 경우는, 콜백 Methods를 그 다른 object로 호출할 수가 있습니다.

영속적인 RTMP 접속을 개입시켜 (true), 또는 그 이외의 방법으로 (false) 서버에 접속한 것을 나타냅니다. HTTP 경유로 접속하고 있는 경우는, 이 property는 항상 false 가 됩니다. 어플리케이션 서버에의 AMF 접속의 경우는, 항상 true 입니다.

정상적으로 접속이 확립하면, 직접 접속,CONNECT Methods, 또는 HTTP 터널링 등, 접속의 확립에 사용된 Methods가 나타납니다. 유효한 값은,"none","HTTP","HTTPS", 및 "CONNECT" 입니다. 이 property는, NetConnection object가 접속되고 있는 경우에게만 유효합니다. 이 property는, Flex 어플리케이션 및 Flash Media Server 어플리케이션으로 사용됩니다. Flash Player 9 에서는, 이 property는 RTMP, RTMPS, 또는 RTMPT를 사용하고 있는 경우에게만 적용할 수 있습니다. CONNECT Methods는, 프록시 서버-경유로 네트워크에 접속하고 있는 유저에게만 적용할 수 있습니다.

이 property를 읽어들여, 사용된 접속 방법을 조사할 수가 있습니다. 이 property는, 직접 접속을 하면 "none", HTTP 터널링이 사용되면 "HTTP", 시큐러티 보호가 있는 HTTPS 터널링이 사용되면 "HTTPS", 프록시의 CONNECT Methods가 사용되면 "CONNECT" 를 돌려줍니다.

SWF 파일로 작성된 NetConnection object의 디폴트 object의 encode (AMF 버젼)입니다. 바이너리 데이터로부터 object를 기입해 또는 독해를 하면,defaultObjectEncoding property는, 사용할 필요가 있는 Action Message Format 버젼을 나타냅니다. ActionScript 3.0 포맷, 또는 ActionScript 1.0 및 ActionScript 2.0 포맷입니다.

디폴트에서는,NetConnection.defaultObjectEncoding 는 ActionScript 3.0 포맷, AMF3 를 사용하도록(듯이) 설정됩니다. NetConnection.defaultObjectEncoding 를 변경해도, 기존의 NetConnection 인스턴스에는 영향을 주지 않고, 그 이후에 작성된 인스턴스에게만 영향을 줍니다.

object encode를 SWF 파일 전체로 설정하지 않고 개별적으로 설정하려면 , NetConnection object의 objectEncoding property를 설정합니다.

상세한 것에 대하여는,objectEncoding property의 설명을 참조해 주세요.

See also

이 NetConnection 인스턴스의 object의 encode (AMF 버젼)입니다. 이 property의 디폴트치는,defaultObjectEncoding 의 값입니다. 지정할 수 있는 값은,ObjectEncoding.AMF3 및 ObjectEncoding.AMF0 입니다.

ActionScript 3.0 SWF 파일로 Flash Player 9 이전에 릴리스 된 서버와 통신할 필요가 있는 경우는, 이 property를 이해하는 것이 중요합니다.

바이너리 데이터로부터 object를 기입해 또는 독해를 하면,objectEncoding property는, 사용할 필요가 있는 Action Message Format 버젼을 나타냅니다. ActionScript 3.0 포맷 (ObjectEncoding.AMF3) 또는 ActionScript 1.0 및 ActionScript 2.0 포맷 (ObjectEncoding.AMF0)입니다. NetConnection object를 사용해 서버에 접속할 때는, 3 개의 경우가 생각됩니다.

• Flash Player 9 이후 또는 동시에 릴리스 된 서버 (Flex 2 등)에 대해서, 배타적으로 접속하는 경우. defaultObjectEncoding 의 디폴트치는 ObjectEncoding.AMF3 입니다. 이 SWF 파일에 작성되는 모든 NetConnection 인스턴스에서는, AMF3 직렬화를 사용합니다. 사용하는 AMF 인코딩을 Flash Player 에 통지할 필요는 없습니다.
• Flash Player 9 이전에 릴리스 된 서버 (Flex 1.5, Flash Media Server 2 등)에 대해서, 배타적으로 접속하는 경우. 이 시나리오에서는, 정적인 defaultObjectEncoding property를 ObjectEncoding.AMF0 로 설정합니다. 이 SWF 파일에 작성되는 모든 NetConnection 인스턴스에서는, AMF0 직렬화를 사용합니다. objectEncoding property를 설정할 필요는 없습니다.
• 다른 인코딩 버젼을 사용하는 복수의 서버에 접속하는 경우. defaultObjectEncoding 를 사용하지 않고 , 각 접속의 objectEncoding property를 사용해, 접속 마다 object 인코딩을 설정합니다. 이 property를 ObjectEncoding.AMF0 로 설정하면, AMF0 인코딩을 사용하는 서버 (Flex 1.5, Flash Media Server 2 등)에 접속합니다. ObjectEncoding.AMF3 로 설정하면, AMF3 인코딩을 사용하는 서버 (Flex 2)에 접속합니다.

defaultObjectEncoding 를 변경해도, 기존의 NetConnection 인스턴스에는 영향을 주지 않고, 그 이후에 작성된 인스턴스에게만 영향을 줍니다.

NetConnection 인스턴스가 접속되면, 그 objectEncoding property는 읽기 전용(read-only)이 됩니다.

서버에의 접속에 잘못한 인코딩을 사용했을 경우, Flash Player 에 의해 netStatus 이벤트가 dispatch됩니다. NetStatusEvent.info property에는,code property의 값 NetConnection.Connect.Failed 를 가지는 정보 object와 object encode가 올바르지 않은 것을 나타내는 설명이 포함되어 있습니다.

See also

네이티브 SSL 가 HTTPS 는 아니고 RTMPS 에 사용될지 어떨지, 터널링의 CONNECT Methods가 프록시 서버-를 개입시켜 접속하기 위해서 사용될지 어떨지를 조사합니다. 지정할 수 있는 값은,"none","HTTP","CONNECT", 및 "best" 입니다. 이 property는, Flex 어플리케이션 및 Flash Media Server 2 어플리케이션으로 사용됩니다.

Flash Player 9 에서는, 이 property는 RTMP, RTMPS, 또는 RTMPT를 사용하고 있는 경우에게만 적용할 수 있습니다. CONNECT Methods는, 프록시 서버-경유로 네트워크에 접속하고 있는 유저에게만 적용할 수 있습니다.

proxyType property는, 최초의 접속의 시행이 실패했을 때에 시행되는 폴 백 Methods를 지정합니다. NetConnection.connect() Methods를 호출하기 전에,proxyType property를 설정할 필요가 있습니다. 이 property는, 접속 시행시에, 네이티브 TLS (Transport Layer Security)를 사용할지 어떨지, 및, 어플리케이션으로 인식되는 프록시 서버-의 조작 방법을 결정합니다.

Flash Player 9 에서는, 이 property의 디폴트치는 "none" 입니다. 이 값을 변경하지 않는 경우, Flash Player 는 RTMPS 에 HTTPS 터널링을 사용합니다. property가 "best" 로 설정되어 있는 경우는, 접속에 최적인 방법이 확립되어 이 최적인 방법이 우선 시행됩니다. 실패했을 경우는 다른 Methods에 폴 백됩니다. RTMPS 접속에서는, 디폴트로 네이티브 SSL 소켓이 사용됩니다. 다른 Methods에의 폴 백은, 필요에 따라서 사용됩니다. property가 "HTTP" 로 설정되어 있어 직접 접속에 실패했을 경우는, HTTP 터널링의 낡은 Methods가 사용됩니다. property가 "CONNECT" 로 설정되어 있어 직접 접속에 실패했을 경우는, HTTP 터널링의 CONNECT Methods가 사용됩니다. 이것에 실패하면, 접속은 HTTP 터널링에 폴 백되지 않게 됩니다.

connect 가 서버에의 접속에 사용되었을 경우,NetConnection.connect() 에게 건네진 어플리케이션 서버의 URI입니다. NetConnection.connect() 가 아직 불려 가지 않은 경우, 또는 URI 가 건네받지 않은 경우, 이 property는 undefined 가 됩니다.

HTTPS 는 아니고, 네이티브 TLS 를 사용해 시큐어 접속이 확립되었는지 어떠했는지를 나타냅니다. 이 property는, NetConnection object가 접속되고 있는 경우에게만 유효합니다.

리모트 어플리케이션 서버로 커멘드를 기동하거나 로컬로,또는 서버로부터스트리밍 비디오 파일 (FLV)을 재생하기 위해서, NetStream object와 조합해 사용하는 것이 가능한 NetConnection object를 생성합니다. NetConnection object를 생성한 후에,connect() 를 사용해 실제의 접속을 확립합니다.

Flash 문서내에 비디오를 포함하는 것보다도, 외부의 FLV 파일을 재생한 (분)편이, 퍼포먼스와 메모리 메니지먼트의 효율이 좋아지는, 비디오와 Flash 의 frame rate를 독립화할 수 있는 등의 메리트가 있습니다.

ActionScript 3.0 SWF 파일로 Flash Player 9 이전에 릴리스 된 서버와 통신할 필요가 있는 경우, NetConnection object의 objectEncoding property를 조정할 필요가 있는 일이 있습니다.

See also

문맥 헤더를 AMF 패킷 구조에 추가합니다. 이 헤더는, 장래의 모든 AMF 패킷과 함께 송신됩니다. 같은 이름을 사용해 NetConnection.addHeader() 를 호출하면, 기존의 헤더가 새로운 헤더로 옮겨집니다. 새로운 헤더는, NetConnection object가 있는 동안 계속 존재합니다. 헤더의 이름을 사용해 NetConnection.addHeader() 를 호출해, 미정도리의 object를 삭제해, 헤더를 삭제할 수 있습니다. 이 방법은, Flex 또는 Flash Media Server 등의 서버로 사용하고 있는 경우에 유효합니다.

어플리케이션 인스턴스에 접속하는 Flash Media Server 를 실행하고 있는 서버 또는 어플리케이션 서버로, 커멘드 또는 Methods를 기동합니다. 이 Methods에 건네주려면 , 서버 사이드 함수를 작성할 필요가 있습니다.

로컬 또는 서버로 개시한 접속을 닫아NetConnection.Connect.Close 의 code property로,netStatus 이벤트를 dispatch합니다.

이 Methods는, 이 접속상에서 실행 떠날 수 있어 모든 NetStream object를 절단 합니다. 송신되어 있지 않은 큐내의 데이터는 모두 파기됩니다. 접속을 닫지 않고로컬 또는 서버스트림(Stream)을 종료하려면 ,NetStream.close() 를 사용합니다. 이 Methods를 호출한 다음에 재접속하는 경우는, NetStream object를 재작성할 필요가 있습니다.

이 Methods는, 이 접속상에서 실행 떠날 수 있어 모든 리모트 공유 object도 절단 합니다. 다만, 재접속하기 위해서 공유 object를 재작성할 필요는 없습니다. SharedObject.connect() 를 호출하는 것만으로, 공유 object에의 접속을 재확립할 수 있습니다. 또, 공유 object에의 접속이 재확립되면,NetConnection.close() 를 발행했을 때에 큐내에 있던 공유 object의 데이터가 모두 송신됩니다.

See also

서버에의 접속을 엽니다. 이 접속을 개입시켜,HTTP 주소 또는로컬 파일 시스템으로부터 오디오 또는 비디오 (FLV) 파일을 재생하거나 리모트 서버-로 커멘드를 호출하거나 할 수가 있습니다.

이 Methods를 사용하는 경우는, Flash Player 시큐러티 모델 및 다음의 시큐러티에 대한 고려사항을 검토해 주세요.

• 디폴트에서는, Web 사이트에서는 샌드 박스간의 액세스는 거부됩니다. 크로스 도메인 policy 파일을 사용해, Web 사이트에서 리소스에 액세스 할 수 있게 됩니다.
• Web 사이트에서는, Flash Media Server 에 서버 사이드 ActionScript 어플리케이션 논리를 추가하는 것으로써, 리소스에의 액세스를 거부할 수 있습니다.
• 호출원 SWF 파일이 로컬 파일 시스템의 샌드 박스에 배치되고 있는 경우는,NetConnection.connect() Methods를 사용할 수 없습니다.

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

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

See also

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

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

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

입출력 에러가 발생해 네트워크 처리가 실패했을 때에 dispatch됩니다.

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

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

NetConnection object가, 그 스테이터스 또는 에러의 상황을 리포트할 경우에 dispatch됩니다. netStatus 이벤트에는 info property가 포함됩니다. 이 property는, 접속 시행이 성공했는지 어떠했는지 등, 이벤트에 관한 특정의 정보를 포함한 정보 object입니다.

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

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

See also

NetConnection.call() 의 호출에 의해 호출원의 시큐러티 샌드 박스의 외부에 있는 서버에 접속하려고 하면 dispatch됩니다.

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

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

See also

이 예에서는, Video object와 NetStream object를 작성해, Video.attachNetStream() Methods와 NetStream.play() Methods를 호출하는 코드가 핸들러 함수에 배치됩니다. 핸들러는, NetConnection object와의 접속이 성공했을 경우에게만 불려 갑니다. 즉, netStatus 이벤트가, 성공한 것을 나타내는 code property와 함께 info object를 돌려준다 경우입니다. 접속에 성공할 때까지 기다리고 나서, 다음의 코드를 호출하는 것을 추천합니다. 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 {
            var stream:NetStream = 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);
    }
}