Oltre a utilizzare il file badge.swf fornito con SDK, è possibile creare un file SWF personalizzato da utilizzare in una pagina browser. Tale file personalizzato può interagire con il runtime nei modi seguenti:

• Installando un'applicazione AIR. Consultate Installazione di un'applicazione AIR dal browser.

• Verificando se una determinata applicazione AIR è installata. Consultate Verificare da una pagina Web se un'applicazione AIR è installata.

• Verificando se il runtime è installato. Consultate Verificare se il runtime è installato.

• Avviando un'applicazione AIR installata sul sistema dell'utente. Consultate Avvio dal browser di un'applicazione AIR installata.

Queste funzionalità vengono tutte fornite chiamando le API in un file SWF ospitato su adobe.com: air.swf. In questa sezione viene descritto come utilizzare e personalizzare il file badge.swf, nonché come chiamare le API del file air.swf dal file SWF personalizzato.

Inoltre, un file SWF in esecuzione nel browser può comunicare con un'applicazione AIR in esecuzione mediante la classe LocalConnection. Per ulteriori informazioni, consultate Comunicazione tra le applicazioni.

AIR SDK include un file badge.swf che consente di utilizzare facilmente la funzionalità di installazione invisibile. Tale file consente di installare il runtime e un'applicazione AIR da un collegamento in una pagina Web. Il file badge.swf file e il relativo codice sorgente vengono forniti per la distribuzione sul vostro sito Web.

Le istruzioni incluse in questa sezione forniscono informazioni sull'impostazione dei parametri del file badge.swf fornito da Adobe. Viene inoltre fornito il codice sorgente per il file badge.swf, che l'utente può personalizzare.

È possibile creare un file SWF personalizzato che utilizza le API nel file air.swf per interagire con il runtime e le applicazioni AIR da una pagina Web in un browser. Il file air.swf è ospitato in http://airdownload.adobe.com/air/browserapi/air.swf. Per fare riferimento alle API di air.swf API dal file SWF personalizzato, caricate air.swf nello stesso dominio dell'applicazione del file SWF. Nel codice seguente viene mostrato un esempio di caricamento del file air.swf nel dominio dell'applicazione del file SWF:

var airSWF:Object; // This is the reference to the main class of air.swf 
var airSWFLoader:Loader = new Loader(); // Used to load the SWF 
var loaderContext:LoaderContext = new LoaderContext();  
                                // Used to set the application domain  
 
loaderContext.applicationDomain = ApplicationDomain.currentDomain; 
 
airSWFLoader.contentLoaderInfo.addEventListener(Event.INIT, onInit); 
airSWFLoader.load(new URLRequest("http://airdownload.adobe.com/air/browserapi/air.swf"),  
                    loaderContext); 
 
function onInit(e:Event):void  
{ 
    airSWF = e.target.content; 
}

Dopo che il file air.swf è stato caricato, quando l'oggetto contentLoaderInfo dell'oggetto Loader invia l'evento init, è possibile chiamare le API di air.swf. Le API sono descritte nelle sezioni che seguono:

• Verificare se il runtime è installato

• Verificare da una pagina Web se un'applicazione AIR è installata

• Installazione di un'applicazione AIR dal browser

• Avvio dal browser di un'applicazione AIR installata

Un file SWF può verificare se il runtime è installato effettuando la chiamata al metodo getStatus() nel file air.swf caricato da http://airdownload.adobe.com/air/browserapi/air.swf. Per dettagli, consultate Caricamento del file air.swf.

Dopo che il file air.swf è stato caricato, il file SWF può effettuare la chiamata al metodo getStatus() del file air.swf, come nell'esempio seguente:

var status:String = airSWF.getStatus();

Il metodo getStatus() restituisce uno dei seguenti valori di stringa. in base allo stato del runtime sul computer:

Il metodo getStatus() genera un errore se la versione richiesta di Flash Player (versione 9 update 3 o successiva in Windows e Mac OS o versione 10 in Linux) non è installata nel browser.

Un file SWF può verificare se un'applicazione AIR (con un ID editore e un ID applicazione corrispondente) è installata effettuando una chiamata al metodo getApplicationVersion() nel file air.swf file caricato da http://airdownload.adobe.com/air/browserapi/air.swf. Per dettagli, consultate Caricamento del file air.swf.

Dopo che il file air.swf è stato caricato, il file SWF può effettuare la chiamata al metodo getApplicationVersion() del file air.swf, come nell'esempio seguente:

var appID:String = "com.example.air.myTestApplication"; 
var pubID:String = "02D88EEED35F84C264A183921344EEA353A629FD.1"; 
airSWF.getApplicationVersion(appID, pubID, versionDetectCallback); 
 
function versionDetectCallback(version:String):void 
{ 
    if (version == null) 
    { 
        trace("Not installed."); 
        // Take appropriate actions. For instance, present the user with 
        // an option to install the application. 
    } 
    else 
    { 
        trace("Version", version, "installed."); 
        // Take appropriate actions. For instance, enable the 
        // user interface to launch the application. 
    } 
}

Il metodo getApplicationVersiom() presenta i seguenti parametri:

Il metodo getApplicationVersion() genera un errore se la versione richiesta di Flash Player (versione 9 update 3 o successiva in Windows e Mac OS o versione 10 in Linux) non è installata nel browser.

Un file SWF può installare un'applicazione AIR effettuando una chiamata al metodo installApplication() nel file air.swf caricato da http://airdownload.adobe.com/air/browserapi/air.swf. Per dettagli, consultate Caricamento del file air.swf.

Dopo che il file air.swf è stato caricato, il file SWF può effettuare la chiamata al metodo installApplication() del file air.swf, come nel codice seguente:

var url:String = "http://www.example.com/myApplication.air"; 
var runtimeVersion:String = "1.0"; 
var arguments:Array = ["launchFromBrowser"]; // Optional 
airSWF.installApplication(url, runtimeVersion, arguments); 

Il metodo installApplication() installa l'applicazione specificata sul computer dell'utente. Il metodo dispone dei parametri seguenti:

Il metodo installApplication() può funzionare solo quando viene chiamato nel gestore di eventi per un evento utente (ad esempio, un clic del mouse).

Il metodo installApplication() genera un errore se la versione richiesta di Flash Player (versione 9 update 3 o successiva in Windows e Mac OS o versione 10 in Linux) non è installata nel browser.

In Mac OS, per installare una versione aggiornata di un'applicazione sono necessari privilegi di sistema adeguati per effettuare l'installazione nella directory delle applicazioni, nonché privilegi di amministratore se l'applicazione aggiorna il runtime. In Windows, sono richiesti privilegi di amministratore.

È anche possibile chiamare il metodo getApplicationVersion() del file air.swf per verificare se un'applicazione è già installata. La chiamata al metodo può essere effettuata prima del processo di installazione o dopo che tale processo è stato avviato. Per dettagli, consultate Verificare da una pagina Web se un'applicazione AIR è installata. Quando l'applicazione è stata posta in esecuzione è in grado di comunicare con il contenuto SWF del browser mediante la classe LocalConnection. Per dettagli, consultate Comunicazione tra le applicazioni.

Per utilizzare la funzionalità di chiamata browser, che consente l'avvio dal browser, il file descrittore dell'applicazione di destinazione deve includere la seguente impostazione:

<allowBrowserInvocation>true</allowBrowserInvocation>

Per ulteriori informazioni sul file descrittore dell'applicazione, consultate Impostazione delle proprietà dell'applicazione AIR.

Un file SWF può avviare un'applicazione AIR nel browser effettuando una chiamata al metodo launchApplication() nel file air.swf caricato da http://airdownload.adobe.com/air/browserapi/air.swf. Per dettagli, consultate Caricamento del file air.swf.

Dopo che il file air.swf è stato caricato, il file SWF può effettuare la chiamata al metodo launchApplication() del file air.swf, come nel codice seguente:

var appID:String = "com.example.air.myTestApplication"; 
var pubID:String = "02D88EEED35F84C264A183921344EEA353A629FD.1"; 
var arguments:Array = ["launchFromBrowser"]; // Optional 
airSWF.launchApplication(appID, pubID, arguments);

Il metodo launchApplication() è definito al primo livello del file air.swf, caricato nel dominio dell'applicazione del file SWF dell'interfaccia utente. La chiamata a questo metodo determina l'avvio dell'applicazione specificata (se è installata e se è consentita la chiamata browser tramite l'impostazione allowBrowserInvocation nel file descrittore dell'applicazione). Il metodo dispone dei parametri seguenti:

Il metodo launchApplication() può funzionare solo quando viene chiamato nel gestore di eventi per un evento utente (ad esempio, un clic del mouse).

Il metodo launchApplication() genera un errore se la versione richiesta di Flash Player (versione 9 update 3 o successiva in Windows e Mac OS o versione 10 in Linux) non è installata nel browser.

Se l'elemento allowBrowserInvocation è impostato su false nel file descrittore dell'applicazione, la chiamata al metodo launchApplication() non ha alcun effetto.

Prima di presentare l'interfaccia utente per l'avvio dell'applicazione, è possibile chiamare il metodo getApplicationVersion() nel file air.swf. Per dettagli, consultate Verificare da una pagina Web se un'applicazione AIR è installata.

Quando l'applicazione viene chiamata tramite la funzionalità di chiamata browser, l'oggetto NativeApplication dell'applicazione invia un oggetto BrowserInvokeEvent. Per informazioni dettagliate, consultate Chiamata del browser.

Se utilizzate la funzionalità di chiamata browser, valutate le implicazioni relative alla sicurezza, descritte in Chiamata del browser.

Quando l'applicazione è stata posta in esecuzione è in grado di comunicare con il contenuto SWF del browser mediante la classe LocalConnection. Per dettagli, consultate Comunicazione tra le applicazioni.