シンタックス
loadVariablesNum(url, レベル [, 変数]);

引数
url   変数が置かれている絶対または相対URL。ムービーにWebブラウザでアクセスするとき、URLのホストはムービー自身と同じサブドメインになければなりません。

レベル   Flash Playerで変数を受取るレベルを指定する整数。

変数   省略可能な引数で、変数を送信するHTTPメソッドを指定します。この引数は、ストリングの"GET"または"POST"でなければなりません。送信する変数がなければ、この引数を省略します。GETメソッドは、変数をURLの最後に追加します。これは、変数の数が少ないときに使用します。POSTメソッドは、別途のHTTP ヘッダで変数を送信します。これは、長いストリングの変数に使用されます。

説明
アクション; 外部ファイルからデータを読込みます。データは、テキストファイルのほか、CGIスクリプトやアクティブサーバーページ(ASP)、PHP、Perlスクリプトで生成されたテキストなどです。読込まれた値は、Flash Playerのレベルに変数として設定されます。このアクションを使って、現行ムービーの変数を新たな値に更新することもできます。

変数をレベルにロードするとき、このアクションはアクションパネルのノーマルモードでは'loadVariablesNum'になります。エキスパートモードでは、'loadVariablesNum'を指定するか、ツールボックスリストから選択する必要があります。

指定されたURLのテキストは、標準MIME形式のapplication/x-www-urlformencoded(CGIスクリプトで使用される標準形式)にする必要があります。ムービーとロードする変数とは、同じサブドメインになければなりません。変数は、いくつでも指定できます。たとえば、以下の記述は、複数の変数を定義しています。

company=Macromedia&address=600+Townsend&city=San+Francisco&zip=94103

Flash Playerのインスタンスで最初に開くムービーは、最下層(スクリプトでは'_level0'と指定)にロードされます。'loadMovie'または'loadMovieNum'アクションを使ってつぎのムービーをロードするとき、Flash Playerのレベル番号またはムービーをロードするターゲットとなるムービークリップを指定する必要があります。'loadVariableNum'アクションを使うときは、変数をロードするFlash Playerのレベルを指定しなければなりません。

[訳者註] 複数の変数を定義したテキストの記述で、アンパサンド(&)は複数の変数の区切り文字となります。また、値の中のプラス記号(+)は、半角スペースとして読込まれます(オンラインヘルプ「Web アプリケーションと Flash の統合」の「リモートファイルとの間の変数の送信とロード」の項で「loadVariables、getURL、loadMovie の使用」を併せてご参照ください)。

Player
Flash 4以降。Flash 4ファイルをFlash 5で開くと、正しいシンタックスを使うように変換されます。

例
以下のサンプルは、テキストファイルからデータをロードし、メインタイムラインのムービーのレベル0にあるテキストフィールドに設定します。テキストフィールドの変数名は、data.txtファイルの変数名と一致しなければなりません。

on(release) {
   loadVariablesNum ("data.txt", 0);
}

関連項目
loadVariables   loadMovie   loadMovieNum   getURL   MovieClip.loadMovie   MovieClip.loadVariables

出典
ActionScript Dictionary(ActionScript辞書英文改訂版)より邦訳。