API interna al browser AIR.SWF

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. Vedete Installazione di un'applicazione AIR dal browser .

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

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

• Avviando un'applicazione AIR installata sul sistema dell'utente. Vedete 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. Potete personalizzare il file badge.swf e chiamare le API air.swf dal vostro file SWF.

Inoltre, un file SWF in esecuzione nel browser può comunicare con un'applicazione AIR in esecuzione mediante la classe LocalConnection. Per ulteriori informazioni, vedete Comunicazione con altre istanze di Flash Player e Adobe AIR (sviluppatori ActionScript) o Communicating with other Flash Player and AIR instances (sviluppatori HTML).

In AIR SDK e Flex SDK è incluso 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.

È 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 ), potete chiamare le API di air.swf, descritte nelle sezioni che seguono.

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 informazioni dettagliate, vedete 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 aggiornamento 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 informazioni dettagliate, vedete 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 getApplicationVersion() presenta i seguenti parametri:

Il metodo getApplicationVersion() genera un errore se la versione richiesta di Flash Player (versione 9 aggiornamento 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 informazioni dettagliate, vedete 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 aggiornamento 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 informazioni dettagliate, vedete 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 ulteriori informazioni, vedete Comunicazione con altre istanze di Flash Player e Adobe AIR (sviluppatori ActionScript) o Communicating with other Flash Player and AIR instances (sviluppatori HTML).

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, vedete File descrittori delle applicazioni 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 informazioni dettagliate, vedete 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 aggiornamento 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 informazioni dettagliate, vedete 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 ulteriori informazioni, vedete Chiamata di un'applicazione AIR dal browser (sviluppatori ActionScript) o Invoking an AIR application from the browser (sviluppatori HTML).

Se utilizzate la funzionalità di chiamata browser, tenete presenti le implicazioni di sicurezza descritte in Chiamata di un'applicazione AIR dal browser (sviluppatori ActionScript) e Invoking an AIR application from the browser (sviluppatori HTML).

Quando l'applicazione è stata posta in esecuzione è in grado di comunicare con il contenuto SWF del browser mediante la classe LocalConnection. Per ulteriori informazioni, vedete Comunicazione con altre istanze di Flash Player e Adobe AIR (sviluppatori ActionScript) o Communicating with other Flash Player and AIR instances (sviluppatori HTML).