AVURLLoader

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

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

URLLoader クラスは、指定した URL からテキスト、バイナリデータ、または URL エンコード形式の変数をダウンロードする際に使用します。動的なデータ駆動アプリケーションで使用するテキストファイル、XML、その他の情報をダウンロードする場合に便利です。

URLLoader オブジェクトは、アプリケーションのコードでデータを使用できるように、事前にすべてのデータを URL からダウンロードします。 URLLoader オブジェクトは、ダウンロードの進捗に関する通知を送信します。この通知は、送出済みのイベントと、bytesLoaded プロパティおよび bytesTotal プロパティで監視できます。

FLV のように非常に大きなビデオファイルをロードする場合、メモリ不足のエラーが起こることがあります。

Flash Player、およびアプリケーションセキュリティサンドボックス以外のセキュリティサンドボックス内の AIR アプリケーションコンテンツでこのクラスを使用するときは、次のセキュリティモデルを考慮してください。

ローカルファイルシステムのサンドボックスの SWF ファイルは、ネットワーク上のサンドボックス内のリソースからデータを読み込んだり、リソースにデータを書き込んだりしないことがあります。
デフォルトで、呼び出し元の SWF ファイルおよびロードする URL は同じドメインに置かれている必要があります。例えば、www.adobe.com に置かれている SWF ファイルは www.adobe.com に置かれているソースからのみデータをロードできます。異なるドメインからデータをロードするには、データをホストするサーバーに URL ポリシーファイルを配置します。

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

関連する API エレメント

URLRequest
URLVariables
AVURLStream

パブリックプロパティ

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

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

	プロパティ		定義元
		bytesLoaded : uint = 0 ロード操作中に、既にロード済みのデータのバイト数を示します。	URLLoader
		bytesTotal : uint = 0 ダウンロードデータの合計バイト数を示します。	URLLoader
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。	Object
		cookieHeader : String [書き込み専用]	AVURLLoader
		data : * ロード操作によって受信したデータです。	URLLoader
		dataFormat : String = "text" ダウンロードしたデータがテキスト（URLLoaderDataFormat.TEXT）生のバイナリデータ（URLLoaderDataFormat.BINARY）、または URL エンコードされた変数（URLLoaderDataFormat.VARIABLES）のいずれであるかを制御します。	URLLoader

パブリックメソッド

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

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

	メソッド		定義元
		AVURLLoader(request:URLRequest = null) URLLoader オブジェクトを作成します。	AVURLLoader
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [オーバーライド]	AVURLLoader
		close():void [オーバーライド] 進行中のロード操作は直ちに終了します。	AVURLLoader
		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 [オーバーライド] 指定された URL からデータを送信およびロードします。	AVURLLoader
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		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	受信したすべてのデータがデコードされ、URLLoader オブジェクトの data プロパティに配置された後に送出されます。	AVURLLoader
deactivate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。	EventDispatcher
httpResponseStatus	load() メソッドを呼び出し、HTTP を使用してデータにアクセスを試み、Adobe AIR で要求のステータスコードを検出して返すことができる場合に送出されます。	AVURLLoader
httpStatus	URLLoader.load() が HTTP 経由でデータにアクセスしようとすると送出されます。	AVURLLoader
ioError	URLLoader.load() の呼び出し時に致命的なエラーが発生してダウンロードが終了した場合に送出されます。	AVURLLoader
open	URLLoader.load() メソッドの呼び出しによりダウンロード処理が開始されると送出されます。	AVURLLoader
progress	ダウンロード処理を実行中にデータを受信したときに送出されます。	AVURLLoader
securityError	URLLoader.load() の呼び出しによってセキュリティサンドボックスの外部にあるサーバーからデータを読み込もうとすると送出されます。	AVURLLoader

プロパティの詳細

cookieHeader

プロパティ

cookieHeader:String [書き込み専用]

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

コンストラクターの詳細

()

コンストラクター

public function AVURLLoader(request:URLRequest = null)

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

URLLoader オブジェクトを作成します。

パラメーター

request:URLRequest (default = null) — ダウンロードする URL を指定する URLRequest オブジェクトです。このパラメーターを省略すると、ロード操作は開始されません。指定すると、直ちにロード操作が開始されます。詳細については、load を参照してください。

関連する API エレメント

URLLoader.load()

メソッドの詳細

addEventListener

()

メソッド

override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void

パラメーター

	`type:String`

	`listener:Function`

	`useCapture:Boolean` (default = `false`)

	`priority:int` (default = `0`)

	`useWeakReference:Boolean` (default = `false`)

close

()

メソッド

override public function close():void

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

進行中のロード操作は直ちに終了します。進行中のロード操作は直ちに終了します。URL が現在ストリーミングされていない場合、無効なストリームエラーがスローされます。

load

()

メソッド

override public function load(request:URLRequest):void

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

指定された URL からデータを送信およびロードします。dataFormat プロパティに設定した値に基づき、テキスト、生のバイナリデータ、または URL エンコードされた変数としてデータを受け取ることができます。dataFormat プロパティのデフォルト値はテキストです。データを指定された URL に送信する場合は、URLRequest オブジェクトの data プロパティを設定できます。

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

ローカルファイルシステムのサンドボックスの SWF ファイルは、ネットワーク上のサンドボックス内のリソースからデータを読み込んだり、リソースにデータを書き込んだりしないことがあります。

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

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

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

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

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

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

パラメーター

request:URLRequest — ダウンロードする URL を指定する URLRequest オブジェクトです。

イベント

	`complete:Event` — データが正常にロードされた後に送出されます。

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

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

	`progress:ProgressEvent` — ダウンロード処理を実行中にデータを受信したときに送出されます。

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

	`securityError:SecurityErrorEvent` — ロード操作で SWZ ファイル（Adobe プラットフォームコンポーネント）を読み込もうとしましたが、証明書が無効であるか、ダイジェストがコンポーネントと一致しません。

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

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

例外

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

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

	`SecurityError` — 信頼されていないローカルファイルはインターネットへの接続を許可されません。この問題は、このファイルを local-with-networking または trusted として分類し直すことで回避できます。

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

	`TypeError` — 要求パラメーターの値、または渡された URLRequest オブジェクトの `URLRequest.url` プロパティの値は `null` です。

関連する API エレメント

URLRequestHeader
URLRequest.requestHeaders
URLRequest.data
URLRequest.digest

イベントの詳細

complete

イベント

イベントオブジェクトの型: flash.events.Event
プロパティ Event.type = flash.events.Event.COMPLETE

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

受信したすべてのデータがデコードされ、URLLoader オブジェクトの data プロパティに配置された後に送出されます。このイベントが送出されると、受信したデータにアクセスできます。

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

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

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`target`	読み込みが完了したネットワークオブジェクトです。

関連する API エレメント

URLLoader.load()

httpResponseStatus

イベント

イベントオブジェクトの型: flash.events.HTTPStatusEvent
プロパティ HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, AIR 1.0, Flash Lite 4

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

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

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

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

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`responseURL`	応答の返送元の URL です。
`responseHeaders`	返された応答ヘッダー（URLRequestHeader オブジェクトの配列）です。
`status`	サーバーから返された HTTP ステータスコードです。
`redirected`	応答にリダイレクトの結果があるかどうか。
`target`	HTTP ステータスコードを受け取るネットワークオブジェクトです。

関連する API エレメント

load()

httpStatus

イベント

イベントオブジェクトの型: flash.events.HTTPStatusEvent
プロパティ HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_STATUS

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

URLLoader.load() が HTTP 経由でデータにアクセスしようとすると送出されます。Flash Player で実行されているコンテンツでは、このイベントは、現在の Flash Player 環境が要求のステータスコードを検出して返すことができる場合にのみ送出されます（一部のブラウザー環境ではこの情報を提供できません）。httpStatus イベントが送出される場合、このイベントは、complete イベントまたは error イベントの前に、これらのイベントとは別に送信されます。

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

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

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`status`	サーバーから返された HTTP ステータスコードです。
`target`	HTTP ステータスコードを受け取るネットワークオブジェクトです。

関連する API エレメント

URLLoader.load()

ioError

イベント

イベントオブジェクトの型: flash.events.IOErrorEvent
プロパティ IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

URLLoader.load() の呼び出し時に致命的なエラーが発生してダウンロードが終了した場合に送出されます。

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

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

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`errorID`	特定のエラーに関連付けられた参照番号です（AIR のみ）。
`target`	入出力エラーが発生したネットワークオブジェクトです。
`text`	エラーメッセージとして表示されるテキストです。

関連する API エレメント

URLLoader.load()

open

イベント

イベントオブジェクトの型: flash.events.Event
プロパティ Event.type = flash.events.Event.OPEN

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

URLLoader.load() メソッドの呼び出しによりダウンロード処理が開始されると送出されます。

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

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

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`target`	接続をオープンしたネットワークオブジェクトです。

関連する API エレメント

URLLoader.load()

progress

イベント

イベントオブジェクトの型: flash.events.ProgressEvent
プロパティ ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

ダウンロード処理を実行中にデータを受信したときに送出されます。

URLLoader オブジェクトでは、完全にデータが受信されるまではデータにアクセスできません。このため、progress イベントの通知でしかダウンロードの進行状況を確認できません。完全にダウンロードされる前にデータにアクセスするには、AVURLStream オブジェクトを使用します。

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

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

プロパティ	値
`bubbles`	`false`
`bytesLoaded`	リスナーがイベントを処理しているときに読み込まれたアイテム数またはバイト数です。
`bytesTotal`	読み込みプロセスが成功した場合に最終的に読み込まれるアイテムまたはバイトの総数です。
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`target`	進行状況をレポートするオブジェクトです。

関連する API エレメント

URLLoader.load()

securityError

イベント

イベントオブジェクトの型: flash.events.SecurityErrorEvent
プロパティ SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

URLLoader.load() の呼び出しによってセキュリティサンドボックスの外部にあるサーバーからデータを読み込もうとすると送出されます。また、URLLoader.load() の呼び出しによって SWZ ファイルをロードしようとした場合に、証明書が無効であるか、ダイジェストのストリングがコンポーネントと一致しないときに送出されます。

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

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

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`target`	セキュリティエラーを報告するネットワークオブジェクトです。
`text`	エラーメッセージとして表示されるテキストです。

関連する API エレメント

URLLoader.load()

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

AVURLLoader - AS3

パッケージx

言語エレメント

付録

パッケージ flash.media

cookieHeader

AVURLLoader

addEventListener

close

load

complete

httpResponseStatus

httpStatus

ioError

open

progress

securityError