Adobe® Flash® Platform 用 ActionScript® 3.0 リファレンスガイド
ホーム  |  パッケージおよびクラスリストの非表示 |  パッケージ  |  クラス  |  新機能  |  索引  |  付録  |  英語で表示される理由
フィルター: サーバーからデータを取得しています...
サーバーからデータを取得しています...
flash.ui 

GameInputControl  - AS3

パッケージflash.ui
クラスpublic dynamic class GameInputControl
継承GameInputControl Inheritance EventDispatcher Inheritance Object

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 3.7

GameInputControl クラスは、入力デバイス上のコントロールを表します。GameInput API はデバイス上の物理的コントロールを単純な論理的コントロールにマップします。

コントロール値の取得:

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

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

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

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

詳しくは、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 です。

関連する API エレメント



パブリックプロパティ
 プロパティ定義元
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。
Object
      device : GameInputDevice
[読み取り専用] このコントロールが含まれる GameInputDevice オブジェクトを返します。
GameInputControl
      id : String
[読み取り専用] このコントロールの ID を返します。
GameInputControl
      maxValue : Number
[読み取り専用] このコントロールの最大値を返します。
GameInputControl
      minValue : Number
[読み取り専用] このコントロールの最小値を返します。
GameInputControl
      value : Number
[読み取り専用] このコントロールの値を返します。
GameInputControl
パブリックメソッド
 メソッド定義元
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
 Inherited
イベントをイベントフローに送出します。
EventDispatcher
 Inherited
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。
Object
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
イベント
 イベント 概要 定義元
 Inherited[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
  コントロール値の変更時に送出されます。GameInputControl
 Inherited[ブロードキャストイベント] 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

コントロール値の変更時に送出されます。





[ X ]英語で表示される理由
ActionScript 3.0 リファレンスガイドのコンテンツが英語で表示されます。

ActionScript 3.0 リファレンスガイドのすべての部分がすべての言語に翻訳されているわけではありません。言語エレメントが翻訳されていない場合、そのエレメントは英語で表示されます。例えば、ga.controls.HelpBox クラスはどの言語にも訳されていません。このため、リファレンスガイドの日本語バージョンでは、ga.controls.HelpBox クラスは英語で表示されます。