Flash CS3 ドキュメンテーション

ActionScript 3.0 のプログラミング > Flash Player セキュリティ > ネットワーク API の制限

ネットワーク API の制限

SWF ファイルのネットワーク機能へのアクセスは、SWF コンテンツを収めた HTML ページの <object> タグと <embed> タグに allowNetworking パラメータを設定して制御します。

allowNetworking に指定できる値は次のとおりです。

• "all" (デフォルト) - すべてのネットワーク API が SWF で許可されます。
• "internal" - SWF ファイルは、このセクションの後半に示すブラウザナビゲーションまたはブラウザインタラクション API を呼び出すことはできませんが、その他のネットワーク API を呼び出すことができます。
• "none" - SWF ファイルは、このセクションの後半に示すブラウザナビゲーションまたはブラウザインタラクション API を呼び出すことはできません。また、後半に示す SWF 間の通信 API を使用できません。

禁止された API を呼び出すと、SecurityError 例外がスローされます。

allowNetworking パラメータを設定するには、SWF ファイルの参照を含む HTML ページの <object> タグと <embed> タグで、次の例に示すように allowNetworking パラメータを追加し、その値を設定します。

<object classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000"
 codebase="http://fpdownload.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,18,0" 
 width="600" height="400" id="test" align="middle">
<param name="allowNetworking" value="none" />
<param name="movie" value="test.swf" />
<param name="bgcolor" value="#333333" />
<embed src="test.swf" allowNetworking="none" bgcolor="#333333" 
    width="600" height="400"  
    name="test" align="middle" type="application/x-shockwave-flash"   
    pluginspage="http://www.macromedia.com/go/getflashplayer" />
</object>

HTML ページは、スクリプトを使用して SWF 埋め込みタグを生成することもできます。allowNetworking 設定が正しく挿入されるように、スクリプトを変更する必要があります。Flash および Adobe Flex Builder で生成された HTML ページは、AC_FL_RunContent() 関数を使用して SWF ファイルの参照を埋め込むため、次のようにスクリプトに allowNetworking パラメータ設定を追加する必要があります。

AC_FL_RunContent( ... "allowNetworking", "none", ...)

次の API は allowNetworking が "internal" に設定されている場合は禁止されます。

• navigateToURL()
• fscommand()
• ExternalInterface.call()

前記のリストの API 以外に、次の API も allowNetworking が "none" に設定されている場合は禁止されます。

• sendToURL()
• FileReference.download()
• FileReference.upload()
• Loader.load()
• LocalConnection.connect()
• LocalConnection.send()
• NetConnection.connect()
• NetStream.play()
• Security.loadPolicyFile()
• SharedObject.getLocal()
• SharedObject.getRemote()
• Socket.connect()
• Sound.load()
• URLLoader.load()
• URLStream.load()
• XMLSocket.connect()

選択された allowNetworking の設定により SWF ファイルがネットワーク API を使用できる場合でも、この章で示すセキュリティサンドボックスの制限により他の制限が課せられる場合があります。

allowNetworking が "none" に設定されている場合、TextField オブジェクトの htmlText プロパティの <img> タグで外部メディアを参照できません (SecurityError 例外がスローされます)。

allowNetworking を "none" に設定すると、ActionScript ではなく Flash オーサリングツールで追加された、インポート済み共有ライブラリのシンボルは、実行時にブロックされます。

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flash/9.0_jp/main/00000351.html

コメントの追加