System - API-referens för Adobe ActionScript® 3 (AS3 )

Paket	flash.system
Klass	public final class System
Arv	System Object

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Klassen System innehåller egenskaper för lokala inställningar och åtgärder. Bland dessa finns inställningar för kameror och mikrofoner, åtgärder med delade objekt och användning av Urklipp.

Ytterligare egenskaper och metoder finns i övriga klasser i flash.system-paketet: klassen Capabilities, klassen IME och klassen Security.

Den här klassen innehåller endast statiska metoder och egenskaper. Du kan inte skapa nya instanser av System-klassen.

Visa exemplen

Relaterade API-element

flash.system.Security
flash.events.IMEEvent

Publika egenskaper

Dölj ärvda publika egenskaper

Visa ärvda publika egenskaper

	Egenskap		Definieras med
		constructor : Object En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans.	Object
		freeMemory : Number [statisk] [skrivskyddad] Den mängd minne (i byte) som tilldelats Adobe® Flash® Player eller Adobe® AIR® och som inte används.	System
		ime : IME [statisk] [skrivskyddad] Datorns installerade IME.	System
		privateMemory : Number [statisk] [skrivskyddad] Det totala minne (i byte) som används av ett program.	System
		totalMemory : uint [statisk] [skrivskyddad] Den mängd minne (i byte) som används just nu och som har tilldelats direkt av Flash Player eller AIR.	System
		totalMemoryNumber : Number [statisk] [skrivskyddad] Den mängd minne (i byte) som används just nu och som har tilldelats direkt av Flash Player eller AIR.	System
		useCodePage : Boolean [statisk] Ett booleskt värde som identifierar vilken kodsida som ska användas för att tolka externa textfiler.	System

Publika metoder

Dölj ärvda publika metoder

Visa ärvda publika metoder

	Metod		Definieras med
		disposeXML(node:XML):void [statisk] Gör det angivna XML-objektet tillgängligt för skräpsamling direkt.	System
		exit(code:uint):void [statisk] Stänger Flash Player.	System
		gc():void [statisk] Tvingar skräpsamlingsprocessen att starta.	System
		hasOwnProperty(name:String):Boolean Anger om det finns en egenskap angiven för ett objekt.	Object
		isPrototypeOf(theClass:Object):Boolean Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.	Object
		pause():void [statisk] Pausar Flash Player eller ADL (AIR Debug Launcher).	System
		pauseForGCIfCollectionImminent(imminence:Number = 0.75):void [statisk] Ställ in skräpinsamlaren så att, om den är hotande nära att överskrida funktionens imminence-parameter, insamlaren ska avsluta den stegvisa insamlingscykeln.	System
		propertyIsEnumerable(name:String):Boolean Anger om den angivna egenskapen finns och är uppräkningsbar.	Object
		resume():void [statisk] Återupptar programmet efter anrop till System.pause().	System
		setClipboard(string:String):void [statisk] Ersätter innehållet i Urklipp med en angiven textsträng.	System
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.	Object
		toLocaleString():String Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner.	Object
		toString():String Returnerar det angivna objektets strängbeteckning.	Object
		valueOf():Object Returnerar det angivna objektets primitiva värde.	Object

Egenskapsdetaljer

freeMemory

egenskap

freeMemory:Number [skrivskyddad]

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10.1, AIR 2

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.

Implementering
public static function get freeMemory():Number

Relaterade API-element

privateMemory
totalMemory
totalMemoryNumber

ime

egenskap

ime:IME [skrivskyddad]

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Implementering
public static function get ime():IME

Relaterade API-element

IMEConversionMode

privateMemory

egenskap

privateMemory:Number [skrivskyddad]

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10.1, AIR 2

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.

Implementering
public static function get privateMemory():Number

Relaterade API-element

freeMemory
totalMemory
totalMemoryNumber

totalMemory

egenskap

totalMemory:uint [skrivskyddad]

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

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.

Implementering
public static function get totalMemory():uint

Relaterade API-element

freeMemory
privateMemory
totalMemoryNumber

totalMemoryNumber

egenskap

totalMemoryNumber:Number [skrivskyddad]

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10.1, AIR 2

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.

Implementering
public static function get totalMemoryNumber():Number

Relaterade API-element

freeMemory
privateMemory
totalMemory

useCodePage

egenskap

useCodePage:Boolean

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

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.

Implementering
public static function get useCodePage():Boolean
public static function set useCodePage(value:Boolean):void

Relaterade API-element

flash.display.Loader.load()

Metoddetaljer

disposeXML

()

metod

public static function disposeXML(node:XML):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10.1, AIR 1.5.2

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

node:XML — XML-referens som bör vara tillgänglig för skräpsamling.

exit

()

metod

public static function exit(code:uint):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9.0.115.0

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

code:uint — Ett värde att skicka till operativsystemet. Om processen avslutas normalt är värdet vanligen 0.

Relaterade API-element

flash.desktop.NativeApplication.exit()

gc

()

metod

public static function gc():void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4

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.

pause

()

metod

public static function pause():void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4

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

resume()

pauseForGCIfCollectionImminent

()

metod

public static function pauseForGCIfCollectionImminent(imminence:Number = 0.75):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 11, AIR 3

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

imminence:Number (default = 0.75) — Ett värde mellan 0 och 1, där 0 är mindre överhängande och 1 mycket överhängande. Värden mindre är 0 blir 0,25. Värden större än 1,0 blir 1,0. NaN-värden blir 0,75.

resume

()

metod

public static function resume():void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4

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

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

Relaterade API-element

pause()

setClipboard

()

metod

public static function setClipboard(string:String):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9

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

string:String — En oformaterad textsträng som ska placeras i Urklipp på den lokala datorn och ersätta det befintliga innehållet (om det finns något).

Relaterade API-element

flash.desktop.Clipboard

Exempel Så här använder du exemplet

SystemExample.as

I följande exempel visas hur du kopierar information om datorns totala mängd minne till Urklipp med ett anrop till System.totalMemory i ett anrop till metoden System.setClipboard().

package {
    import flash.display.Sprite;
    import flash.system.System;

    public class SystemExample extends Sprite {
        public function SystemExample() {
            System.setClipboard("System.totalMemory: " + System.totalMemory);
        }
    }
}

Juridiska meddelanden | Onlinesekretesspolicy

System - AS3

Paketx

Språkelement

Bilagor

Paket flash.system

freeMemory

ime

privateMemory

totalMemory

totalMemoryNumber

useCodePage

disposeXML

exit

gc

pause

pauseForGCIfCollectionImminent

resume

setClipboard