Capabilities-Beispiel: Ermitteln von Systemeigenschaften

Die Datei „CapabilitiesExplorer.mxml“ dient zum Einrichten der Benutzeroberfläche für die Anwendung „CapabilitiesExplorer“. Die Eigenschaften der Flash-Laufzeitumgebungsversion des Benutzers werden in einer DataGrid-Komponenteninstanz auf der Bühne angezeigt. Wenn die Anwendung über einen HTML-Container ausgeführt wird und die externe API verfügbar ist, werden auch die Browserinformationen angezeigt.

Wenn das creationComplete-Ereignis in der Datei der Hauptanwendung ausgelöst wurde, wird die initApp()-Methode aufgerufen. Mit der initApp()-Methode wird die getCapabilities()-Methode über die com.example.programmingas3.capabilities.CapabilitiesGrabber-Klasse aufgerufen. Der Code für die initApp()-Methode lautet wie folgt:

private function initApp():void 
{ 
    var dp:Array = CapabilitiesGrabber.getCapabilities(); 
    capabilitiesGrid.dataProvider = dp; 
}

Die CapabilitiesGrabber.getCapabilities()-Methode gibt ein sortiertes Array mit Informationen zur Flash-Laufzeitumgebung und zum Browser zurück, das dann an die dataProvider-Eigenschaft der DataGrid-Komponenteninstanz capabilitiesGrid auf der Bühne übergeben wird.

Mit der statischen getCapabilities()-Methode der CapabilitiesGrabber-Klasse werden alle Eigenschaften der flash.system.Capabilities-Klasse zu einem Array (capDP) hinzugefügt. Dann wird die statische getBrowserObjects()-Methode der CapabilitiesGrabber-Klasse aufgerufen. Bei der getBrowserObjects()-Methode wird mithilfe der externen API das Navigatorobjekt des Browsers durchlaufen, das die Browserinformationen enthält. Die getCapabilities()-Methode lautet wie folgt:

public static function getCapabilities():Array 
{ 
    var capDP:Array = new Array(); 
    capDP.push({name:"Capabilities.avHardwareDisable", value:Capabilities.avHardwareDisable});  
    capDP.push({name:"Capabilities.hasAccessibility", value:Capabilities.hasAccessibility});  
    capDP.push({name:"Capabilities.hasAudio", value:Capabilities.hasAudio}); 
    ... 
    capDP.push({name:"Capabilities.version", value:Capabilities.version}); 
    var navArr:Array = CapabilitiesGrabber.getBrowserObjects(); 
    if (navArr.length > 0) 
    { 
        capDP = capDP.concat(navArr); 
    } 
    capDP.sortOn("name", Array.CASEINSENSITIVE); 
    return capDP; 
}

Die getBrowserObjects()-Methode gibt ein Array aller Eigenschaften im Navigatorobjekt des Browsers zurück. Wenn dieses Array mindestens ein Element aufweist, wird das Array der Browserinformationen (navArr) an das Array der Flash Player-Informationen (capDP) angehängt. Das gesamte Array wird dann alphabetisch sortiert. Das sortierte Array wird schließlich an die Datei der Hauptanwendung zurückgegeben, die dann das Datenraster füllt. Der Code für die getBrowserObjects()-Methode lautet wie folgt:

private static function getBrowserObjects():Array 
{ 
    var itemArr:Array = new Array(); 
    var itemVars:URLVariables; 
    if (ExternalInterface.available) 
    { 
        try 
        { 
            var tempStr:String = ExternalInterface.call("JS_getBrowserObjects"); 
            itemVars = new URLVariables(tempStr); 
            for (var i:String in itemVars) 
            { 
                itemArr.push({name:i, value:itemVars[i]}); 
            } 
        } 
        catch (error:SecurityError) 
        { 
            // ignore 
        } 
    } 
    return itemArr; 
}

Wenn die externe API in der aktuellen Umgebung des Benutzers verfügbar ist, wird in der Flash-Laufzeitumgebung die JavaScript-Methode JS_getBrowserObjects() aufgerufen, mit der dann das Navigatorobjekt des Browsers durchlaufen und ein String mit URL-kodierten Werten an ActionScript zurückgegeben wird. Dieser String wird dann in ein URLVariables-Objekt umgewandelt (itemVars) und zum itemArr-Array hinzugefügt, das an das aufrufende Skript zurückgegeben wird.

Bei der Erstellung der Anwendung „CapabilitiesExplorer“ muss abschließend der nötige JavaScript-Code geschrieben werden, mit dem die einzelnen Elemente im Navigatorobjekt des Browsers durchlaufen werden sowie ein Name-Wert-Paar an ein temporäres Array angehängt wird. Der Code für die JavaScript-Methode JS_getBrowserObjects() in der Datei „container.html“ lautet wie folgt:

<script language="JavaScript"> 
    function JS_getBrowserObjects() 
    { 
        // Create an array to hold each of the browser's items. 
        var tempArr = new Array(); 
 
        // Loop over each item in the browser's navigator object. 
        for (var name in navigator) 
        { 
            var value = navigator[name]; 
 
            // If the current value is a string or Boolean object, add it to the 
            // array, otherwise ignore the item. 
            switch (typeof(value)) 
            { 
                case "string": 
                case "boolean": 
 
                    // Create a temporary string which will be added to the array. 
                    // Make sure that we URL-encode the values using JavaScript's 
                    // escape() function. 
                    var tempStr = "navigator." + name + "=" + escape(value); 
                    // Push the URL-encoded name/value pair onto the array. 
                    tempArr.push(tempStr); 
                    break; 
            } 
        } 
        // Loop over each item in the browser's screen object. 
        for (var name in screen) 
        { 
            var value = screen[name]; 
 
            // If the current value is a number, add it to the array, otherwise 
            // ignore the item. 
            switch (typeof(value)) 
            { 
                case "number": 
                    var tempStr = "screen." + name + "=" + escape(value); 
                    tempArr.push(tempStr); 
                    break; 
            } 
        } 
        // Return the array as a URL-encoded string of name-value pairs. 
        return tempArr.join("&"); 
    } 
</script>

Im Code wird zunächst ein temporäres Array erstellt, das alle Name-Wert-Paare des Navigatorobjekts enthält. Als Nächstes wird das Navigatorobjekt mit der for..in-Schleife durchlaufen und der Datentyp des aktuellen Werts geprüft, um unerwünschte Werte zu filtern. In dieser Anwendung werden nur String- oder Boolean-Werte berücksichtigt. Andere Datentypen (z. B. Funktionen oder Arrays) werden dagegen außer Acht gelassen. Alle String- oder Boolean-Werte im Navigatorobjekt werden an das tempArr-Array angehängt. Als Nächstes wird das Bildschirmobjekt des Browsers mit einer for..in-Schleife durchlaufen und jeder numerische Wert wird zum tempArr-Array hinzugefügt. Schließlich wird das temporäre Array mit der Array.join()-Methode in einen String umgewandelt. Im Array werden Und-Zeichen (&) als Trennzeichen verwendet. Dadurch können die Daten in ActionScript mit der URLVariables-Klasse analysiert werden.