Documentazione di Flash CS3

Programmazione in ActionScript 3.0 > Uso dell'API esterna > Requisiti e vantaggi dell'API esterna

Requisiti e vantaggi dell'API esterna

L'API esterna è una porzione di ActionScript che fornisce un meccanismo di comunicazione tra ActionScript e il codice in esecuzione su un'applicazione cosiddetta "esterna", ovvero un'applicazione che funge da contenitore per Flash Player (di solito, si tratta di un browser Web o di un'applicazione proiettore autonoma). In ActionScript 3.0, la funzionalità dell'API esterna è fornita dalla classe ExternalInterface. Nelle versioni di Flash Player precedenti a Flash Player 8, l'azione fscommand() veniva utilizzata per effettuare la comunicazione con l'applicazione contenitore. La classe ExternalInterface sostituisce fscommand() ed è consigliabile utilizzarla per tutte le comunicazioni tra JavaScript e ActionScript.

NOTA

Se è necessario utilizzare ancora fscommand() (ad esempio, per mantenere la compatibilità con applicazioni precedenti o per interagire con un'applicazione contenitore di terze parti o con la versione autonoma di Flash Player), la funzione è ancora disponibile come funzione a livello di pacchetto nel pacchetto flash.system.

La classe ExternalInterface è un sottosistema che consente facili comunicazioni da ActionScript e Flash Player a una pagina HTML contenente JavaScript o a un'applicazione desktop che incorpora un'istanza di Flash Player.

La classe ExternalInterface è disponibile solo nelle seguenti circostanze:

In tutte le versioni supportate di Internet Explorer per Windows (5.0 e versioni successive)
In un'applicazione contenitore, come un'applicazione desktop, che utilizza un'istanza del controllo ActiveX di Flash Player
In tutti i browser che supportano l'interfaccia NPRuntime che comprende attualmente i seguenti browser:
- Firefox 1.0 e versioni successive
- Mozilla 1.7.5 e versioni successive
- Netscape 8.0 e versioni successive
- Safari 1.3 e versioni successive

In tutte le altre situazioni (ad esempio, nel caso di esecuzione in un lettore autonomo) in cui la proprietà ExternalInterface.available restituisce false.

Da ActionScript, è possibile chiamare una funzione JavaScript sulla pagina HTML. L'API esterna offre la seguente funzionalità perfezionata rispetto a fscommand():

È possibile utilizzare qualsiasi funzione JavaScript, non solo le funzioni utilizzabili con fscommand().
È possibile passare un numero qualsiasi di argomenti, con tutti i nomi; non ci sono limitazioni al passaggio di un comando e di un unico argomento String. In questo modo, l'API esterna risulta molto più flessibile rispetto a fscommand().
È possibile passare diversi tipi di dati (come Boolean, Number e String); non vi sono più limitazioni per i parametri String.
È possibile ricevere il valore di una chiamata e restituire immediatamente tale valore ad ActionScript (come valore restituito della chiamata eseguita).

AVVERTENZA

Se il nome fornito all'istanza di Flash Player in una pagina HTML (l'attributo id del tag object) include un trattino (-) o altri caratteri che sono definiti come operatori in JavaScript (ad esempio, +, *, /, \, . e così via), le chiamate a ExternalInterface da ActionScript non funzionano quando la pagina Web contenitore viene visualizzata in Internet Explorer.

Inoltre, se i tag HTML che definiscono l'istanza di Flash Player (i tag object ed embed) sono nidificati in un tag form HTML, le chiamate ExternalInterface da ActionScript non funzionano.

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/00000339.html