System  - AS3

Den mängd minne (i byte) som tilldelats Adobe^® Flash^® Player eller Adobe^® AIR^® och som inte används. Den här oanvända delen av det tilldelade minnet (System.totalMemory) varierar när skräpsamling utförs. Använd den här egenskapen för att övervaka skräpsamling.

Relaterade API-element

Datorns installerade IME. Om du vill registrera imeComposition-händelser anropar du addEventListener() på den här instansen.

Relaterade API-element

Det totala minne (i byte) som används av ett program. Detta är mängden resident privat minne för hela processen.

AIR-utvecklare bör använda den här egenskapen för att fastställa ett programs totala minnesanvändning.

För Flash Player inkluderar detta det minne som används av behållarprogrammet, t.ex. webbläsaren.

Relaterade API-element

Den mängd minne (i byte) som används just nu och som har tilldelats direkt av Flash Player eller AIR.

Den här egenskapen returnerar inte allt minne som används av ett Adobe AIR-program eller av det program (till exempel en webbläsare) som innehåller Flash Player-innehållet. Webbläsaren eller operativsystemet kan använda ytterligare minne. Egenskapen System.privateMemory speglar allt minne som används av ett program.

Om den tilldelade mängden minne är större än det maximala värdet på ett uint-objekt (uint.MAX_VALUE eller 4 294 967 295) ställs den här egenskapen in på 0. Med egenskapen System.totalMemoryNumber kan större värden användas.

Relaterade API-element

Den mängd minne (i byte) som används just nu och som har tilldelats direkt av Flash Player eller AIR.

Den här egenskapen uttrycks som ett tal (Number), vilket tillåter högre värden än egenskapen System.totalMemory, som har typen int.

Den här egenskapen returnerar inte allt minne som används av ett Adobe AIR-program eller av det program (till exempel en webbläsare) som innehåller Flash Player-innehållet. Webbläsaren eller operativsystemet kan använda ytterligare minne. Egenskapen System.privateMemory speglar allt minne som används av ett program.

Relaterade API-element

Ett booleskt värde som identifierar vilken kodsida som ska användas för att tolka externa textfiler. När egenskapen har angetts till false tolkas externa textfiler som Unicode. (Filerna måste kodas som Unicode när du sparar dem.) När egenskapen har angetts till true tolkas externa textfiler med den traditionella teckentabellen i det operativsystem som spelaren körs på. Standardvärdet för useCodePage är false.

Text som har lästs in som en extern fil (med Loader.load(), klassen URLLoader eller URLStream) måste ha sparats som Unicode för att programmet ska kunna identifiera den som Unicode. Koda filerna som Unicode genom att spara dem i ett program som stöder Unicode, till exempel Anteckningar i Windows.

Om du läser in externa textfiler som inte är Unicode-kodade ska useCodePage vara true. Lägg till följande som den första raden med kod i filen som läser in data (läggs till i den första bildrutan i Flash Professional):

System.useCodePage = true;

När den här koden har lagts till tolkar programmet externa textfiler med den traditionella teckentabellen i operativsystemet. Detta är till exempel oftast CP1252 för en engelsk Windows-version och Shift-JIS för ett japanskt operativsystem.

Om useCodePage är true hanteras text i Flash Player 6 och senare som i Flash Player 5. (Flash Player 5 hanterar all text som om den hade den traditionella teckentabellen i operativsystemet som spelaren körs på.)

Om du anger useCodePage till true måste den traditionella teckentabellen i operativsystemet som programmet körs på innehålla de tecken som används i den externa textfilen för att texten ska kunna visas. Om du till exempel läser in en extern textfil som innehåller kinesiska tecken kan dessa tecken inte visas i ett system som har teckentabellen CP1252 eftersom teckentabellen inte innehåller kinesiska tecken.

Om användare på alla plattformar ska kunna visa externa textfiler som används i programmet måste du koda alla externa textfiler som Unicode och låta useCodePage ha värdet false. På så sätt kan programmet (Flash Player 6 och senare eller AIR) tolka texten som Unicode.

Relaterade API-element

Gör det angivna XML-objektet tillgängligt för skräpsamling direkt. Den här metoden tar bort de över- och underordnade anslutningarna mellan alla noder för den angivna XML-noden.

Parametrar

Stänger Flash Player.

Endast för den fristående felsökningsversionen av Flash Player.

AIR-program ska anropa metoden NativeApplication.exit() för att avsluta programmet.

Parametrar

Relaterade API-element

Tvingar skräpsamlingsprocessen att starta.

Endast för felsökningsversionen av Flash Player och AIR-program. I ett AIR-program aktiveras metoden System.gc() endast i innehåll som körs i ADL (AIR Debug Launcher) eller, i ett installerat program, i innehåll i programmets säkerhetssandlåda.

Pausar Flash Player eller ADL (AIR Debug Launcher). När den här metoden har anropats avbryts alla åtgärder i programmet förutom leverans av Socket-händelser.

Endast för felsökningsversionen av Flash Player eller ADL (AIR Debug Launcher).

Relaterade API-element

Ställ in skräpinsamlaren så att, om den är hotande nära att överskrida funktionens imminence-parameter, insamlaren ska avsluta den stegvisa insamlingscykeln.

Algoritmen för Flash Runtime-skräpinsamlaren körs stegvis medan använt minne markeras. Den pausar programkörningen medan oanvända delar av minnet samlas in. Pausen som inträffar när den stegvisa insamlingscykeln avslutas kan vara längre än önskvärt och den kan observeras eller höras i vissa program. Denna funktion gör det möjligt för programmet att uppmana Flash Runtime att slutföra både markering och utförande av insamlingen. Att schemalägga pauser till tidpunkter då användaren inte uppmärksammar dem ger en bättre användarupplevelse. Ett spel kan till exempel anropa den här funktionen när en nivå avslutas i spelet. Detta medför att riskerna minskar för att pauser inträffar under själva spelet.

Med imminence definieras hur långt insamlaren tros ha kommit i markeringsprocessen för att på så sätt kunna avgöra hur nära insamlingspausen är. Imminence-argumentet till den här funktionen är ett tröskelvärde. Skräpinsamlaren kommer att anropas bara om faktiskt imminence-värde överskrider tröskelvärdet. I annat fall returneras anropet omedelbart utan att några åtgärder vidtas.

Genom att anropa den här funktionen med ett lågt imminence-värde, kommer programmet att visa att det kan acceptera att relativt stora mängder markeringar måste slutföras. Ett högt imminence-värde å andra sidan visar att programmet ska pausas bara om markeringarna är nästan slutförda.  Vanligtvis är pauser längre i det tidigare fallet än i det senare.

Hur mycket minne som frigörs beror inte på imminence-parametern. Det beror endast på antalet frigjorda objekt. Om programmet nyligen frigjort referenser till stora datastrukturer eller till ett stort antal objekt, kan en låg imminence-parameter ha en tendens att utlösa en mängd som omedelbart kommer att frigöra dessa objekt.

Parametrar

Återupptar programmet efter anrop till System.pause().

Endast för felsökningsversionen av Flash Player eller ADL (AIR Debug Launcher).

Relaterade API-element

Ersätter innehållet i Urklipp med en angiven textsträng. Den här metoden fungerar från alla säkerhetssammanhang när den anropas som en följd av en användarhändelse (som en tangentbords- eller indataenhetshändelsehanterare).

Den här metoden tillhandahålls för SWF-innehåll som körs i Flash Player 9. Den tillåter bara att String-innehåll läggs till i Urklipp.

Flash Player 10-innehåll och innehåll i programmets säkerhetssandlåda i ett AIR-program kan anropa metoden Clipboard.setData().

Parametrar

Relaterade API-element