Documentazione di Flash CS3

Programmazione in ActionScript 3.0 > Sicurezza di Flash Player > Limitazioni delle API di connettività di rete

Limitazioni delle API di connettività di rete

È possibile controllare l'accesso di un file SWF alle funzionalità di rete impostando il parametro allowNetworking dei tag <object> e <embed> nella pagina HTML in cui si trova il contenuto SWF.

I valori possibili di allowNetworking sono:

• "all" (predefinito) -- Tutte le API di connettività sono ammesse nel file SWF.
• "internal" -- Il file SWF non può chiamare le API di navigazione o interazione del browser, elencate più avanti in questa sezione, ma può chiamare qualunque altra API di connettività di rete.
• "none" -- Il file SWF non può chiamare le API di navigazione o interazione del browser, elencate più avanti in questa sezione, e non può utilizzare API di comunicazione tra file SWF, anch'esse descritte più avanti.

La chiamata di un'API non consentita provoca un'eccezione SecurityError.

Per impostare il parametro allowNetworking, aggiungere, nei tag <object> e <embed> della pagina HTML che include un riferimento al file SWF, il parametro allowNetworking e impostarne il valore, come nell'esempio seguente:

<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>

Una pagina HTML può anche usare uno script per generare tag di incorporamento SWF. È necessario modificare lo script in modo da inserire le impostazioni allowNetworking corrette. Le pagine HTML generate da Flash e Adobe Flex Builder impiegano la funzione AC_FL_RunContent() per incorporare riferimenti a file SWF; l'utente deve aggiungere le impostazioni del parametro allowNetworking come indicato di seguito:

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

Le seguenti API sono disabilitate quando allowNetworking è impostato su "internal":

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

Oltre alle API elencate sopra, le seguenti API sono disabilitate quando allowNetworking è impostato su "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()

Anche se l'impostazione allowNetworking selezionata consente a un file SWF di utilizzare un'API di connettività di rete, potrebbero essere attive altre restrizioni dovute ai limiti della sicurezza sandbox, come descritto in questo capitolo.

Se allowNetworking è impostato su "none", non è possibile fare riferimento a file multimediali esterni in un tag <img> nella proprietà htmlText di un oggetto TextField (viene generata un'eccezione SecurityError).

Se allowNetworking è impostato su "none", un simbolo appartenente a una libreria condivisa importata inserito nello strumento di creazione di Flash (non in ActionScript) viene disabilitato in fase di runtime.

Flash CS3

Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/main/00000351.html

Aggiungi commento