指示应对其调用回调方法的对象。默认值为此 NetConnection 实例。如果将 client 属性设置为另一个对象，则将对该对象调用回调方法。

指示应用程序是否通过永久性的 RTMP 连接连接到服务器，如果是，则为 true，否则为 false。通过 HTTP 进行连接时，此属性为 false；除非是连接到应用程序服务器上的 Flash Remoting 服务，此时该属性为 true。

用于对 Flash Media Server 进行成功 NetConnection.connect() 调用的代理类型：“none”、“HTTP”、“HTTPS”或“CONNECT”。如果未使用隧道建立连接，则该值为“none”；如果使用隧道通过 HTTP 建立连接，则该值为“HTTP”；如果使用隧道通过 HTTPS 建立连接，则该值为“HTTPS”；如果使用隧道通过 HTTP CONNECT 方法建立连接，则该值为“CONNECT”。

用于 NetConnection 对象的默认对象编码。将对象写入到二进制数据中或从二进制数据中读取对象时，defaultObjectEncoding 属性将指示对数据进行序列化处理时使用的 Action Message Format (AMF) 版本：ActionScript 3.0 格式 (ObjectEncoding.AMF3) 或 ActionScript 1.0 和 ActionScript 2.0 格式 (ObjectEncoding.AMF0)。

默认值是 ObjectEncoding.AMF3。更改 NetConnection.defaultObjectEncoding 不会影响现有 NetConnection 实例，只会影响随后创建的实例。

若要单独设置某个对象的编码（而非设置整个应用程序的对象编码），请改为设置 NetConnection 对象的 objectEncoding 属性。

有关详细信息，请参阅关于 objectEncoding 属性的描述。

另请参见

与此 Flash Player 或 Adobe AIR 实例连接的 Flash Media Server 实例的标识符。此属性仅对于 RTMFP 连接才有意义。此属性的值仅在建立 RTMFP 连接之后可用。

另请参见

由 Flash Media Server 实际选择的一个值，该值对此连接是唯一的。此值对服务器显示为其 client.nearNonce 值。仅为 RTMFP 连接定义此值。

Flash Player 或 Adobe AIR 的此实例允许的传入和传出同级连接的总数。默认值为 8。

此值不区分发行者连接和订户连接。如果在出现同级连接时此值减小，则新值只会影响新的传入连接。不会删除现有连接。

用于此 NetConnection 实例的 Flash Player 或 Adobe AIR 实例的标识符。此属性仅对于 RTMFP 连接才有意义。

每个 NetConnection 实例均具有一个唯一的 nearID 属性。Flash Player 或 Adobe AIR 实例或 NetConnection 实例所具有的标识符各不相同。

其他 Flash Player 或 Adobe AIR 实例将此标识符用作与此客户端的新 NetStream 连接的 peerID。随后，此标识符是连接到此实例的任何同级 NetStream 中的 farID。

另请参见

由此 Flash Player 或 Adobe AIR 实例实际选择的一个值，该值对此连接是唯一的。此值对服务器显示为其 client.farNonce 值。仅为 RTMFP 连接定义此值。

此 NetConnection 实例的对象编码。

将对象写入到二进制数据中或从二进制数据中读取对象时，defaultObjectEncoding 属性将指示对数据进行序列化处理时应使用的 Action Message Format (AMF) 版本：ActionScript 3.0 格式 (ObjectEncoding.AMF3) 或 ActionScript 1.0 和 ActionScript 2.0 格式 (ObjectEncoding.AMF0)。可以设置 objectEncoding 属性，以便为 NetConnection 实例设置 AMF 版本。

如果应用程序需要与在 Flash Player 9 之前发布的服务器进行通信，则了解此属性非常重要。可能存在以下三种情况：

• 连接到支持 AMF3 的服务器（如 Flex Data Services 2 或 Flash Media Server 3）。defaultObjectEncoding 的默认值是 ObjectEncoding.AMF3。在此文件中创建的所有 NetConnection 实例均使用 AMF3 序列化，因此无需设置 objectEncoding 属性。
• 连接到不支持 AMF3 的服务器（如 Flash Media Server 2）。在这种情况下，应将静态 NetConnection.defaultObjectEncoding 属性设置为 ObjectEncoding.AMF0。在此 SWF 文件中创建的所有 NetConnection 实例均使用 AMF0 序列化。因此不必设置 objectEncoding 属性。
• 连接到使用不同编码版本的多个服务器。不使用 defaultObjectEncoding，而是使用每个连接的 objectEncoding 属性设置每个连接的对象编码。若要连接到使用 AMF0 编码的服务器（如 Flash Media Server 2），请将其设置为 ObjectEncoding.AMF0；若要连接到使用 AMF3 编码的服务器（如 Flex Data Services 2），请将其设置为 ObjectEncoding.AMF3。

在连接 NetConnection 实例后，其 objectEncoding 属性是只读的。

如果连接服务器时使用了错误的编码，则 NetConnection 对象将调度 netStatus 事件。NetStatusEvent.info 属性包含一个信息对象，此信息对象具有值为 NetConnection.Connect.Failed 的 code 属性，并包含说明对象编码不正确的描述。

另请参见

用于建立连接的协议。在使用 Flash Media Server 时，此属性是相关的。可能值如下：

• "rtmp"：实时消息传递协议 (RTMP)
• "rtmpe"：加密的 RTMP
• "rtmpt"：HTTP 隧道 RTMP
• "rtmpte"：HTTP 隧道加密的 RTMP
• "rtmps"：基于 HTTPS 的 RTMP
• "rtmfp"：实时媒体流协议 (RTMFP)

确定到服务器的初始连接尝试失败后应使用的后备方法。在调用 NetConnection.connect() 方法之前，必须先设置 proxyType 属性。

可接受值为“none”、“HTTP”、“CONNECT”和“best”。

此属性的默认值为“none”；如果未更改此值，应用程序将对 RTMPS 使用 HTTPS 隧道。如果将此属性设置为“best”，客户端将尝试使用本机 SSL 进行连接。如果连接失败，客户端将尝试其它连接方法。如果将此属性设置为“HTTP”并且直接连接失败，则会使用 HTTP 隧道。如果将此属性设为“CONNECT”并且直接连接失败，则将使用隧道的 CONNECT 方法。如果后者也失败，连接不会使用备用的 HTTP 隧道方法。

仅当使用 RTMP、RTMPS 或 RTMPT 时，此属性才可用。CONNECT 方法仅适用于通过代理服务器连接到网络上的用户。

一个对象，其中包含与发布方 NetStream 对象不相关的所有同级订户 NetStream 对象。与发行方的 NetStream 对象关联的订户的 NetStream 对象位于 NetStream.peerStreams 数组中。

另请参见

传递给 NetConnection.connect() 方法的 URI。如果尚未调用 NetConnection.connect() 或者未传递任何 URI，则此属性为 undefined。

指示是否已使用本机传输层安全 (TLS) 而不是 HTTPS 建立了一个安全连接。此属性仅在连接了 NetConnection 对象时有效。

创建一个 NetConnection 对象。调用 connect() 以建立连接。

如果应用程序需要与在 Flash Player 9 之前发布的服务器进行通信，则可能需要设置 NetConnection 对象的 objectEncoding 属性。

另请参见

将上下文标头添加到 Action Message Format (AMF) 数据包结构中。此标头将随以后的每个 AMF 数据包一起发送。如果使用相同的名称调用 NetConnection.addHeader()，则新标头将代替现有标头，并在 NetConnection 对象的持续时间内始终使用新标头。通过使用标头名称调用 NetConnection.addHeader() 以删除未定义的对象，可以删除标头。

参数

在 Flash Media Server 或运行 Flash Remoting 的应用程序服务器上调用一个命令或方法。在调用 NetConnection.call() 之前，必须先调用 NetConnection.connect() 以连接到服务器。必须创建要传递给此方法的服务器端函数。

无法连接到常用的保留端口。有关已阻止的端口的完整列表，请参阅《ActionScript 3.0 编程》一书的中的“限制网络 API”。

参数

关闭本地打开的连接或到服务器的连接，并调度 code 属性值为 NetConnection.Connect.Closed 的 netStatus 事件。

此方法断开在此连接上运行的所有 NetStream 对象。队列中尚未发送的所有数据将被丢弃。（若要终止本地或服务器流而不关闭连接，请使用 NetStream.close()。）如果关闭连接，然后要创建一个新连接，则必须创建新的 NetConnection 对象并再次调用 connect() 方法。

close() 方法还会断开在此连接上运行的所有远程共享对象。不过，不必重新创建要重新连接的共享对象， 您只需调用 SharedObject.connect() 以重新建立到共享对象的连接。此外，在发出 NetConnection.close() 时排在队列中的共享对象中的任何数据都将在重建与共享对象的连接之后发送。

如果使用 Flash Media Server，最佳开发做法是在客户端不再需要到服务器的连接时调用 close()。调用 close() 是清除未使用的连接的最快捷方法。作为一种替代方法，您可以将服务器配置为自动关闭空闲连接。有关详细信息，请参阅 Flash Media Server Configuration and Administration Guide（《Flash Media Server 配置和管理指南》）。

另请参见

在 Flash Player 或 AIR AIR 应用程序和 Flash Media Server 应用程序之间创建双向连接。NetConnection 对象如同客户端与服务器之间的管道。 可使用 NetStream 对象通过此管道发送流。有关 Flash Media Server 支持的编解码器和文件格式的信息，请参阅 Flash Media Server 文档。

如果未使用 Flash Media Server，请调用 NetConnection.connect()，以便从本地文件系统或 Web 服务器中播放视频和 MP3 文件。有关支持的编解码器和文件格式的信息，请参阅 http://www.adobe.com/go/hardware_scaling_cn。

在 Flash Player 或 AIR AIR 应用程序和运行 Flash Remoting 服务的应用程序之间创建双向连接。可使用 NetServices 类通过 NetConnection 对象调用应用程序服务器函数，并返回结果。 有关详细信息，请参阅 Flash Remoting 文档。

在使用此方法时，请考虑以下安全模型：

• 默认情况下，Flash Player 或 AIR 拒绝沙箱之间的访问。网站可通过使用 URL 策略文件来实现对资源的访问。
• 应用程序可以拒绝对服务器上的资源的访问。 在 Flash Media Server 应用程序中，您需要添加服务器端代码以拒绝访问。有关详细信息，请参阅 Flash Media Server 文档。
• 如果进行调用的 文件位于只能与本地文件系统内容交互的沙箱中，则无法使用 NetConnection.connect()。
• 无法连接到常用的保留端口。有关已阻止的端口的完整列表，请参阅《ActionScript 3.0 编程》一书的中的“限制网络 API”。
• 可以在包含 SWF 内容的 HTML 页中设置 object 和 embed 标签的 allowNetworking 参数，防止 SWF 文件使用此方法。

但在 Adobe AIR 中，application 安全沙箱中的内容（使用 AIR 应用程序安装的内容）不受这些安全限制的约束。

有关详细信息，请参阅以下部分：

• Flash Player 开发人员中心主题：安全性

参数

另请参见

在异步引发异常（即来自本机异步代码）时调度。

此事件具有以下属性：

在出现输入或输出错误并导致网络操作失败时调度。

此事件具有以下属性：

在 NetConnection 对象报告其状态或错误条件时调度。netStatus 事件包含一个 info 属性，该属性是一个包含事件特定信息（例如，连接尝试成功还是失败）的信息对象。

此事件具有以下属性：

另请参见

若对 NetConnection.call() 的调用尝试连接到调用方安全沙箱外部的服务器，则进行调度。

此事件具有以下属性：

另请参见

在本例中，创建 Video 和 NetStream 对象并调用 Video.attachNetStream() 和 NetStream.play() 方法的代码放在处理函数中。仅当连接到 NetConnection 对象的尝试取得成功时才调用处理函数，即，当 netStatus 事件返回 info 对象（带有一个表示成功的 code 属性）时，才调用该处理函数。建议您在调用 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);
    }
}