入力バッファーで読み取ることができるデータのバイト数です。

コードでは、bytesAvailable にアクセスして入力バッファーの空き容量を確認してから、read メソッドの 1 つを使用してデータを読み取る必要があります。

ソケットの書き込みバッファーからネットワークトランスポートレイヤーへの転送を待機しているデータの量を示します（バイト単位）。

次の操作は、bytesPending の値に影響を与えます。

• Socket.connect() を呼び出すと、bytesPending が 0 に設定されます。
• Socket.write*() メソッドの 1 つを呼び出して、書き込みバッファーにデータを追加すると、bytesPending が更新されます。
• オペレーティングシステムにより、書き込みバッファーからネットワークトランスポートレイヤーソケットにデータが移動されると、bytesPending が更新されます。
• Socket.close() を呼び出すと、bytesPending が 0 に設定されます（書き込みバッファーはソケットを閉じたときに破棄されます）。

この Socket オブジェクトが現在、接続されているかどうかを示します。このプロパティの呼び出しは、現在ソケットが接続されている場合に値 true を、それ以外の場合は false を返します。

データのバイト順序を示します。指定できる値は flash.utils.Endian クラスの定数で、Endian.BIG_ENDIAN または Endian.LITTLE_ENDIAN です。

デフォルト値： Endian.BIG_ENDIAN。

関連する API エレメント

ローカルマシン上でこのソケットがバインドされている IP アドレス。

関連する API エレメント

ローカルマシン上でこのソケットがバインドされているポート。

関連する API エレメント

オブジェクトの書き込みまたは読み取り時に使用される AMF のバージョンを制御します。

関連する API エレメント

このソケットが接続されているリモートマシンの IP アドレス。

このプロパティを使用して、ServerSocket オブジェクトによって ServerSocketConnectEvent 内に送出されたクライアントソケットの IP アドレスを特定します。DNSResolver クラスを使用すると、IP アドレスをドメイン名に変換できます。

関連する API エレメント

このソケットが接続されているリモートマシンのポート。

このプロパティを使用して、ServerSocket オブジェクトによって ServerSocketConnectEvent 内に送出されたクライアントソケットのポート番号を特定します。

関連する API エレメント

接続までの待ち時間（ミリ秒数）を示します。

指定した時間内に接続できなかったときは、接続が失敗することになります。デフォルト値は 20,000（20 秒）です。

Socket オブジェクトを作成します。パラメーターを指定しないと、初期状態では未接続のソケットが作成されます。パラメーターを指定すると、指定したホストおよびポートへの接続が試行されます。

注意： コントラクターフォームをパラメーターを付けずに使用することを強くお勧めします。次に、イベントリスナーを追加し、host および port パラメーターを付けて connect メソッドを呼び出します。このシーケンスによって、すべてのイベントリスナーが正しく動作します。

ソケットを閉じます。close() メソッドが呼び出された後は、データの読み書きはできません。

close イベントは、サーバーにより接続が閉じられたときのみ送出されます。close() メソッドを呼び出しても送出されません。

Socket オブジェクトで connect() メソッドをもう一度呼び出すことで、その Socket オブジェクトを再使用できます。

指定されたホストおよびポートにソケットを接続します。

直後に接続が失敗した場合、イベントが送出されるか例外がスローされます。ホストが指定されている場合はエラーイベントが送出され、ホストが指定されていない場合は例外がスローされます。それ以外の場合、イベントにより、接続のステータスがレポートされます。ソケットが既に接続済みの場合、最初に既存の接続が閉じられます。

注意 ： ソケットへの接続に関するベストプラクティスについては、Socket クラスの説明を参照してください。

パラメーター

さらに例を参照

ソケットの出力バッファーに蓄積されたデータをフラッシュします。

オペレーティングシステムによっては、flush() は実行フレーム間で自動的に呼び出されますが、Windows などのオペレーティングシステムでは、flush() を明示的に呼び出さない限り、データは送信されません。ソケットに書き込みを行うたびに、flush() メソッドを呼び出すことをお勧めします。

ソケットからブール値を読み取ります。1 バイトを読み取った後、メソッドはバイトがゼロ以外の場合は true、それ以外の場合は false を返します。

ソケットから符号付きバイトを読み取ります。

ソケットから、length パラメーターで指定したデータバイト数を読み取ります。このバイトは、指定したバイト配列の、offset で指定された位置以降に読み込まれます。

パラメーター

ソケットから IEEE 754 倍精度浮動小数点数を読み取ります。

ソケットから IEEE 754 単精度浮動小数点数を読み取ります。

ソケットから符号付き 32 bit 整数を読み取ります。

指定した文字セットを使用して、バイトストリームからマルチバイトストリングを読み取ります。

パラメーター

ソケットから AMF 直列化形式でエンコードされたオブジェクトを読み取ります。

関連する API エレメント

ソケットから符号付き 16 bit 整数を読み取ります。

ソケットから符号なしバイトを読み取ります。

ソケットから符号なし 32 bit 整数を読み取ります。

ソケットから符号なし 16 bit 整数を読み取ります。

ソケットから UTF-8 ストリングを読み取ります。このメソッドは、文字列の先頭に、長さ（バイト単位）を表す符号なしの Short 整数が付いていることを前提にしています。

ソケットから length パラメーターで指定した UTF-8 バイト数を読み取り、ストリングを返します。

パラメーター

ソケットにブール値を書き込みます。このメソッドは 1 バイトを書き込みます。1（true の場合）または 0（false の場合）のいずれかの値が使用されます。

パラメーター

関連する API エレメント

ソケットに 1 バイトを書き込みます。

パラメーター

関連する API エレメント

指定したバイト配列のバイトのシーケンスを書き込みます。書き込み操作は、offset で指定された位置から開始されます。

length パラメーターを省略するとデフォルトの長さ 0 が使用され、offset の位置からバッファー全体が書き込まれます。

また、offset パラメーターが省略された場合、メソッドはバッファー全体に書き込みを行います。

パラメーター

関連する API エレメント

ソケットに IEEE 754 倍精度浮動小数点数を書き込みます。

パラメーター

関連する API エレメント

ソケットに IEEE 754 単精度浮動小数点数を書き込みます。

パラメーター

関連する API エレメント

ソケットに 32 bit 符号付き整数を書き込みます。

パラメーター

関連する API エレメント

指定した文字セットを使用して、バイトストリームからマルチバイトストリングを書き込みます。

パラメーター

関連する API エレメント

ソケットに AMF 直列化形式でオブジェクトを書き込みます。

パラメーター

関連する API エレメント

ソケットに 16 bit 整数を書き込みます。次のようにバイトが書き込まれます。

(v >> 8) & 0xff v & 0xff

パラメーターの下位 16 ビットが使用されます。上位 16 ビットは無視されます。

パラメーター

関連する API エレメント

ソケットに 32 bit 符号なし整数を書き込みます。

パラメーター

関連する API エレメント

次のデータをソケットに書き込みます：

• 16 bit 符号なし整数。この整数は、指定された UTF-8 文字列の長さをバイト数で表したものです。
• 指定された UTF-8 文字列。

文字列を書き込む前に、メソッドによって文字列のすべての文字を表すのに必要なバイト数が計算されます。

パラメーター

関連する API エレメント

ソケットに UTF-8 ストリングを書き込みます。

パラメーター

関連する API エレメント

サーバーによりソケット接続が閉じられたときに送出されます。

close イベントは、サーバーにより接続が閉じられたときのみ送出されます。Socket.close() メソッドを呼び出しても送出されません。

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

ネットワーク接続が確立されたときに送出されます。

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

入出力エラーが発生して送信またはロード操作が失敗したときに送出されます。

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

ソケットによってデータが書き込みバッファーからネットワークトランスポートレイヤーに移動されるときに送出されます。書き込みバッファーで保留になっているデータの量を判断するには、このイベントオブジェクトで bytesPending プロパティを使用します。

このイベントを使用すると、例えば、ソケットを使用しているアプリケーションを操作の完了前に閉じてしまった場合に、データの損失を防ぐことができます。ソケットを閉じる前、またはソケットをガベージコレクションに出す前に、ソケットプロパティ bytesPending が 0 になっていることを確認します。

このイベントの詳細と例については、Socket Improvements in AIR 3 を参照してください。

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

Socket.call() の呼び出しによって呼び出し元のセキュリティサンドボックスにより禁止されているサーバーに接続しようとすると送出されます。このイベントは、ポート ID が 1024 番未満のときに、このような接続を許可するソケットポリシーファイルが存在しない場合にも送出されます。

注意 ： AIR アプリケーションでは、アプリケーションのセキュリティサンドボックスで実行されている内容は、ソケットポリシーファイルがなくても、任意のサーバーおよびポート番号に接続できます。

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

関連する API エレメント

ソケットがデータを受信したときに送出されます。

ソケットが受信するデータは、読み込まれるまでソケットに残ります。このイベントが通知されたら、受信したデータの一部、またはすべてを読み込むことができます。

注意 ： socketData タイプのイベントでは、ProgressEvent.bytesTotal プロパティは使用されません。

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

注意：この例をテストするには、次の操作を実行します。

1. プロジェクトディレクトリに AIRAliases.js ファイルを追加します。
2. Socket() コンストラクターが有効な URL とポートを指定するようにコードを変更します。
3. プロジェクトのアプリケーション記述ファイルを作成し、ADL を使用してプロジェクトをテストします。

<html>
<head>
    <script src="AIRAliases.js" />
    <script>
    var socket;
    var response;
    function init() {
        socket = new air.Socket("localhost", 80);
        socket.addEventListener(air.Event.CLOSE, closeHandler);
        socket.addEventListener(air.Event.CONNECT, connectHandler);
        socket.addEventListener(air.IOErrorEvent.IO_ERROR, ioErrorHandler);
        socket.addEventListener(air.SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
        socket.addEventListener(air.ProgressEvent.SOCKET_DATA, socketDataHandler);
    }
    function writeln(str) {
        str += "\n";
        try {
            socket.writeUTFBytes(str);
        }
        catch(e) {
            air.trace(e);
        }
    }
    function sendRequest() {
        air.trace("sendRequest");
        response = "";
        writeln("GET /");
        socket.flush();
    }
    function readResponse() {
        var str = socket.readUTFBytes(socket.bytesAvailable);
        response += str;
    }
    function closeHandler(event) {
        air.trace("closeHandler: " + event);
        air.trace(response.toString());
    }
    function connectHandler(event) {
        air.trace("connectHandler: " + event);
        sendRequest();
    }
    function ioErrorHandler(event) {
        air.trace("ioErrorHandler: " + event);
    }
    function securityErrorHandler(event) {
        air.trace("securityErrorHandler: " + event);
    }
    function socketDataHandler(event) {
        air.trace("socketDataHandler: " + event);
        readResponse();
    }
    </script>
</head>
<body onload='init()'>
</body>
</html>