Webbläsar-API:er i AIR.SWF

Förutom att använda filen badge.swf som ingår i SDK kan du skapa en egen SWF-fil och använda den i en webbläsare. Den egna SWF-filen kan samverka med körningsversionen på följande sätt:

• Den kan installera ett AIR-program. Se Installera ett AIR-program från webbläsaren .

• Den kan kontrollera om ett visst AIR-program är installerat. Se Kontrollera från en webbsida om ett AIR-program är installerat .

• Den kan kontrollera om körningsversionen är installerad. Se Kontrollera om körningsversionen är installerad .

• Den kan starta ett installerat AIR-program i användarens system. Se Starta ett installerat AIR-program från webbläsaren .

Du får tillgång till dessa funktioner genom att anropa API:er i en SWF-fil som finns på adobe.com: air.swf. Du kan anpassa filen badge.swf och anropa API:er för air.swf från din egen SWF-fil.

En SWF-fil som körs i webbläsaren kan dessutom kommunicera med ett AIR-program som körs genom att använda klassen LocalConnection. Mer information finns i Kommunicera med andra Flash Player- och AIR-instanser (för ActionScript-utvecklare) eller Communicating with other Flash Player and AIR instances (för HTML-utvecklare).

I AIR SDK och Flex SDK finns filen badge.swf som gör det enklare att använda funktionen för sömlös installation. Filen badge.swf kan installera körningsversionen och ett AIR-program från en länk på en webbsida. Du kan distribuera filen badge.swf och dess källkod på din webbplats.

Du kan skapa en egen SWF-fil som använder API:erna i filen air.swf om du vill samverka med körnings- och AIR-programmen från en webbsida i en webbläsare. Filen air.swf finns på http://airdownload.adobe.com/air/browserapi/air.swf. Om du vill referera till API:erna för air.swf från SWF-filen läser du in air.swf till samma programdomän som SWF-filen. I följande kod visas ett exempel på hur filen air.swf läses in i programdomänen när SWF-filen läses in:

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

När filen air.swf har lästs in (när Loader-objektets contentLoaderInfo -objekt skickar händelsen init ), kan du anropa någon av API:erna för air.swf, vilket beskrivs i nedanstående avsnitt.

En SWF-fil kan kontrollera om körningsversionen är installerad genom att anropa metoden getStatus( ) i filen air.swf som läses in från http://airdownload.adobe.com/air/browserapi/air.swf. Mer information finns i Läsa in filen air.swf .

När filen air.swf har lästs in kan SWF-filen anropa air.swf-filens getStatus( )-metod så här:

var status:String = airSWF.getStatus();

Metoden getStatus() returnerar ett av följande strängvärden, baserat på statusen för körningsversionen på datorn:

getStatus() -metoden returnerar ett fel om den obligatoriska versionen av Flash Player (version 9 uppdatering 3 eller senare i Windows och Mac OS, eller version 10 i Linux) inte är installerad i webbläsaren.

En SWF-fil kan kontrollera om ett AIR-program (med matchande program-ID och utgivar-ID) är installerat genom att anropa metoden getApplicationVersion( ) i filen air.swf som läses in från http://airdownload.adobe.com/air/browserapi/air.swf. Mer information finns i Läsa in filen air.swf .

När filen air.swf har lästs in kan SWF-filen anropa air.swf-filens getApplicationVersion( )-metod så här:

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

Metoden getApplicationVersion() har följande parametrar:

getApplicationVersion() -metoden returnerar ett fel om den obligatoriska versionen av Flash Player (version 9 uppdatering 3 eller senare i Windows och Mac OS, eller version 10 i Linux) inte är installerad i webbläsaren.

En SWF-fil kan installera ett AIR-program genom att anropa metoden installApplication( ) i filen air.swf som läses in från http://airdownload.adobe.com/air/browserapi/air.swf . Mer information finns i Läsa in filen air.swf .

När filen air.swf har lästs in kan SWF-filen anropa air.swf-filens installApplication( )-metod så här:

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

Metoden installApplication() installerar angivet program på användarens dator. Den här metoden har följande parametrar:

Metoden installApplication() fungerar bara när den anropas i händelsehanteraren för en användarhändelse, till exempel ett musklick.

installApplication() -metoden returnerar ett fel om den obligatoriska versionen av Flash Player (version 9 uppdatering 3 eller senare i Windows och Mac OS, eller version 10 i Linux) inte är installerad i webbläsaren.

För att installera en uppdaterad version av ett program i Mac OS måste användaren ha tillräcklig behörighet för att installera i programkatalogen (och administrativa behörigheter om programmet uppdaterar körningsversionen). I Windows måste en användare ha administrativ behörighet.

Du kan också anropa metoden getApplicationVersion() för filen air.swf om du vill kontrollera om ett program redan är installerat. Du kan anropa den här metoden innan programmet börjar installeras eller efter att installationen har startat. Mer information finns i Kontrollera från en webbsida om ett AIR-program är installerat . När programmet körs kan det kommunicera med SWF-innehållet i webbläsaren genom att använda klassen LocalConnection. Mer information finns i Kommunicera med andra Flash Player- och AIR-instanser (för ActionScript-utvecklare) eller Communicating with other Flash Player and AIR instances (för HTML-utvecklare).

Om du vill använda funktionen för webbläsaranrop (så att programmet kan startas från webbläsaren) måste programbeskrivningsfilen för målprogrammet innehålla följande sträng:

<allowBrowserInvocation>true</allowBrowserInvocation>

Mer information om programbeskrivningsfilen finns i AIR-programbeskrivningsfiler .

En SWF-fil i webbläsaren kan starta ett AIR-program genom att anropa metoden launchApplication( ) i filen air.swf som läses in från http://airdownload.adobe.com/air/browserapi/air.swf. Mer information finns i Läsa in filen air.swf .

När filen air.swf har lästs in kan SWF-filen anropa air.swf-filens launchApplication( )-metod så här:

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

Metoden launchApplication() definieras på den översta nivån i filen air.swf (som läses in i programdomänen för användargränssnittets SWF-fil). När den här metoden anropas startar AIR angivet program (om det är installerat och webbläsaranrop tillåts, via inställningen allowBrowserInvocation i programbeskrivningsfilen). Metoden har följande parametrar:

Metoden launchApplication() fungerar bara när den anropas i händelsehanteraren för en användarhändelse, till exempel ett musklick.

launchApplication() -metoden returnerar ett fel om den obligatoriska versionen av Flash Player (version 9 uppdatering 3 eller senare i Windows och Mac OS, eller version 10 i Linux) inte är installerad i webbläsaren.

Om elementet allowBrowserInvocation ställs in på false i programbeskrivningsfilen har ett anrop till metoden launchApplication() ingen effekt.

Innan användargränssnittet som startar programmet visas, kanske du vill anropa metoden getApplicationVersion( ) i filen air.swf. Mer information finns i Kontrollera från en webbsida om ett AIR-program är installerat .

När programmet anropas via funktionen för webbläsaranrop skickar programmets NativeApplication-objekt ett BrowserInvokeEvent-objekt. Mer information finns i Anropa ett AIR-program från webbläsaren (för ActionScript-utvecklare) eller Invoking an AIR application from the browser (för HTML-utvecklare).

Om du använder funktionen för webbläsaranrop måste du tänka på säkerheten. Dessa konsekvenser beskrivs i Anropa ett AIR-program från webbläsaren (for ActionScript developers) och Invoking an AIR application from the browser (för HTML-utvecklare).

När programmet körs kan det kommunicera med SWF-innehållet i webbläsaren genom att använda klassen LocalConnection. Mer information finns i Kommunicera med andra Flash Player- och AIR-instanser (för ActionScript-utvecklare) eller Communicating with other Flash Player and AIR instances (för HTML-utvecklare).