AVURLStream - Adobe ActionScript® 3（AS3 ）API リファレンス

パッケージ	flash.media
クラス	public class AVURLStream
継承	AVURLStream URLStream EventDispatcher Object

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

URLStream クラスはダウンロード用 URL への低レベルのアクセスを提供します。データはダウンロードされるとすぐにアプリケーションコードで使用できるようになります。URLLoader の場合のように、ファイル全体がダウンロードされるまで待つ必要はありません。URLStream クラスでは、ダウンロードの完了前にストリームを閉じることもできます。ダウンロードされたファイルの内容は、生のバイナリデータとして利用できます。

URLStream の読み取り操作で、ブロッキングは発生しません。つまり、読み取るデータが十分にあるかどうかを bytesAvailable プロパティを使用して確認してから、データを読み取る必要があります。データが十分にない場合は、EOFError 例外がスローされます。

すべてのバイナリデータは、ビッグエンディアン形式がデフォルトのエンコーディングです。ビッグエンディアンでは、最上位バイトが最初になります。

URLStream クラスでダウンロードしている URL に適用されるセキュリティルールは、URLLoader オブジェクトに適用されるルールと同一です。ポリシーファイルは、必要に応じてダウンロードされます。ローカルファイルのセキュリティルールが適用され、必要に応じてセキュリティ警告が発生します。

関連する API エレメント

URLLoader
URLRequest

パブリックプロパティ

継承されるパブリックプロパティを隠す

継承されるパブリックプロパティを表示

	プロパティ		定義元
		bytesAvailable : uint [読み取り専用] 入力バッファーで読み取ることができるデータのバイト数を返します。	URLStream
		connected : Boolean [読み取り専用] この URLStream オブジェクトが現在、接続されているかどうかを示します。	URLStream
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。	Object
		cookieHeader : String [書き込み専用]	AVURLStream
		endian : String データのバイト順を示します。	URLStream
		objectEncoding : uint オブジェクトの書き込みまたは読み取り時に使用される Action Message Format（AMF）のバージョンを制御します。	URLStream

パブリックメソッド

継承されるパブリックメソッドを隠す

継承されるパブリックメソッドを表示

	メソッド		定義元
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。	EventDispatcher
		close():void すぐにストリームを閉じ、ダウンロード処理をキャンセルします。	URLStream
		dispatchEvent(event:Event):Boolean イベントをイベントフローに送出します。	EventDispatcher
		hasEventListener(type:String):Boolean EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。	EventDispatcher
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		load(request:URLRequest):void [オーバーライド] request パラメーターで指定された URL でのダウンロードを開始します。	AVURLStream
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		readBoolean():Boolean ストリームからブール値を読み取ります。	URLStream
		readByte():int ストリームから符号付きバイトを読み取ります。	URLStream
		readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void ストリームから length バイトのデータを読み取ります。	URLStream
		readDouble():Number ストリームから IEEE 754 倍精度浮動小数点数を読み取ります。	URLStream
		readFloat():Number ストリームから IEEE 754 単精度浮動小数点数を読み取ります。	URLStream
		readInt():int ストリームから符号付き 32 bit 整数を読み取ります。	URLStream
		readMultiByte(length:uint, charSet:String):String 指定した文字セットを使用して、バイトストリームから指定した長さのマルチバイトストリングを読み取ります。	URLStream
		readObject():* ソケットから Action Message Format（AMF）形式でエンコードされたオブジェクトを読み取ります。	URLStream
		readShort():int ストリームから符号付き 16 bit 整数を読み取ります。	URLStream
		readUnsignedByte():uint ストリームから符号なしバイトを読み取ります。	URLStream
		readUnsignedInt():uint ストリームから符号なし 32 bit 整数を読み取ります。	URLStream
		readUnsignedShort():uint ストリームから符号なし 16 bit 整数を読み取ります。	URLStream
		readUTF():String ストリームから UTF-8 ストリングを読み取ります。	URLStream
		readUTFBytes(length:uint):String ストリームから length の UTF-8 バイトを読み取り、ストリングを返します。	URLStream
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher オブジェクトからリスナーを削除します。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		toLocaleString():String ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object
		willTrigger(type:String):Boolean 指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。	EventDispatcher

イベント

イベントの詳細についてはここをクリックしてください

継承されるイベントを隠す

継承されるイベントを表示

	概要	定義元
activate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。	EventDispatcher
complete	データが正常にロードされたときに送出されます。	URLStream
deactivate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。	EventDispatcher
httpResponseStatus	URLStream.load() メソッドを呼び出して HTTP を介してデータにアクセスを試み、Adobe AIR で要求のステータスコードを検出して返すことができる場合に送出されます。	URLStream
httpStatus	URLStream.load() を呼び出して HTTP を介してデータにアクセスを試み、Flash Player または Adobe AIR で要求のステータスコードを検出して返すことができる場合に送出されます。	URLStream
ioError	入出力エラーが発生してロード操作が失敗したときに送出されます。	URLStream
open	ロード操作が開始したときに送出されます。	URLStream
progress	ダウンロード処理を実行中にデータを受信したときに送出されます。	URLStream
securityError	URLStream.load() の呼び出しによってセキュリティサンドボックスの外部にあるサーバーからデータをロードしようとすると送出されます。	URLStream

プロパティの詳細

cookieHeader

プロパティ

cookieHeader:String [書き込み専用]

実装
public function set cookieHeader(value:String):void

メソッドの詳細

load

()

メソッド

override public function load(request:URLRequest):void

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

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 アプリケーションと共にインストールされたコンテンツ）は、これらのセキュリティ制限による制限を受けません。

セキュリティについて詳しくは、Flash Player デベロッパーセンターのトピック：セキュリティを参照してください。

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 イベントが送出されます。

パラメーター

request:URLRequest — ダウンロードする URL を指定する URLRequest オブジェクトです。このパラメーターの値、または渡された URLRequest オブジェクトの URLRequest.url プロパティが null の場合、アプリケーションは null ポインターエラーをスローします。

イベント

	`complete:Event` — データが正常にロードされた後に送出されます。`httpResponseStatus` イベントリスナーが存在する場合、URLRequest オブジェクトは、HTTP 応答のステータスコードが成功またはエラーのいずれを示しているかを通知する `complete` イベントも送出します。

	`httpStatus:HTTPStatusEvent` — アクセスが HTTP 経由で、現在の環境がステータスコードの取得をサポートしている場合、`complete` イベントや `error` イベントに加えて、これらのイベントを受け取る場合があります。

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

	`ioError:IOErrorEvent` — ロード操作を完了できませんでした。

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

	`securityError:SecurityErrorEvent` — 呼び出し元のセキュリティ Sandbox の外部にあるサーバーからデータを取得しようとするロード操作です。これはサーバー上のポリシーファイルを使用すると回避できます。

例外

	`ArgumentError` — `URLRequest.requestHeader` オブジェクトには、禁止されている特定の HTTP リクエストヘッダーを含めることはできません。詳細については、URLRequestHeader クラスの説明を参照してください。

	`MemoryError` — このエラーは、次の理由で発生する可能性があります。 Flash Player または Adobe AIR では `URLRequest.data` パラメーターを UTF8 から MBCS に変換できません。このエラーは、`load()` に渡された URLRequest オブジェクトが `GET` 操作を行うように設定されている場合、および `System.useCodePage` が `true` に設定されている場合に発生することがあります。 Flash Player または Adobe AIR では `POST` データにメモリを割り当てることができません。このエラーは、load に渡された URLRequest オブジェクトが `POST` 操作を行うように設定されている場合に発生することがあります。

	`SecurityError` — 信頼されていないローカル SWF ファイルはインターネットへの接続を許可されません。これは、ネットワークアクセスを許可されたローカル SWF ファイル、または信頼できる SWF ファイルとして再分類すると回避できる場合があります。

	`SecurityError` — 一般的な予約ポートに接続しようとしています。遮断されたポートの詳しいリストについては、『ActionScript 3.0 開発ガイド』の「ネットワーク API の制限」を参照してください。

法律上の注意 | プライバシーポリシー

AVURLStream - AS3

クラス x

cookieHeader

load