Voorbeeld van een filmclip: RuntimeAssetsExplorer

Als u wilt zorgen dat de browser goed met een SWF-bibliotheek kan communiceren, moet de structuur van de bibliotheken met uitvoeringselementen worden geformaliseerd. Hiervoor wordt een interface gemaakt, die lijkt op een klasse (het is een blauwdruk van methoden die een verwachte structuur kunnen omsluiten), waarin zich echter geen methoden bevinden. De interface biedt een manier om de uitvoeringsbibliotheek en de browser met elkaar te laten communiceren. Elke SWF met uitvoeringselementen die in uw browser wordt geladen, implementeert deze interface. Zie het onderwerp over interfaces in ActionScript 3.0 leren gebruiken voor meer informatie over interfaces en hoe u deze kunt gebruiken.

De interface RuntimeLibrary is erg eenvoudig: er is slechts een functie voor nodig die de browser een array klassenpaden voor de te exporteren symbolen biedt en die beschikbaar is in de uitvoeringsbibliotheek. Hiervoor kent de interface een enkele methode: getAssets() .

package com.example.programmingas3.runtimeassetexplorer 
{ 
    public interface RuntimeLibrary 
    { 
        function getAssets():Array; 
    } 
}

Wanneer u de interface RuntimeLibrary definieert, is het mogelijk meerdere SWF-bestanden met een elementenbibliotheek te maken die in een ander SWF-bestand kunnen worden geladen. Bij het maken van een individueel SWF-bestand met een elementenbibliotheek zijn vier taken betrokken:

• Een klasse voor het SWF-bestand met de elementenbibliotheek maken

• Klassen maken voor individuele elementen die zich in de bibliotheek bevinden

• De feitelijke grafische elementen maken

• Grafische elementen aan klassen koppelen en de bibliotheek-SWF publiceren

package 
{ 
    import flash.display.Sprite; 
    import com.example.programmingas3.runtimeassetexplorer.RuntimeLibrary; 
     
    public class GeometricAssets extends Sprite implements RuntimeLibrary  
    { 
        public function GeometricAssets() { 
             
        } 
        public function getAssets():Array { 
            return [ "com.example.programmingas3.runtimeassetexplorer.AnimatingBox", 
                     "com.example.programmingas3.runtimeassetexplorer.AnimatingStar" ];     
        } 
    } 
}

package com.example.programmingas3.runtimeassetexplorer 
{ 
    import flash.display.MovieClip; 
     
    public class AnimatingStar extends MovieClip 
    { 
        public function AnimatingStar() { 
        } 
    } 
}

De laatste functie die moet worden uitgevoerd, is de gebruikersinterface voor de elementverkenner. In dit voorbeeld heeft het pad naar de uitvoeringsbibliotheek een vaste structuur, met de naam ASSETS_PATH als variabele. U kunt ook de klasse FileReference gebruiken om bijvoorbeeld een interface te maken, die op de vaste schijf naar een bepaald SWF-bestand bladert.

Wanneer het laden van de uitvoeringsbibliotheek is voltooid, roept Flash Player de methode runtimeAssetsLoadComplete() aan:

private function runtimeAssetsLoadComplete(event:Event):void 
{ 
    var rl:* = event.target.content; 
    var assetList:Array = rl.getAssets(); 
    populateDropdown(assetList); 
    stage.frameRate = 60; 
}

In deze methode vertegenwoordigt de variabele rl het geladen SWF-bestand. De code roept de methode getAssets() van het geladen SWF-bestand aan, waarbij de lijst wordt verkregen met elementen die beschikbaar zijn. De elementen worden vervolgens gebruikt om een component ComboBox te vullen met een lijst beschikbare elementen door de methode populateDropDown() aan te roepen. Deze methode slaat op zijn beurt het volledige klassenpad van elk element op. Wanneer u in de gebruikersinterface op de knop Toevoegen klikt, wordt de methode addAsset() geactiveerd:

private function addAsset():void 
{ 
    var className:String = assetNameCbo.selectedItem.data; 
    var AssetClass:Class = getDefinitionByName(className) as Class; 
    var mc:MovieClip = new AssetClass(); 
    ... 
}

het klassenpad van het op dat moment geselecteerde element in ComboBox ( assetNameCbo.selectedItem.data ) wordt opgehaald en de functie getDefinitionByName() (uit het pakket flash.utils) wordt gebruikt om een daadwerkelijke verwijzing naar de klasse van het element te verkrijgen, zodat een nieuwe instantie van dat element kan worden gemaakt.