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

패키지	flash.ui
클래스	public dynamic class GameInputControl
상속	GameInputControl EventDispatcher Object

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 3.7

GameInputControl 클래스는 입력 장치의 컨트롤을 나타냅니다. GameInput API는 장치의 물리적 컨트롤을 단순한 논리적 컨트롤에 매핑합니다.

컨트롤 값 가져오기:

value 속성은 컨트롤의 현재 값을 반환합니다. 이 메서드는 컨트롤에서 직접 최신 값을 반환하지 않습니다. 대신, 컨트롤의 마지막 샘플링 시점에 캐시된 값을 반환합니다.

개별 컨트롤에서 컨트롤 값을 가져오는 방법은 세 가지가 있습니다.

폴링: 컨트롤의 마지막으로 알려진 값을 가져오려 할 때마다 value를 호출합니다.
change 이벤트: 컨트롤러에 대해 change 이벤트를 등록합니다. Event.CHANGE 이벤트는 컨트롤 값이 변경될 때마다 전달됩니다. 이벤트를 수신하면 바로 value를 호출하여 이벤트를 발생시킨 컨트롤의 값을 가져옵니다.
샘플 값 캐시: 캐시는 장치 수준에서 완료됩니다. 샘플링된 컨트롤 값을 캐시하고 검색하는 것에 대한 자세한 내용은 GameInputDevice 클래스 설명서를 참조하십시오.

비활성화된 장치에서 컨트롤 값을 읽으려 하면 value에서 IOError를 발생시킵니다. 하지만 장치가 활성화되지 않은 경우라도 컨트롤을 설명하는 속성(예: id, minValue 및 maxValue)은 액세스할 수 있습니다. 이 기능을 통해 장치를 먼저 활성화하지 않고도 장치가 응용 프로그램의 요구에 맞는지 확인할 수 있습니다.

자세한 내용은 Adobe Air Developer Center 문서 Adobe AIR의 게임 컨트롤러를 참조하십시오.

Android의 경우 이 기능은 Android OS 버전 4.1 이상을 지원하며 SWF 버전 20 및 네임스페이스 3.7 이상이 필요합니다. iOS의 경우 이 기능은 iOS 버전 9.0 이상을 지원하며 SWF 버전 34 및 네임스페이스 23.0 이상이 필요합니다.

공용 속성

상속되는 공용 속성 숨기기

상속되는 공용 속성 표시

	속성		정의 주체
		constructor : Object 지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.	Object
		device : GameInputDevice [읽기 전용] 이 컨트롤을 포함하는 GameInputDevice 객체를 반환합니다.	GameInputControl
		id : String [읽기 전용] 이 컨트롤의 ID를 반환합니다.	GameInputControl
		maxValue : Number [읽기 전용] 이 컨트롤의 최대값을 반환합니다.	GameInputControl
		minValue : Number [읽기 전용] 이 컨트롤의 최소값을 반환합니다.	GameInputControl
		value : Number [읽기 전용] 이 컨트롤의 값을 반환합니다.	GameInputControl

공용 메서드

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

상속되는 공용 메서드 표시

	메서드		정의 주체
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다.	EventDispatcher
		dispatchEvent(event:Event):Boolean 이벤트를 이벤트 흐름으로 전달합니다.	EventDispatcher
		hasEventListener(type:String):Boolean EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher
		hasOwnProperty(name:String):Boolean 지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.	Object
		isPrototypeOf(theClass:Object):Boolean Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.	Object
		propertyIsEnumerable(name:String):Boolean 지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher 객체에서 리스너를 제거합니다.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.	Object
		toLocaleString():String 로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.	Object
		toString():String 지정된 객체의 문자열 표현을 반환합니다.	Object
		valueOf():Object 지정된 객체의 프리미티브 값을 반환합니다.	Object
		willTrigger(type:String):Boolean 이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher

이벤트

이벤트에 대한 자세한 내용을 보려면 클릭하십시오.

상속되는 이벤트 숨기기

상속되는 이벤트 표시

	요약	정의 주체
activate	[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다.	EventDispatcher
change	컨트롤 값이 변경되면 전달됩니다.	GameInputControl
deactivate	[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다.	EventDispatcher

속성 세부 정보

device

속성

device:GameInputDevice [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 3.7

이 컨트롤을 포함하는 GameInputDevice 객체를 반환합니다.

구현
public function get device():GameInputDevice

id

속성

id:String [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 3.7

이 컨트롤의 ID를 반환합니다.

구현
public function get id():String

maxValue

속성

maxValue:Number [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 3.7

이 컨트롤의 최대값을 반환합니다.

구현
public function get maxValue():Number

minValue

속성

minValue:Number [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 3.7

이 컨트롤의 최소값을 반환합니다.

구현
public function get minValue():Number

value

속성

value:Number [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 3.7

이 컨트롤의 값을 반환합니다.

구현
public function get value():Number

오류

IOError — 장치가 비활성화된 상태에서 value가 호출된 경우입니다.

이벤트 세부 정보

change

이벤트

이벤트 객체 유형: flash.events.Event

컨트롤 값이 변경되면 전달됩니다.

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

GameInputControl - AS3

패키지x

언어 요소

부록

패키지 flash.ui

device

id

maxValue

minValue

value

change