System - Adobe ActionScript® 3 (AS3 ) API 참조 설명서

패키지	flash.system
클래스	public final class System
상속	System Object

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9, Flash Lite 4

System 클래스는 로컬 설정 및 작업과 관련된 속성을 포함합니다. 예를 들어 카메라와 마이크에 대한 설정, 공유 객체를 사용한 작업 및 클립보드 사용 등이 있습니다.

추가 속성 및 메서드는 Capabilities 클래스, Security 클래스, IME 클래스 등 flash.system 패키지 내의 다른 클래스에 들어 있습니다.

System 클래스에는 정적 메서드 및 속성만 들어 있습니다. 이 클래스에서는 새 인스턴스를 만들 수 없습니다.

예제 보기

공용 속성

상속되는 공용 속성 숨기기

상속되는 공용 속성 표시

	속성		정의 주체
		constructor : Object 지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.	Object
		freeMemory : Number [정적] [읽기 전용] Adobe® Flash® Player 또는 Adobe® AIR®에 할당되었지만 사용하고 있지 않은 메모리 양(바이트 단위)입니다.	System
		ime : IME [정적] [읽기 전용] 현재 설치된 시스템 IME입니다.	System
		privateMemory : Number [정적] [읽기 전용] 응용 프로그램에서 사용한 전체 메모리 양(바이트 단위)입니다.	System
		totalMemory : uint [정적] [읽기 전용] Flash Player 또는 AIR에 의해 직접 할당되어 현재 사용 중인 메모리의 양(바이트 단위)입니다.	System
		totalMemoryNumber : Number [정적] [읽기 전용] Flash Player 또는 AIR에 의해 직접 할당되어 현재 사용 중인 메모리의 양(바이트 단위)입니다.	System
		useCodePage : Boolean [정적] 외부 텍스트 파일을 해석하는 데 사용할 코드 페이지를 지정하는 부울 값입니다.	System

공용 메서드

상속되는 공용 메서드 숨기기

상속되는 공용 메서드 표시

	메서드		정의 주체
		disposeXML(node:XML):void [정적] 지정한 XML 객체를 가비지 수집에 즉시 사용할 수 있도록 설정합니다.	System
		exit(code:uint):void [정적] Flash Player를 닫습니다.	System
		gc():void [정적] 가비지 수집 프로세스를 실행합니다.	System
		hasOwnProperty(name:String):Boolean 지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.	Object
		isPrototypeOf(theClass:Object):Boolean Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.	Object
		pause():void [정적] Flash Player 또는 ADL(AIR Debug Launcher)을 일시 정지합니다.	System
		pauseForGCIfCollectionImminent(imminence:Number = 0.75):void [정적] 가비지 수집기의 긴급도가 함수의 긴급도 매개 변수를 초과하면 수집기에서 증분 수집 주기를 완료하도록 가비지 수집기에 지시합니다.	System
		propertyIsEnumerable(name:String):Boolean 지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.	Object
		resume():void [정적] System.pause()를 호출한 후 응용 프로그램을 다시 시작합니다.	System
		setClipboard(string:String):void [정적] 클립보드의 내용을 지정된 텍스트 문자열로 바꿉니다.	System
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.	Object
		toLocaleString():String 로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.	Object
		toString():String 지정된 객체의 문자열 표현을 반환합니다.	Object
		valueOf():Object 지정된 객체의 프리미티브 값을 반환합니다.	Object

속성 세부 정보

freeMemory

속성

freeMemory:Number [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2

Adobe^® Flash^® Player 또는 Adobe^® AIR^®에 할당되었지만 사용하고 있지 않은 메모리 양(바이트 단위)입니다. 할당된 메모리(System.totalMemory) 중 사용하지 않는 이 부분은 가비지 수집이 발생함에 따라 계속 변합니다. 가비지 수집을 모니터링하려면 이 속성을 사용하십시오.

구현
public static function get freeMemory():Number

ime

속성

ime:IME [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9, Flash Lite 4

현재 설치된 시스템 IME입니다. imeComposition 이벤트에 등록하려면 이 인터페이스에 addEventListener()를 호출합니다.

구현
public static function get ime():IME

관련 API 요소

IMEConversionMode

privateMemory

속성

privateMemory:Number [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2

응용 프로그램에서 사용한 전체 메모리 양(바이트 단위)입니다. 전체 프로세스를 수행하기 위한 상주 전용 메모리 양입니다.

AIR 개발자는 이 속성을 사용하여 응용 프로그램이 사용하는 전체 메모리 양을 파악해야 합니다.

Flash Player의 경우 이 속성은 컨테이너 응용 프로그램(예: 웹 브라우저)에서 사용하는 메모리를 포함합니다.

구현
public static function get privateMemory():Number

totalMemory

속성

totalMemory:uint [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9, Flash Lite 4

Flash Player 또는 AIR에 의해 직접 할당되어 현재 사용 중인 메모리의 양(바이트 단위)입니다.

이 속성은 Adobe AIR 응용 프로그램 또는 Flash Player 내용을 포함하는 응용 프로그램(예: 브라우저)에서 사용하는 모든 메모리를 반환하지 않습니다. 브라우저 또는 운영 체제가 다른 메모리를 사용할 수 있습니다. System.privateMemory 속성은 응용 프로그램에서 사용하는 모든 메모리를 반영합니다.

할당된 메모리의 양이 uint 객체의 최대값(uint.MAX_VALUE 또는 4,294,967,295)보다 큰 경우 이 속성은 영(0)으로 설정됩니다. System.totalMemoryNumber 속성은 더 큰 값을 허용합니다.

구현
public static function get totalMemory():uint

totalMemoryNumber

속성

totalMemoryNumber:Number [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2

Flash Player 또는 AIR에 의해 직접 할당되어 현재 사용 중인 메모리의 양(바이트 단위)입니다.

이 속성은 숫자로 표현되며, 정수 유형의 System.totalMemory 속성보다 더 높은 값을 허용합니다.

구현
public static function get totalMemoryNumber():Number

관련 API 요소

freeMemory
privateMemory
totalMemory

useCodePage

속성

useCodePage:Boolean

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9, Flash Lite 4

외부 텍스트 파일을 해석하는 데 사용할 코드 페이지를 지정하는 부울 값입니다. 이 속성을 false로 설정하면 외부 텍스트 파일이 유니코드로 해석됩니다. 이러한 파일은 저장 시 유니코드로 인코딩되어야 합니다. 이 속성을 true로 설정하면 외부 텍스트 파일이 응용 프로그램이 실행되는 운영 체제의 일반 코드 페이지로 해석됩니다. useCodePage의 기본값은 false입니다.

Loader.load(), URLLoader 클래스 또는 URLStream을 사용하여 외부 파일로 로드하는 텍스트를 응용 프로그램에서 유니코드로 인식하려면 이러한 파일을 유니코드로 저장해야 합니다. 외부 파일을 유니코드로 인코딩하려면 유니코드를 지원하는 응용 프로그램(예: Windows에서의 메모장)에서 파일을 저장해야 합니다.

유니코드로 인코딩되지 않은 외부 텍스트 파일을 로드하려면 useCodePage를 true로 설정합니다. 데이터를 로드하고 있는 파일의 첫 번째 코드 줄로 다음을 추가합니다(Flash Professional의 경우 첫 번째 프레임에 추가).

System.useCodePage = true;

이 코드가 있으면 응용 프로그램은 운영 체제의 일반 코드 페이지를 사용하여 외부 텍스트를 해석합니다. 예를 들어 일반적으로 영어 Windows 운영 체제의 경우 CP1252이고, 한국어 운영 체제의 경우 EUC-KR입니다.

만약 useCodePage를 true로 설정하면 Flash Player 6 이상 버전은 Flash Player 5와 같은 방법으로 텍스트를 처리합니다. Flash Player 5에서는 모든 텍스트를 Flash Player 실행 운영 체제의 일반 코드 페이지를 사용하는 것으로 간주하고 처리했습니다.

useCodePage를 true로 설정하는 경우 응용 프로그램이 실행되는 운영 체제의 일반 코드 페이지에 외부 텍스트 파일에 사용되는 문자가 포함되어 있어야 텍스트가 표시됩니다. 예를 들어 중국어 문자가 포함된 외부 텍스트 파일을 로드하는 경우 CP1252 코드 페이지에는 중국어 문자가 없으므로 이 코드 페이지를 사용하는 시스템에서 중국어 문자가 표시되지 않습니다.

모든 플랫폼에서 응용 프로그램에 사용된 외부 텍스트 파일을 볼 수 있게 하려면 모든 외부 텍스트 파일을 유니코드로 인코딩하고 useCodePage를 false로 설정된 상태로 두어야 합니다. 이렇게 하면 응용 프로그램(Flash Player 6 이상 또는 AIR)에서 텍스트를 유니코드로 해석합니다.

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

관련 API 요소

flash.display.Loader.load()

메서드 세부 정보

disposeXML

()

메서드

public static function disposeXML(node:XML):void

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 1.5.2

지정한 XML 객체를 가비지 수집에 즉시 사용할 수 있도록 설정합니다. 이 메서드는 지정한 XML 노드에 대해 모든 노드 간 부모 및 자식 연결을 제거합니다.

매개 변수

node:XML — 가비지 수집에 사용할 수 있도록 설정해야 할 XML 참조입니다.

exit

()

메서드

public static function exit(code:uint):void

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9.0.115.0

Flash Player를 닫습니다.

독립 실행형 Flash Player 디버거 버전 전용입니다.

응용 프로그램을 종료하려면 AIR 응용 프로그램에서 NativeApplication.exit() 메서드를 호출해야 합니다.

매개 변수

code:uint — 운영 체제로 전달하는 값입니다. 일반적으로 프로세스가 정상적으로 종료되면 이 값은 0입니다.

관련 API 요소

flash.desktop.NativeApplication.exit()

gc

()

메서드

public static function gc():void

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4

가비지 수집 프로세스를 실행합니다.

Flash Player 디버거 버전 및 AIR 응용 프로그램 전용입니다. AIR 응용 프로그램에서 System.gc() 메서드는 ADL(AIR Debug Launcher)에서 실행되는 내용, 설치된 응용 프로그램 또는 응용 프로그램 보안 샌드박스의 내용에서만 활성화됩니다.

pause

()

메서드

public static function pause():void

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4

Flash Player 또는 ADL(AIR Debug Launcher)을 일시 정지합니다. 이 메서드를 호출한 후에는 Socket 이벤트 전송을 제외하고 아무것도 응용 프로그램에서 진행되지 않습니다.

Flash Player 디버거 버전 또는 ADL(AIR Debug Launcher) 전용입니다.

관련 API 요소

resume()

pauseForGCIfCollectionImminent

()

메서드

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

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 11, AIR 3

가비지 수집기의 긴급도가 함수의 긴급도 매개 변수를 초과하면 수집기에서 증분 수집 주기를 완료하도록 가비지 수집기에 지시합니다.

Flash 런타임 가비지 수집기 알고리즘은 사용 중인 메모리에 표시를 남기면서 증분적으로 실행됩니다. 사용되지 않는 메모리 부분을 수집할 때는 응용 프로그램의 실행이 일시 정지됩니다. 증분 수집 주기가 끝날 때 발생하는 일시 정지가 너무 길어지면 일부 프로그램의 그래픽이나 오디오에 영향을 줄 수 있습니다. 응용 프로그램에서 이 함수를 사용하면 런타임에서 해당 시점에 표시를 완료하고 수집을 실행하도록 지시할 수 있습니다. 일시 정지 시간을 사용자에게 영향이 없을 만한 시점으로 설정하면 사용자 환경이 개선됩니다. 예를 들어 게임에서 한 레벨을 완료할 때 이 함수를 호출하면 게임 플레이 도중에 일시 정지가 발생할 가능성이 낮아집니다.

긴급도는 수집기가 인식하는 표시 완료도로 정의되므로 수집 일시 정지가 발생할 시점을 결정합니다. 이 함수에 대한 긴급도 인수는 임계값입니다. 실제 긴급도가 임계값을 초과할 때만 가비지 수집기가 호출됩니다. 그렇지 않으면 아무 동작 없이 호출이 즉시 반환됩니다.

낮은 imminence 값으로 이 함수를 호출하여 상대적으로 큰 표시는 완료되어야만 응용 프로그램에서 수락한다는 것을 나타냅니다. 큰 imminence 값을 사용하여 표시가 거의 완료된 경우에만 응용 프로그램을 일시 정지해야 한다는 것을 나타냅니다. 일반적으로 일시 정지 시간은 후자의 경우보다 전자의 경우가 더 깁니다.

비워지는 메모리 크기는 imminence 매개 변수에 따라 달라지지 않습니다. 오직 메모리를 비울 수 있는 객체의 수에 따라 달라집니다. 응용 프로그램에서 큰 데이터 구조나 많은 수의 객체에 대한 참조를 최근에 해제한 경우 낮은 imminence 매개 변수를 사용하면 해당 객체를 즉시 비우는 컬렉션이 트리거되는 경향이 있습니다.

매개 변수

imminence:Number (default = 0.75) — 0과 1 사이의 숫자입니다. 여기서 0은 가장 덜 긴급하고 1은 가장 많이 긴급하다는 것을 나타냅니다. 0보다 작은 값은 0.25로, 1.0보다 큰 값은 1.0으로, NaN은 0.75로 기본 설정됩니다.

resume

()

메서드

public static function resume():void

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4

System.pause()를 호출한 후 응용 프로그램을 다시 시작합니다.

Flash Player 디버거 버전 또는 ADL(AIR Debug Launcher) 전용입니다.

관련 API 요소

pause()

setClipboard

()

메서드

public static function setClipboard(string:String):void

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9

클립보드의 내용을 지정된 텍스트 문자열로 바꿉니다. 이 메서드는 키보드, 입력 장치 이벤트 핸들러 등 사용자 이벤트의 결과로 호출되는 경우 모든 보안 컨텍스트에서 작동합니다.

이 메서드는 Flash Player 9에서 실행되는 SWF 내용을 위해 제공됩니다. 클립보드에 String 내용을 추가할 수만 있습니다.

Flash Player 10 내용과 AIR 응용 프로그램의 응용 프로그램 보안 샌드박스에 있는 내용은 Clipboard.setData() 메서드를 호출할 수 있습니다.

매개 변수

string:String — 시스템 클립보드에 배치할 일반 텍스트 문자열입니다. 현재 내용이 있으면 이를 덮어씁니다.

관련 API 요소

flash.desktop.Clipboard

예제 예제 사용 방법

SystemExample.as

다음 예제에서는 System.setClipboard() 메서드 호출 내에서 System.totalMemory를 호출하여 시스템의 총 메모리에 대한 정보를 시스템 클립보드로 복사하는 방법을 보여 줍니다.

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

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

법적 고지 사항 | 온라인 개인 정보 보호 정책

System - AS3

클래스 x

freeMemory

ime

privateMemory

totalMemory

totalMemoryNumber

useCodePage

disposeXML

exit

gc

pause

pauseForGCIfCollectionImminent

resume

setClipboard