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

この 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 ファイルのホストとして動作するサーバーにクロスドメインポリシーファイルを置いておく必要があります。

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

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

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

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

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

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

ストリームから 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 バイトを読み取り、ストリングを返します。

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

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

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

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

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

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

関連項目

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

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

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

関連項目

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

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

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

関連項目

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

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

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

関連項目

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

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

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

関連項目

例を実行するために、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);
        }
    }
}