コールバックメソッドが呼び出されるオブジェクトを示します。デフォルト値はこの NetConnection インスタンスです。client プロパティを別のオブジェクトに設定する場合は、コールバックメソッドをその別のオブジェクトで呼び出すことができます。

永続的な 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 オブジェクトを使用してサーバーに接続するときは、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 プロパティを ObjectEncoding.AMF0 に設定します。この SWF ファイルに作成されるすべての NetConnection インスタンスでは、AMF0 直列化を使用します。objectEncoding プロパティを設定する必要はありません。
• 異なるエンコーディングバージョンを使用する複数のサーバーに接続する場合。defaultObjectEncoding を使用せずに、各接続の objectEncoding プロパティを使用して、接続ごとにオブジェクトエンコーディングを設定します。このプロパティを ObjectEncoding.AMF0 に設定すると、AMF0 エンコーディングを使用するサーバー (Flex 1.5、Flash Media Server 2 など) に接続します。ObjectEncoding.AMF3 に設定すると、AMF3 エンコーディングを使用するサーバー (Flex 2) に接続します。

defaultObjectEncoding を変更しても、既存の NetConnection インスタンスには影響せず、それ以降に作成されたインスタンスにのみ影響します。

NetConnection インスタンスが接続されたら、その objectEncoding プロパティは読み取り専用になります。

サーバーへの接続に誤ったエンコーディングを使用した場合、Flash Player により netStatus イベントが送出されます。NetStatusEvent.info プロパティには、code プロパティの値 NetConnection.Connect.Failed を持つ情報オブジェクトとオブジェクトエンコードが正しくないことを示す説明が含まれています。

関連項目

ネイティブ SSL が HTTPS ではなく RTMPS に使用されるかどうか、トンネリングの CONNECT メソッドがプロキシサーバーを介して接続するために使用されるかどうかを調べます。指定できる値は、"none"、"HTTP"、"CONNECT"、および "best" です。このプロパティは、Flex アプリケーションおよび Flash Media Server 2 アプリケーションで使用されます。

Flash Player 9 では、このプロパティは RTMP、RTMPS、または RTMPTを使用している場合にのみ適用できます。CONNECT メソッドは、プロキシサーバー経由でネットワークに接続しているユーザーにのみ適用できます。

proxyType プロパティは、最初の接続の試行が失敗したときに試行されるフォールバックメソッドを指定します。NetConnection.connect() メソッドを呼び出す前に、proxyType プロパティを設定する必要があります。このプロパティは、接続試行時に、ネイティブ TLS (Transport Layer Security) を使用するかどうか、および、アプリケーションで認識されるプロキシサーバーの操作方法を決定します。

Flash Player 9 では、このプロパティのデフォルト値は "none" です。この値を変更しない場合、Flash Player は RTMPS に HTTPS トンネリングを使用します。プロパティが "best" に設定されている場合は、接続に最適な方法が確立され、この最適な方法がまず試行されます。失敗した場合は別のメソッドにフォールバックされます。RTMPS 接続では、デフォルトでネイティブ SSL ソケットが使用されます。別のメソッドへのフォールバックは、必要に応じて使用されます。プロパティが "HTTP" に設定されており、直接接続に失敗した場合は、HTTP トンネリングの古いメソッドが使用されます。プロパティが "CONNECT" に設定されており、直接接続に失敗した場合は、HTTP トンネリングの CONNECT メソッドが使用されます。これに失敗すると、接続は HTTP トンネリングにフォールバックされなくなります。

connect がサーバーへの接続に使用された場合、NetConnection.connect() に渡されたアプリケーションサーバーの URIです。NetConnection.connect() がまだ呼び出されていない場合、または URI が渡されていない場合、このプロパティは undefined になります。

HTTPS ではなく、ネイティブ TLS を使用してセキュア接続が確立されたかどうかを示します。このプロパティは、NetConnection オブジェクトが接続されている場合にのみ有効です。

リモートアプリケーションサーバーでコマンドを起動したり、ローカルで、またはサーバーからストリーミングビデオファイル (FLV) を再生するために、NetStream オブジェクトと組み合わせて使用することが可能な NetConnection オブジェクトを生成します。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.Close の code プロパティで、netStatus イベントを送出します。

このメソッドは、この接続上で実行されているすべての NetStream オブジェクトを切断します。送信されていないキュー内のデータはすべて破棄されます。接続を閉じずにローカルまたはサーバーストリームを終了するには、NetStream.close() を使用します。このメソッドを呼び出した後で再接続する場合は、NetStream オブジェクトを再作成する必要があります。

このメソッドは、この接続上で実行されているすべてのリモート共有オブジェクトも切断します。ただし、再接続するために共有オブジェクトを再作成する必要はありません。SharedObject.connect() を呼び出すだけで、共有オブジェクトへの接続を再確立できます。また、共有オブジェクトへの接続が再確立されると、NetConnection.close() を発行したときにキュー内にあった共有オブジェクトのデータがすべて送信されます。

関連項目

サーバーへの接続を開きます。この接続を介して、HTTP アドレスまたはローカルファイルシステムからオーディオまたはビデオ (FLV) ファイルを再生したり、リモートサーバーでコマンドを呼び出したりすることができます。

このメソッドを使用する場合は、Flash Player セキュリティモデルおよび次のセキュリティについての考慮事項を検討してください。

• デフォルトでは、Web サイトではサンドボックス間のアクセスは拒否されます。クロスドメインポリシーファイルを使用して、Web サイトでリソースにアクセスできるようになります。
• Web サイトでは、Flash Media Server にサーバーサイド ActionScript アプリケーションロジックを追加することにより、リソースへのアクセスを拒否できます。
• 呼び出し元 SWF ファイルがローカルファイルシステムのサンドボックスに配置されている場合は、NetConnection.connect() メソッドを使用できません。

詳細については、次のトピックを参照してください。

• 『ActionScript 3.0 のプログラミング』のセキュリティの章と LiveDocs の最新コメント
• Flash Player 9 セキュリティに関するホワイトペーパー

関連項目

非同期形式で、つまりネイティブ非同期コードから例外がスローされると送出されます。

AsyncErrorEvent.ASYNC_ERROR 定数は、asyncError イベントオブジェクトの type プロパティ値を定義します。

このイベントには、次のプロパティがあります。

入出力エラーが発生してネットワーク処理が失敗したときに送出されます。

ioError イベントオブジェクトの type プロパティの値を定義します。

このイベントには、次のプロパティがあります。

NetConnection オブジェクトが、そのステータスまたはエラーの状況をレポートするときに送出されます。netStatus イベントには info プロパティが含まれます。このプロパティは、接続試行が成功したかどうかなど、イベントに関する特定の情報を含む情報オブジェクトです。

netStatus イベントオブジェクトの type プロパティの値を定義します。

このイベントには、次のプロパティがあります。

関連項目

NetConnection.call() の呼び出しによって呼び出し元のセキュリティサンドボックスの外部にあるサーバーに接続しようとすると送出されます。

SecurityErrorEvent.SECURITY_ERROR 定数は、securityError イベントオブジェクトの type プロパティ値を定義します。

このイベントには、次のプロパティがあります。

関連項目

この例では、Video オブジェクトと NetStream オブジェクトを作成し、 Video.attachNetStream() メソッドと NetStream.play() メソッドを呼び出すコードが ハンドラ関数に配置されます。ハンドラは、 NetConnection オブジェクトとの接続が成功した場合にのみ呼び出されます。つまり、 netStatus イベントが、成功したことを示す code プロパティとともに info オブジェクトを返す 場合です。 接続に成功するまで待ってから、次のコードを呼び出すことをお勧めします。 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);
    }
}