Naast het bestand badge.swf in de SDK kunt u ook zelf een SWF-bestand voor gebruik in een browserpagina maken. Uw aangepaste SWF-bestand kan op de volgende manieren interageren met de runtime:

• Een AIR-toepassing installeren. Zie AIR-toepassingen installeren vanuit de browser.

• Controleren of een bepaalde AIR-toepassing is geïnstalleerd. Zie Vanuit een webpagina controleren of een AIR-toepassing is geïnstalleerd.

• Controleren of de runtime is geïnstalleerd. Zie Controleren of de runtime is geïnstalleerd.

• Een geïnstalleerde AIR-toepassing op het systeem van de gebruiker starten. Zie Geïnstalleerde AIR-toepassingen starten vanuit de browser.

Deze functies worden mogelijk gemaakt door het oproepen van API's in een SWF-bestand op adobe.com: air.swf. In deze sectie wordt beschreven hoe u het bestand badge.swf gebruikt en aanpast en hoe u de API's van air.swf oproept vanuit uw eigen SWF-bestand.

Een SWF-bestand dat in de browser wordt uitgevoerd, kan ook met een gestarte AIR-toepassing communiceren met behulp van de klasse LocalConnection. Zie Communicatie tussen toepassingen voor meer informatie.

In de SDK van AIR is het bestand badge.swf opgenomen waarmee u de functie voor naadloze installatie eenvoudig kunt gebruiken. Met badge.swf kunt u de runtime en een AIR-toepassing installeren via een koppeling op een webpagina. Het bestand badge.swf en de broncode worden geleverd voor distributie op uw website.

In de instructies in deze sectie vindt u informatie over het instellen van parameters voor het bestand badge.swf van Adobe. U kunt ook beschikken over de broncode van het bestand badge.swf en deze aanpassen.

U kunt zelf een SWF-bestand maken waarin u de API's van het bestand air.swf gebruikt voor de interactie met de runtime en AIR-toepassingen vanuit een webpagina in een browser. Het bestand air.swf bevindt zich op http://airdownload.adobe.com/air/browserapi/air.swf. Als u vanuit uw SWF-bestand wilt verwijzen naar de API's van air.swf, laadt u het bestand air.swf in hetzelfde toepassingsdomein als uw SWF-bestand. In het volgende voorbeeld ziet u code voor het laden van het bestand air.swf in het toepassingsdomein van het SWF-bestand:

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

Nadat het bestand air.swf is geladen (wanneer het contentLoaderInfo-object van het Loader-object de init-gebeurtenis verzendt), kunt u elke API van air.swf oproepen. Deze API's worden in de volgende secties beschreven:

• Controleren of de runtime is geïnstalleerd

• Vanuit een webpagina controleren of een AIR-toepassing is geïnstalleerd

• AIR-toepassingen installeren vanuit de browser

• Geïnstalleerde AIR-toepassingen starten vanuit de browser

Een SWF-bestand kan controleren of de runtime is geïnstalleerd door de methode getStatus() op te roepen in het bestand air.swf dat is geladen vanaf http://airdownload.adobe.com/air/browserapi/air.swf. Zie Het bestand air.swf laden voor meer informatie.

Nadat het bestand air.swf is geladen, kunt u vanuit het SWF-bestand de methode getStatus() van het bestand air.swf als volgt oproepen:

var status:String = airSWF.getStatus();

De methode getStatus() retourneert een van de volgende tekenreekswaarden, afhankelijk van de status van de runtime op de computer:

De methode getStatus() meldt een fout als de vereiste versie van Flash Player (versie 9 upgrade 3 op Windows en Mac OS, of versie 10 op Linux) niet in de browser is geïnstalleerd.

Een SWF-bestand kan controleren of een AIR-toepassing (met een overeenkomstige toepassings-id en uitgevers-id) is geïnstalleerd door de methode getApplicationVersion() op te roepen in het bestand air.swf dat is geladen vanaf http://airdownload.adobe.com/air/browserapi/air.swf. Zie Het bestand air.swf laden voor meer informatie.

Nadat het bestand air.swf is geladen, kunt u vanuit het SWF-bestand de methode getApplicationVersion() van het bestand air.swf als volgt oproepen:

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

De methode getApplicationVersion() heeft de volgende parameters:

De methode getApplicationVersion() meldt een fout als de vereiste versie van Flash Player (versie 9 upgrade 3 op Windows en Mac OS, of versie 10 op Linux) niet in de browser is geïnstalleerd.

Een SWF-bestand kan een AIR-toepassing installeren door de methode installApplication() op te roepen in het bestand air.swf dat is geladen vanaf http://airdownload.adobe.com/air/browserapi/air.swf. Zie Het bestand air.swf laden voor meer informatie.

Nadat het bestand air.swf is geladen, kunt u vanuit het SWF-bestand de methode installApplication() van het bestand air.swf als volgt oproepen:

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

Met de methode installApplication() wordt de opgegeven toepassing geïnstalleerd op de computer van de gebruiker. Deze methode heeft de volgende parameters:

De methode installApplication() werkt alleen wanneer deze wordt opgeroepen in de gebeurtenishandler voor een gebruikersgebeurtenis, zoals een muisklik.

De methode installApplication() meldt een fout als de vereiste versie van Flash Player (versie 9 upgrade 3 op Windows en Mac OS, of versie 10 op Linux) niet in de browser is geïnstalleerd.

Als een gebruiker in Mac OS een recentere versie van een toepassing wil installeren, moet de gebruiker over voldoende toegangsrechten beschikken om te installeren in de toepassingsmap (en over beheerdersrechten als de toepassing de runtime bijwerkt). In Windows moet de gebruiker over beheerdersrechten beschikken.

U kunt ook de methode getApplicationVersion() van het bestand air.swf oproepen om te controleren of een toepassing al is geïnstalleerd. U kunt deze methode oproepen voordat het installatieproces van de toepassing begint of nadat de installatie is gestart. Zie Vanuit een webpagina controleren of een AIR-toepassing is geïnstalleerd voor meer informatie. Wanneer de toepassing is gestart, kan deze met de SWF-inhoud in de browser communiceren via de klasse LocalConnection. Zie Communicatie tussen toepassingen voor meer informatie.

Als u de browseroproepfunctie wilt gebruiken (zodat een toepassing kan worden gestart vanuit de browser), moet in het descriptorbestand van de doeltoepassing de volgende instelling zijn opgenomen:

<allowBrowserInvocation>true</allowBrowserInvocation>

Zie Eigenschappen van AIR-toepassingen instellen voor meer informatie over het descriptorbestand van de toepassing.

Een SWF-bestand in de browser kan een AIR-toepassing starten door de methode launchApplication() op te roepen in het bestand air.swf dat is geladen vanaf http://airdownload.adobe.com/air/browserapi/air.swf. Zie Het bestand air.swf laden voor meer informatie.

Nadat het bestand air.swf is geladen, kunt u vanuit het SWF-bestand de methode launchApplication() van het bestand air.swf als volgt oproepen:

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

De methode launchApplication() is gedefinieerd op het hoogste niveau van het bestand air.swf (dat is geladen in het toepassingsdomein van het SWF-bestand van de gebruikersinterface). Als u deze methode oproept, wordt de opgegeven toepassing gestart (als deze is geïnstalleerd en oproepen via de browser is toegestaan via de instelling van allowBrowserInvocation in het descriptorbestand van de toepassing). De methode heeft de volgende parameters:

De methode launchApplication() werkt alleen wanneer deze wordt opgeroepen in de gebeurtenishandler voor een gebruikersgebeurtenis, zoals een muisklik.

De methode launchApplication() meldt een fout als de vereiste versie van Flash Player (versie 9 upgrade 3 op Windows en Mac OS, of versie 10 op Linux) niet in de browser is geïnstalleerd.

Als het element allowBrowserInvocation op false is ingesteld in het descriptorbestand van de toepassing, heeft het oproepen van de methode launchApplication() geen effect.

Voordat u de gebruikersinterface weergeeft om de toepassing te starten, kunt u het best de methode getApplicationVersion() in het bestand air.swf oproepen. Zie Vanuit een webpagina controleren of een AIR-toepassing is geïnstalleerd voor meer informatie.

Wanneer de toepassing wordt opgeroepen via de browseroproepfunctie, verzendt het NativeApplication-object van de toepassing een BrowserInvokeEvent-object. Zie Oproepen vanuit browser voor meer informatie.

Als u de browseroproepfunctie gebruikt, moet u rekening houden met de gevolgen voor de beveiliging die in Oproepen vanuit browser worden beschreven.

Wanneer de toepassing is gestart, kan deze met de SWF-inhoud in de browser communiceren via de klasse LocalConnection. Zie Communicatie tussen toepassingen voor meer informatie.