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 プロパティは、コントロールの現在の値を返します。このメソッドは、コントロールから直接最新の値を返すわけではなく、前回のコントロールのサンプリング時にキャッシュされた値を返します。

個々のコントロールからコントロール値を取得する方法には、次の 3 つがあります。

ポーリング：コントロールの最新の既知の値を取得する必要があるたびに、value を呼び出します。
変更イベント：コントローラーに変更イベントを登録します。コントロールの値が変更されるたびに、Event.CHANGE イベントが送出されます。イベントの受信時に value を呼び出して、イベントを送出したコントロールの値を取得します。
サンプル値のキャッシュ：キャッシュはデバイスレベルで実行されます。サンプリングされたコントロール値のキャッシュと取得について詳しくは、GameInputDevice クラスの説明を参照してください。

無効になっているデバイスからコントロール値を読み取ろうとすると、value で IOError がスローされます。ただし、デバイスが有効でない場合でも、コントロールを説明するプロパティ（id、minValue、maxValue など）にはアクセスできます。この機能を使用して、デバイスを最初に有効にすることなく、デバイスがアプリケーションのニーズに適合しているかどうかを判断できます。

詳しくは、Adobe Air Developer Center の記事「Game controllers on 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