Lavora con noi

JavaScript

Siti tematici

Speciali

Ajax

JavaScript » Articoli » Effetti e controlli Javascript

Pagine:

RSS

Embed di filmati Flash con Flashembed

di: Filippo Buratti 12 Ottobre 2009

Possibilità di configurazione

Nell'esempio precedente abbiamo chiamato la funzione flashembed() utilizzando due soli parametri (l'identificativo del container e l'url del file swf), nella maniera più semplice. In realtà la funzione accetta tre argomenti, di cui solo i primi due sono obbligatori:

container (come abbiamo detto l'id dell'elemento contenitore presente nel documento HTML in cui lo script inserisce l'oggetto Flash);
configuration, che specifica il percorso del file swf e facoltativamente le varie modalità di inclusione. In questo ultimo caso configuration è un oggetto hash di opzioni, alcune specifiche di Flashembed, altre della configurazione Flash (i classici tag param);
flashvars è l'argomento facoltativo che permette di passare un hash di variabili, anche in formato JSON, dalla pagina al filmato (non sono altro che le classiche flashvars di Flash).

flashembed(container, configuration, flashvars);

Possiamo vedere nel secondo esempio l'utilizzo di parametri personalizzati per gli argomenti configuration e flashvars: in particolare, abbiamo settato la trasparenza del filmato, disabilitato il menu del tasto destro e inviato una variabile che può essere letta e stampata sullo stage da Flash (naturalmente, per quanto riguarda la creazione di un swf capace di interagire con dati esterni, sono necessarie delle nozioni di base di Actionscript). Di seguito il codice HTML e Javascript necessario:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>flashembed - Esempio 2 - Parametri di configurazione e Flashvars</title>
<script type="text/javascript" src="js/flashembed-1.0.4.js"></script>
<style type="text/css">
body { text-align:center; }
#clock { width:300px; height:300px; margin:0 auto; }
</style>
</head>
<body>
<h1>Parametri di configurazione e Flashvars</h1>
<div id="clock"></div>
<script>
flashembed(
	"clock", 
	// configuration
	{src: "swf/clock_flashvars.swf", wmode: 'transparent', menu: 'false'}, 
	// flashvars
	{ my_param: 'Hello world!' }
);
</script>
</body>
</html>

Ecco una panoramica sulle varie opzioni del secondo argomento configuration, quando questo viene utilizzato come un oggetto:

src: l'unica opzione obbligatoria, contenente il percorso del file swf;
version: permette di specificare la versione minima richiesta di Flash Player necessaria per visualizzare il filmato. In caso non sia installata sul computer client la versione necessaria, viene visualizzato un messaggio di default, customizzabile attraverso i CSS. È anche possibile cambiare il messaggio inserendo un contenuto personalizzato (in formato HTML) direttamente nel container. Ecco un esempio standard in cui viene richiesto un numero di versione molto elevato (20,0) in modo da poter vedere cosa accade quando non si dispone del player installato;
width: è preferibile non usare questa opzione impostando direttamente le dimensioni del filmato nei CSS;
height: come sopra;
expressInstall (richiede la presenza della precedente opzione version): contiene il percorso del file expressinstall.swf. Nel caso in cui il client non disponga della versione Flash richiesta, viene direttamente mostrato l'alert box che consente l'aggiornamento rapido del player (esempio);
onFail: permette di specificare una funzione di callback invocata nel caso il plugin Flash sia mancante o sia di una versione troppo vecchia (richiede la presenza dell'opzione version);
cachebusting (valore di default false): abilitando questa proprietà viene forzato il caricamento dell'swf dalla cache del browser;
le rimanenti opzioni che è possibile specificare sono alcune di quelle tipiche di Flash: bgcolor, wmode, menu, allowfullscreen (valore di default true), allowscriptaccess (valore di default always), quality (valore di default high).