ProLoader  - AS3 Flash

Innehåller rotvisningsobjektet i SWF-filen eller bildfilen (JPG, PNG eller GIF) som lästes in med metoden load() eller loadBytes().

Returnerar ett ProLoaderInfo-objekt som motsvarar det objekt som läses in. ProLoaderInfo-objekt delas mellan ProLoader-objektet och det inlästa innehållsobjektet. ProLoaderInfo-objektet tillhandahåller förloppsinformation om inläsningen och statistik om den inlästa filen.

Händelser som rör inläsningen skickas av det ProLoaderInfo-objekt som egenskapen contentLoaderInfo för ProLoader-objektet refererar till. Egenskapen contentLoaderInfo anges till ett giltigt ProLoaderInfo-objekt, redan innan innehållet läses in, så att du kan lägga till händelseavlyssnare till objektet före inläsningen.

Om du vill identifiera ohanterade fel i en inläst SWF-fil använder du egenskapen ProLoader.uncaughtErrorEvents, inte egenskapen ProLoader.contentLoaderInfo.uncaughtErrorEvents.

Obs! Egenskapen contentLoaderInfo returnerar ett ProLoaderInfo-objekt. ProLoaderInfo är ingen underklass till LoaderInfo, och har således ingen implicit typkonvertering till superklassen. Se därför till att du ändrar typdeklarationerna från LoaderInfo till ProLoaderInfo.

Ett objekt som skickar en uncaughtError-händelse när ett ohanterat fel inträffar i koden i det här ProLoader-objektets SWF-fil. Ett ohanterat fel inträffar när ett fel genereras utanför try..catch-block eller när ett ErrorEvent-objekt skickas utan några registrerade avlyssnare.

Den här egenskapen skapas när den SWF-fil som är associerad med det här objektet har lästs in helt. Tills dess är egenskapen uncaughtErrorEvents null. I ett projekt med endast ActionScript får du åtkomst till den här egenskapen under eller efter det att konstruktorfunktionen körts i huvudklassen för SWF-filen.

Åtkomst till den här ProLoader-egenskapen, i en spelare som saknar stöd, resulterar i ett fel. Returnerar ett EventDispatcher-objekt i stället för ett UncaughtErrorEvents-objekt för att undvika genereringsfel i spelare som inte stöds.

Relaterade API-element

Skapar ett ProLoader-objekt som du kan använda för att läsa in filer, t.ex. SWF-, JPEG-, GIF- eller PNG-filer. Använd metoden load() för att läsa in resursen som underordnad till ProLoader-instansen. Sedan kan du lägga till ProLoader-objektet i visningslistan (till exempel genom att använda metoden addChild() för en DisplayObjectContainer-instans). Tillgången visas på scenen när den läses in.

Du kan också använda en ProLoader-instans "offlist" (utanför listan), det vill säga utan att lägga till den i en behållare för visningsobjekt i visningslistan. I det här läget kan Loader-instansen användas för att läsa in en SWF-fil som består av ett programs ytterligare moduler.

För att identifiera när SWF-filen har lästs in helt kan du använda händelserna för det ProLoaderInfo-objekt som är kopplat till egenskapen contentLoaderInfo för ProLoader-objektet. I det skedet kan koden i modulens SWF-fil köras för att initiera och starta modulen. I offlistläget kan en ProLoader-instans också användas för att läsa in en SWF-fil som innehåller komponenter eller medieresurser. Du kan även här använda händelser för ProLoaderInfo-objektet för att identifiera när komponenterna har lästs in helt. I det skedet kan programmet börja använda komponenterna och medieresurserna i SWF-filens bibliotek genom att instansiera de ActionScript 3.0-klasser som representerar dessa komponenter och resurser.

Ta reda på ett ProLoader-objekts status genom att övervaka följande händelser som ProLoaderInfo-objektet associerade med egenskapen contentLoaderInfo hos ProLoader-objektet:

• Händelse open skickas när inläsningen börjar.
• Händelse ioError eller securityError skickas om filen inte kan läsas in eller om ett fel uppstod under inläsningsprocessen.
• Händelse progress aktiveras kontinuerligt när filen läses in.
• Händelsen complete skickas när en fil har laddats ned helt, men innan det inlästa filmklippets metoder och egenskaper blir tillgängliga. Om den inlästa SWF-filen använder RSL-förinläsning skickas den här händelsen när RSL-förinläsningen är klar. Då är det verkliga innehållet tillgängligt i egenskapen content.
• Händelse init skickas efter det att den inlästa SWF-filens egenskaper och metoder är tillgängliga, så att du kan börja arbeta med den inlästa SWF-filen. Denna händelse skickas före hanterare complete. Vid direktuppspelning av SWF-filer kan händelse init uppträda betydligt tidigare än händelse complete. Använd init i de flesta fall. Om den inlästa SWF-filen använder RSL-förinläsning skickas den här händelsen när RSL-förinläsningen är klar. Då är det verkliga innehållet tillgängligt i egenskapen content.

Relaterade API-element

Avbryter en load()-metodåtgärd som pågår för ProLoader-instansen.

Läser in en fil av typen SWF, JPEG, progressiv JPEG, oanimerad GIF eller PNG i ett objekt som är underordnat detta ProLoader-objekt. När du läser in en animerad GIF-fil visas bara den första bildrutan. Eftersom ProLoader-objektet bara kan innehålla ett enda underordnat objekt avslutar utställandet av ytterligare en load()-begäran den föregående begäran, om den fortfarande är oavslutad, och inleder en ny inläsning.

Obs! I AIR 1.5 och Flash Player 10 är maxstorleken för en inläst bild 8 191 pixlar i bredd och höjd, och det totala antalet pixlar får inte överskrida 16 777 215 pixlar. (Om en inläst bild är 8 191 pixlar bred kan den därför bara vara 2 048 pixlar hög.) I Flash Player 9 och tidigare och i AIR 1.1 och tidigare är begränsningen 2 880 pixlar i höjd och 2 880 pixlar i bredd.

En SWF-fil eller bild som lästs in i ett ProLoader-objekt ärver positions-, rotations- och skalegenskaper för ProLoader-objektets överordnade visningsobjekt.

Använd metoden unload() om du vill ta bort filmer och bilder som lästs in med den här metoden eller avbryta en pågående inläsning.

Du kan förhindra att metoden används av en SWF-fil genom att ställa in parametern allowNetworking i object- och embed-taggarna på den HTML-sida där SWF-innehållet finns.

När du använder den här metoden bör du överväga Flash Player-säkerhetsmodellen, som behandlas i beskrivningen av klassen ProLoader.

Om du i Flash Player 10 eller senare använder en multipart-innehållstyp (till exempel ”multipart/form-data”) som innehåller en överföring (vilket indikeras av en ”filename”-parameter i ett ”content-disposition”-huvud inuti POST), gäller de säkerhetsregler som används för överföringar också för POST-åtgärden.

• POST-åtgärden måste utföras som ett svar på en användarinitierad åtgärd som exempelvis en musklickning eller en tangenttryckning.
• Om POST-åtgärden är för korsdomän (POST-målet ligger inte på samma server som SWF-filen som skickar POST-begäran), måste målservern ha en URL-policyfil som tillåter korsdomänåtkomst.

För en multipart-innehållstyp måste också syntaxen vara giltig (enligt standarden RFC2046). Om syntaxen verkar vara ogiltig, gäller samma regler för POST-åtgärden som för överföringar.

Mer information om säkerhet finns i avsnittet Security på Flash Player Developer Center.

Parametrar

Relaterade API-element

Läser in från binära data i ett ByteArray-objekt.

Metoden loadBytes() är asynkron. Du måste vänta på "init"-händelsen innan du kan komma åt egenskaperna för ett inläst objekt.

När du använder den här metoden bör du överväga Flash Player-säkerhetsmodellen, som behandlas i beskrivningen av klassen ProLoader.

Parametrar

Relaterade API-element

Läser in en IFilePromise-instans via parametern promise. Typen för promise-parametern använder superklassen Object i stället för IFilePromise för att undvika fel i andra spelare.

Metoden loadFilePromise tar ett IFilePromise-objekt och läser in de binära data. Om dessa data är en progressiv ström, t.ex. en videoväntan på "init"-händelsen eller progress-händelser innan det inlästa objektets egenskaper hämtas. Annars väntar du på complete-händelsen för att försäkra dig om att alla data har lästs in.

När du använder den här metoden bör du överväga Flash Player-säkerhetsmodellen, som behandlas i beskrivningen av klassen ProLoader.

Parametrar

Relaterade API-element

Tar bort ett underordnat objekt från det här ProLoader-objektet som har lästs in med metoden load(). property för det associerade ProLoaderInfo-objektet återställs till null. Det underordnade objektet förstörs inte nödvändigtvis eftersom andra objekt kan ha referenser till det. Det är emellertid inte längre underordnat ProLoader-objektet.

Bästa praxis är att du, innan du avladdar en underordnad SWF-fil, uttryckligen stänger eventuella streamer i den underordnade SWF-filens objekt, såsom LocalConnection-, NetConnection-, NetStream- och Sound-objekt. I annat fall kan ljudet i den underordnade SWF-filen fortsätta att spelas upp, trots att den underordnade SWF-filen har avladdats. För att stänga streams i den underordnade SWF-filen lägger man till en händelseavlyssnare till den underordnade som lyssnar efter händelse unload. När det överordnade objektet anropar ProLoader.unload() skickas händelsen unload till det underordnade objektet. Den kod som följer visar hur detta kan göras:

function closeAllStreams(evt:Event) { 
    myNetStream.close();
    mySound.close();
    myNetConnection.close();
    myLocalConnection.close();
}

myMovieClip.loaderInfo.addEventListener(Event.UNLOAD, closeAllStreams);

Relaterade API-element