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。
變更事件：註冊控制項的變更事件。每當控制項的值變更時，傳送 Event.CHANGE 事件。在收到事件時，呼叫 value 即可取得引發事件的控制項的值。
快取樣本值：快取會在裝置層級完成。如需有關快取及擷取取樣之控制項值的詳細資訊，請參閱 GameInputDevice 類別文件。

嘗試從已停用的裝置讀取控制項值，會導致 value 擲回 IOError。不過，您還是可以存取描述控制項 (id、minValue 和 maxValue) 的屬性，即使裝置未啟用。這個功能可讓您判斷裝置是否符合您的應用程式需求，而不必先啟用裝置。

如需詳細資訊，請參閱 Adobe Air Developer Center 文章：Adobe AIR 上的遊戲控制器 (英文)。

若是 Android，這個功能支援最低 4.1 的 Android OS 版本，並且至少需要 SWF 版本 20 及命名空間 3.7。若是 iOS，這個功能支援最低 9.0 的 iOS 版本，並且至少需要 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

device

id

maxValue

minValue

value

change