入力バッファで読み取ることができるデータのバイト数を返します。bytesAvailable プロパティを呼び出して、読み取るデータが十分にあることを確認してから、いずれかの read メソッドを使用してデータを読み取るようにしてください。

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

データのバイト順を示します。有効な値は Endian.BIG_ENDIAN または Endian.LITTLE_ENDIAN です。

デフォルト値 : Endian.BIG_ENDIAN.

関連項目

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

関連項目

すぐにストリームを閉じ、ダウンロード処理をキャンセルします。close() メソッドの呼び出し後は、ストリームからデータを読み込みません。

request パラメータで指定された URL でのダウンロードを開始します。

メモ : ロード中のファイルに ASCII 文字以外の文字 (英語以外の多くの言語に存在する) が含まれている場合は、ASCII のような非 Unicode 形式ではなく UTF-8 または UTF-16 エンコーディング形式でファイルを保存することをお勧めします。

ロード処理がすぐに失敗すると、エラーについて説明する IOError または SecurityError (ローカルファイルのセキュリティエラーを含む) 例外がスローされます。その他に、URL ダウンロードでダウンロードが正常に開始した場合は open イベントが送出され、エラーが発生した場合はエラーイベントが送出されます。

デフォルトで、呼び出し元の SWF ファイルおよびロードする URL は同じドメインに置かれている必要があります。例えば、www.adobe.com に置かれている SWF ファイルは www.adobe.com に置かれているソースからのみデータをロードできます。 異なるドメインからデータをロードするには、データをホストするサーバに URL ポリシーファイルを配置します。

Flash Player では、一般的な予約ポートへは接続できません。ブロックされているポートの一覧については、セキュリティに関する章（『ActionScript 3.0 のプログラミング』）の「ネットワーク API の制限」を参照してください。

Flash Player では、SWF ファイルがこのメソッドを使用しないようにすることができます。そのためには、SWF コンテンツを含んでいる HTML ページに allowNetworking パラメータ（object タグおよび embed タグ）を設定します。

Flash Player 10 以降および AIR 1.5 以降では、「multipart/form-data」などのマルチパート Content-Type にアップロードが含まれていると（アップロードが含まれているかどうかは POST ボディ内の「content-disposition」ヘッダーの「filename」パラメータで示されます）、そのアップロードに適用されるセキュリティ規則によって POST 処理が拘束されます。

• POST 処理は、マウスのクリックやキーの押下などのユーザーが開始したアクションに応答して実行する必要があります。
• POST 処理がクロスドメインである (POST ターゲットが、POST 要求を送信中の SWF ファイルと同じサーバー上にない) 場合は、クロスドメインアクセスを許可する URL ポリシーファイルをターゲットサーバーが提供する必要があります。

また、すべてのマルチパート Content-Type では、RFC2046 標準に準拠した有効なシンタックスを使用する必要があります。シンタックスが有効でない場合は、アップロードに適用されるセキュリティ規則によって POST 処理が拘束されます。

これらのルールは、アプリケーションサンドボックス内にない AIR コンテンツにも適用されます。ただし、Adobe AIR では、アプリケーションサンドボックス内のコンテンツ（AIR アプリケーションと共にインストールされたコンテンツ）は、これらのセキュリティ制限による制限を受けません。

セキュリティ情報について詳しくは、以下を参照してください。

• セキュリティに関する章（『ActionScript 3.0 のプログラミング』）と LiveDocs に関する最新のコメント
• Flash Player デベロッパーセンタートピック：セキュリティ
• 『Developing AIR Applications』の「Getting started with Adobe AIR」の「Understanding AIR Security」

AIR では、URLRequest オブジェクトを httpResponse ステータスイベントに登録できます。httpStatus イベントと異なり、httpResponseStatus イベントは応答データの前に配信されます。また、httpResponseStatus イベントには responseHeaders プロパティと responseURL プロパティの値が含まれます（これらは httpStatus イベントでは定義されていません）。httpResponseStatus イベントは、発生した場合、complete イベントまたは error イベントの前に、これらのイベントとは別に送信されます。

httpResponseStatus イベントリスナーがある場合、応答メッセージの本文が常に送信されます。また、HTTP ステータスコードの応答は、常に、complete イベントになります。HTTP 応答ステータスコードが成功またはエラーのどちらを示しているかに関係なく、常にこのようになります。

AIR では、このイベントリスナーが存在しない（つまり、httpResponseStatus イベントリスナーが存在しない）場合、SWF の AIR のバージョンによって動作が異なります。

• SWF 9 コンテンツでは、HTTP 応答のステータスコードが成功を示している場合のみ、HTTP 応答メッセージの本文が送信されます。それ以外の場合（エラーがある場合）は、本文は送信されず、URLRequest オブジェクトは IOError イベントを送出します。
• SWF 10 コンテンツでは、HTTP 応答メッセージの本文は必ず送信されます。エラーがある場合は、URLRequest オブジェクトは IOError イベントを送出します。

パラメータ

関連項目

ストリームからブール値を読み取ります。1 バイトが読み取られ、バイトがゼロ以外の場合は true、それ以外の場合は false が返されます。

ストリームから符号付きバイトを読み取ります。

返される値は -128 ～ 127 の範囲です。

ストリームから length バイトのデータを読み取ります。このバイトは、bytes で指定した ByteArray オブジェクトに読み込まれます。ByteArray オブジェクトの offset バイトの位置から読み込みが開始されます。

パラメータ

ストリームから IEEE 754 倍精度浮動小数点数を読み取ります。

ストリームから IEEE 754 単精度浮動小数点数を読み取ります。

ストリームから符号付き 32 ビット整数を読み取ります。

返される値は -2147483648 ～ 2147483647 の範囲です。

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

パラメータ

ソケットから Action Message Format (AMF) 形式でエンコードされたオブジェクトを読み取ります。

関連項目

ストリームから符号付き 16 ビット整数を読み取ります。

返される値は -32768 ～ 32767 の範囲です。

ストリームから符号なしバイトを読み取ります。

返される値は 0 ～ 255 の範囲です。

ストリームから符号なし 32 ビット整数を読み取ります。

返される値は 0 ～ 4294967295 の範囲です。

ストリームから符号なし 16 ビット整数を読み取ります。

返される値は 0 ～ 65535 の範囲です。

ストリームから UTF-8 ストリングを読み取ります。このストリングには、バイト単位の長さを示す符号なし short が前に付いているものと見なされます。

ストリームから length の UTF-8 バイトを読み取り、ストリングを返します。

パラメータ

データが正常にロードされたときに送出されます。

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

URLStream.load() メソッドを呼び出して HTTP を介してデータにアクセスを試み、Adobe AIR で要求のステータスコードを検出して返すことができる場合に送出されます。

URLStream オブジェクトに httpStatusEvent イベントを登録すると、エラー応答がコンテンツであるかのように配信されます。このため、URLStream は、エラーデータが URLStream にロードされると、ioError イベントを送出する代わりに progress イベントおよび complete イベントを送出します。

HTTPStatusEvent.HTTP_RESPONSE_STATUS 定数は、type プロパティ（httpResponseStatus イベントオブジェクト）の値を定義します。

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

関連項目

URLStream.load() を呼び出して HTTP を介してデータにアクセスを試み、Flash Player または Adobe AIR で要求のステータスコードを検出して返すことができる場合に送出されます。 (一部のブラウザ環境ではこの情報を提供できません)。httpStatus が発生した場合は、complete イベントまたは error イベントの前に、これらのイベントとは別に送信されます。

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

関連項目

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

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

関連項目

ロード操作が開始したときに送出されます。

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

関連項目

ダウンロード処理を実行中にデータを受信したときに送出されます。受け取ったデータは、URLStream クラスのメソッドを使用してすぐに読み取ることができます。

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

関連項目

URLStream.load() の呼び出しによってセキュリティサンドボックスの外部にあるサーバーからデータをロードしようとすると送出されます。

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

関連項目

例を実行するために、URLStreamExample.swf という名前のファイルを SWF ファイルと同じディレクトリに配置してください。

package {
    import flash.display.Sprite;
    import flash.errors.*;
    import flash.events.*;
    import flash.net.URLRequest;
    import flash.net.URLStream;

    public class URLStreamExample extends Sprite {
        private static const ZLIB_CODE:String = "CWS";
        private var stream:URLStream;

        public function URLStreamExample() {
            stream = new URLStream();
            var request:URLRequest = new URLRequest("URLStreamExample.swf");
            configureListeners(stream);
            try {
                stream.load(request);
            } catch (error:Error) {
                trace("Unable to load requested URL.");
            }
        }

        private function configureListeners(dispatcher:EventDispatcher):void {
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
        }

        private function parseHeader():void {
            trace("parseHeader");
            trace("isCompressed: " + isCompressed());
            trace("version: " + stream.readByte());
        }

        private function isCompressed():Boolean {
            return (stream.readUTFBytes(3) == ZLIB_CODE);
        }

        private function completeHandler(event:Event):void {
            trace("completeHandler: " + event);
            parseHeader();
        }

        private function openHandler(event:Event):void {
            trace("openHandler: " + event);
        }

        private function progressHandler(event:Event):void {
            trace("progressHandler: " + event);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

        private function httpStatusHandler(event:HTTPStatusEvent):void {
            trace("httpStatusHandler: " + event);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }
    }
}