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

指示 Flash Player 是通过持久性的 RTMP 连接连接到服务器 (true) 还是没有连接 (false)。 通过 HTTP 进行连接时，此属性始终为 false。 对于连接到应用程序服务器的 AMF 连接而言，此属性始终为 true。

如果连接成功，则指示使用的是哪种连接方法：直接连接、CONNECT 方法还是 HTTP 隧道。 可能的值包括“none”、“HTTP”、“HTTPS”和“CONNECT”。 此属性仅在连接了 NetConnection 对象时有效。 此属性用于 Flex 应用程序和 Flash Media Server 应用程序。 在 Flash Player 9 中，仅当使用 RTMP、RTMPS 或 RTMPT 时，此属性才可用。 CONNECT 方法仅适用于通过代理服务器连接到网络的用户。

可以读取此属性以确定使用的是哪种连接方法。 如果使用的是直接连接方法，则此属性返回“none”；如果使用的是 HTTP 隧道方法，则此属性返回“HTTP”；如果使用的是安全 HTTPS 隧道方法，则此属性返回“HTTPS”；如果使用的是代理 CONNECT 方法，则此属性返回“CONNECT”。

在 SWF 文件中创建的 NetConnection 对象的默认对象编码（AMF 版本）。 当将对象写为二进制数据或从二进制数据读取对象时，defaultObjectEncoding 属性将指示应使用哪一个版本的 Action Message Format：ActionScript 3.0 格式还是 ActionScript 1.0 或 ActionScript 2.0 格式。

默认情况下，将 NetConnection.defaultObjectEncoding 设为使用 ActionScript 3.0 格式 (AMF3)。 更改 NetConnection.defaultObjectEncoding 不会影响现有 NetConnection 实例，只会影响随后创建的实例。

若要单独设置某个对象的编码（而非设置整个 SWF 文件的对象编码），请改为设置 NetConnection 对象的 objectEncoding 属性。

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

另请参见

此 NetConnection 实例的对象编码（AMF 版本）。 此属性的默认值为 defaultObjectEncoding 的值。 可接受的值为 ObjectEncoding.AMF3 和 ObjectEncoding.AMF0。

如果 ActionScript 3.0 SWF 文件需要与在 Flash Player 9 之前发布的服务器进行通信，则了解此属性非常重要。

当将对象写为二进制数据或从二进制数据读取对象时，objectEncoding 属性将指示应使用哪一个版本的 Action Message Format：ActionScript 3.0 格式 (ObjectEncoding.AMF3) 还是 ActionScript 1.0 或 ActionScript 2.0 格式 (ObjectEncoding.AMF0)。 当使用 NetConnection 对象连接到服务器时，有以下三种方案可用：

• 独占式连接到同 Flash Player 9 一起发布或在 Flash Player 9 之后发布的服务器，例如 Flex 2。 defaultObjectEncoding 的默认值是 ObjectEncoding.AMF3。 在此 SWF 文件中创建的所有 NetConnection 实例均使用 AMF3 序列化，因此不必设置 Flash Player 应使用哪种 AMF 编码。
• 独占式连接到在 Flash Player 9 之前发布的服务器，例如 Flex 1.5 和 Flash Media Server 2。 在此方案中，请将静态 defaultObjectEncoding 属性设置为 ObjectEncoding.AMF0。 在此 SWF 文件中创建的所有 NetConnection 实例均使用 AMF0 序列化。 因此不必设置 objectEncoding 属性。
• 连接到使用不同编码版本的多个服务器。 不使用 defaultObjectEncoding，而是使用每个连接的 objectEncoding 属性设置每个连接的对象编码。 若要连接到使用 AMF0 编码的服务器，例如 Flex 1.5 和 Flash Media Server 2，则将此属性设置为 ObjectEncoding.AMF0；若要连接到使用 AMF3 编码的服务器，例如 Flex 2，则将此属性设置为 ObjectEncoding.AMF3。

更改 defaultObjectEncoding 不会影响现有 NetConnection 实例，只会影响随后创建的实例。

一旦连接到 NetConnection 实例，其 objectEncoding 属性将变为只读。

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

另请参见

确定是否将本机 SSL 用于 RTMPS 而不是用于 HTTPS，以及是否使用建立隧道的 CONNECT 方法通过代理服务器进行连接。 可接受的值为“none”、“HTTP”、“CONNECT”、和“best”。 此属性用于 Flex 应用程序和 Flash Media Server 2 应用程序。

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

proxyType 属性可确定初始连接尝试失败后应使用的后备方法。 必须在调用 NetConnection.connect() 方法之前设置 proxyType 属性。 此属性可确定是否尝试使用本机传输层安全 (TLS)，以及在应用程序尝试连接时如果遇到代理服务器应如何与之协同工作。

在 Flash Player 9 中，此属性的默认值为“none”；如果未更改此值，Flash Player 将针对 RTMPS 使用 HTTPS 隧道。 如果将此属性设置为“best”，则将建立最佳连接方法并首先尝试最佳方法，如果失败则使用其它备用方法。 对于 RTMPS 连接，默认情况下使用本机 SSL 套接字，如有必要则使用其它备用方法。 如果将此属性设为“HTTP”并且直接连接失败，则将使用 HTTP 隧道的旧方法。 如果将此属性设为“CONNECT”并且直接连接失败，则将使用隧道的 CONNECT 方法。 如果后者也失败，连接不会使用备用的 HTTP 隧道方法。

若使用 connect 连接到服务器，则为传递给 NetConnection.connect() 的应用程序服务器的 URI。 如果尚未调用 NetConnection.connect() 或者未传递 URI，则此属性为 undefined。

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

创建一个 NetConnection 对象，可与 NetStream 对象一起用于调用远程应用程序服务器上的命令，或者在本地回放视频流 (FLV) 文件。 在创建 NetConnection 对象后，使用 connect() 进行实际连接。

与在 Flash 文档中嵌入视频相比，播放外部 FLV 文件有多个好处，例如更好的性能和内存管理以及独立的视频和 Flash 帧频。

如果 ActionScript 3.0 SWF 文件需要与在 Flash Player 9 之前发布的服务器进行通信，可能需要调整 NetConnection 对象的 objectEncoding 属性。

另请参见

将上下文标头添加到 AMF 数据包结构。 此标头将随以后的每个 AMF 数据包一起发送。 如果使用相同的名称调用 NetConnection.addHeader()，则新标头将代替现有标头，并在 NetConnection 对象的持续时间内始终使用新标头。 通过调用具有标头名称的 NetConnection.addHeader() 可以删除标头，进而删除未定义对象。 该方法与诸如 Flex 或 Flash Media Server 之类的服务器的使用相关。

参数

在运行 Flash Media Server 的服务器上或应用程序实例所连接的应用程序服务器上调用命令或方法。 必须创建要传递给此方法的服务器端函数。

参数

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

此方法将断开通过所有 NetStream 对象运行所依赖的连接；队列中尚未发送的数据将被丢弃。 （若要终止流而不关闭连接，请使用 NetStream.close()。） 如果调用此方法然后希望重新连接，则必须创建 NetStream 对象。

另请参见

打开到服务器的连接。 通过该连接，可以从本地文件系统回放音频或视频 (FLV) 文件，也可以在远程服务器上调用命令。

使用此方法时，请考虑 Flash Player 安全模型和下列安全注意事项：

• 默认情况下，网站将拒绝沙箱之间的访问。 通过使用跨域策略文件，网站可以实现对资源的访问。
• 通过在 Flash Media Server 中添加服务器端 ActionScript 应用程序逻辑，网站可以拒绝对资源的访问。
• 如果执行调用的 SWF 文件位于只能与本地文件系统内容交互的沙箱中，则不允许使用 NetConnection.connect() 方法。
• 可以在包含 SWF 内容的 HTML 页中设置 object 和 embed 标签的 allowNetworking 参数，防止 SWF 文件使用此方法。

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

• security chapter（在《ActionScript 3.0 编程》一书中）和有关 LiveDocs 的最新注释
• Flash Player 9 Security White Paper

参数

另请参见

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

此事件具有以下属性：

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

此事件具有以下属性：

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