AIR.SWF API interne browser

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. U kunt het bestand badge.swf aanpassen, zodat u de air.swf-API's kunt oproepen 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 Verbinding maken met andere instanties van Flash Player en AIR (voor ActionScript-ontwikkelaars) of Verbinding maken met andere instanties van Flash Player en AIR (voor HTML-ontwikkelaars) voor meer informatie.

In de SDK van AIR en de SDK van Flex 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.

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, zoals hieronder wordt beschreven.

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 Verbinding maken met andere instanties van Flash Player en AIR (voor ActionScript-ontwikkelaars) of Communicating with other Flash Player and AIR instances (voor HTML-ontwikkelaars) 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 AIR-toepassingsdescriptorbestanden 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 AIR-toepassingen aanroepen vanuit de browser (voor ActionScript-ontwikkelaars) of Invoking an AIR application from the browser (voor HTML-ontwikkelaars) voor meer informatie.

Als u de browseroproepfunctie gebruikt, moet u rekening houden met de gevolgen voor de beveiliging. Deze gevolgen worden beschreven in AIR-toepassingen aanroepen vanuit de browser (voor ActionScript-ontwikkelaars) en Invoking an AIR application from the browser (voor HTML-ontwikkelaars).

Wanneer de toepassing is gestart, kan deze met de SWF-inhoud in de browser communiceren via de klasse LocalConnection. Zie Verbinding maken met andere instanties van Flash Player en AIR (voor ActionScript-ontwikkelaars) of Communicating with other Flash Player and AIR instances (voor HTML-ontwikkelaars) voor meer informatie.