Esempio di clip filmato: RuntimeAssetsExplorer

Per consentire all'applicazione di esplorazione di interagire correttamente con una libreria SWF, la struttura delle librerie delle risorse di runtime deve essere formalizzata. A tale scopo, viene creata un'interfaccia, che è simile a una classe nel senso che rappresenta una base di partenza dei metodi che contrassegnano una struttura prevista, ma che a differenza di una classe non contiene i corpi dei metodi stessi. L'interfaccia fornisce un modo per consentire la comunicazione tra la libreria di runtime e l'applicazione di esplorazione. Ogni file SWF di risorse di runtime che viene caricato nel browser implementa questa interfaccia. Per ulteriori informazioni sulle interfacce e la loro utilità, vedete Interfacce in Apprendimento di ActionScript 3.0 .

L'interfaccia RuntimeLibrary è molto semplice: è richiesta esclusivamente una funzione in grado di fornire all'applicazione di esplorazione un array di percorsi di classe per i simboli da esportare e disponibili nella libreria di runtime. A tale scopo, l'interfaccia contiene un solo metodo getAssets() .

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

Definendo l'interfaccia RuntimeLibrary, è possibile creare più file SWF di librerie di risorse che possono essere caricati in un altro file SWF. La creazione di una singola libreria SWF richiede quattro operazioni:

• Creazione di una classe per il file SWF della libreria di risorse

• Creazione delle classi per le singole risorse contenute nella libreria

• Creazione delle risorse grafiche vere e proprie

• Associazione degli elementi grafici alle classi e pubblicazione del file SWF della libreria

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() { 
        } 
    } 
}

L'ultima parte della funzione consiste nell'interfaccia utente per l'applicazione di esplorazione delle risorse. In questo esempio, il percorso della libreria di runtime è codificato nella variabile ASSETS_PATH . In alternativa, potreste utilizzare la classe FileReference: ad esempio, per creare un'interfaccia che permetta di individuare un determinato file SWF sul disco rigido.

Quando la libreria di runtime è stata caricata correttamente, viene chiamato il metodo runtimeAssetsLoadComplete() .

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

In questo metodo, la variabile rl rappresenta il file SWF caricato. Il codice chiama il metodo getAssets() del file SWF caricato e ottiene l'elenco delle risorse disponibili, che utilizza per compilare un componente ComboBox con un elenco di risorse disponibili chiamando il metodo populateDropDown() . A propria volta, questo metodo memorizza il percorso di classe completo di ogni risorsa. Se fate clic sul pulsante Aggiungi dell'interfaccia utente, viene attivato il metodo addAsset() :

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

che ottiene il percorso di classe della risorsa attualmente selezionata nel componente ComboBox ( assetNameCbo.selectedItem.data ) e utilizza la funzione getDefinitionByName() (del pacchetto flash.utils) per ottenere un riferimento reale alla classe della risorsa per poter creare una nuova istanza di tale risorsa.