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

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

データのバイト順序を示します。指定できる値は BIG_ENDIAN または LITTLE_ENDIAN です。

デフォルト値 : Endian.BIG_ENDIAN.

関連項目

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

関連項目

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

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

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

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

このメソッドを使用するときは、Adobe^® Flash^® Player セキュリティモデルを考慮してください。

• 呼び出し元 SWF ファイルが ローカルファイルシステムのサンドボックスにあり、ターゲットリソースがネットワーク上のサンドボックスにある場合、データをロードできません。
• 呼び出し元 SWF ファイルがネットワーク上のサンドボックスにあり、ターゲットリソースがローカルにある場合、データをロードできません。
• デフォルトで、ロードする URL は呼び出し元の SWF ファイルと同じドメインに置かれている必要があります。たとえば www.adobe.com に置かれている SWF ファイルは、www.adobe.com に置かれているソースからのみデータをロードできます。異なるドメインからデータをロードするには、データをホストするサーバーにクロスドメインポリシーファイルを配置します。
• SWF ファイルがこのメソッドを使用しないようにするには、SWF コンテンツを含んでいる HTML ページに allowNetworking パラメータ (object タグおよび embed タグ) を設定します。

詳細については、以下を参照してください。

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

パラメータ

関連項目

ストリームからブール値を読み取ります。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 が接頭辞として付くことが前提となっています。

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

パラメータ

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

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

URLStream.load() を呼び出して HTTP を介してデータにアクセスを試み、現在の Flash Player で要求のステータスコードを検出して返すことができる場合に送出されます。(一部のブラウザ環境ではこの情報を提供できません)。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);
        }
    }
}