GameInputDevice  - AS3

このデバイスを有効または無効にします。デバイスはデフォルトで無効です。デバイスのコントロール値へのアクセスやコントロール値のサンプリングを行うには、デバイスを有効にします。また、デバイスや個々のコントロールがイベントを送出するのは、デバイスが有効なときだけです。

取り外されたデバイスは無効になります。無効になったデバイスに関する情報を取得することはできますが、コントロール値にアクセスしたりキャッシュを開始したりすることはできません。また、削除されたデバイスを有効にすることはできません。デバイスが削除されると、enabled は常に false を返します。

このデバイスの ID を返します。デバイスは ID によって区別できます。

注意：Android デバイスの場合は、デバイス製造元がデバイス ID を提供します。iOS デバイスの場合は、デバイスに再接続すると ID が変わることがあります。

このデバイスの名前を返します。名前によってデバイスのタイプを特定できます。

注意：デバイスの名前は、デバイス製造会社によって設定されます。

このデバイスのコントロールの数を返します。

コントロール値を取得するレート（ミリ秒単位）を指定します。デフォルトは 0 です。これは、フレームごとに値が更新されることを表します。sampleValue に高い値を設定すると、GameInput ではアプリケーションのフレームレートよりも高速なレートでコントロール値がサンプリングされます。

フレームごとよりも高い頻度で値を更新できますが、1 コントロールあたり送出されるイベントは 1 つのみです。そのため、1 フレームで値の更新が 2 回行われると、1 つの変更イベントのみが送出され、最新の値のみを取得できます。

最新の値以外の値も取得するには、このクラスのキャッシュ関連メソッドを使用してサンプル値をキャッシュできます。サンプリングされた値をキャッシュする場合、このプロパティは値がキャッシュに書き込まれる頻度を指定します。

デフォルト値： 0。

キャッシュされたサンプル値を ByteArray に書き込みます。キャッシュされたサンプル値は、取得順で（古い値を先に、新しい値を後に）ByteArray に書き込まれます。

このメソッドは、ByteArray に書き込まれたキャッシュされたサンプル値の数を返します（値そのものではありません）。append パラメーターが false（デフォルト）の場合は、ByteArray がクリアされてから、サンプル値がキャッシュから書き込まれます。append が true の場合は、サンプル値が ByteArray に追加され、古い値も保持されます。サンプル値の追加は次のような場合に行います。

• 特定の数の値を使用できるように維持する必要がある場合。
• キャッシュのサイズを超える履歴を維持する必要がある場合。

サンプル値が ByteArray に書き込まれた後にキャッシュがクリアされます。

このメソッドの呼び出し時にデバイスが無効な場合は、IOError がスローされます。

パラメーター

デバイスから特定のコントロールを取得します。

GameInputDevice は、デバイス上のコントロールをリストに格納します。デバイス上の各コントロールにアクセスするには、getControlAt() メソッドを使用します。

インデックス内のコントロールの順序は、デバイスが追加または削除されるごとに変更される可能性があります。GameInputControl オブジェクトの id プロパティをチェックして、特定のコントロールを照会できます。

デバイスが有効でない場合でもコントロールを取得することはできますが、無効になっているデバイスからコントロール値を読み取ることはできません。この機能を使用して、コントロールのプロパティを読み取ってから、コントロールが属するデバイスを有効にすることができます。この機能は、デバイスを有効にする前にそのデバイスがアプリケーションに適しているかどうかを判断するために使用できます。

パラメーター

サンプリングされた値のキャッシュの保存を開始するようにこのデバイスに要求します。sampleInterval プロパティは、サンプリングの頻度を示します。numSamples パラメーターでは、キャッシュするサンプルの数を指定します。controls パラメーターでは、サンプリングするコントロールの ID 値を指定します。

コントロール値は、指定した順序でキャッシュされます。サンプリングされた値は、getCachingSamples メソッドを呼び出して取得します。

サンプリングされた値のキャッシュに必要なメモリが getCachingSamples 定数に指定された値よりも大きい場合、このメソッドは MemoryError をスローします。このメソッドの呼び出し前にデバイスが有効になっていない場合は、IOError がスローされます。

パラメーター

サンプルのキャッシュを停止します。コントロール上の変更イベントは送出され続けますが、サンプルがキャッシュに保存されなくなります。sampleInterval で指定した頻度で値が取得され続けますが、これらの値はキャッシュに保存されません。そのため、取得できるのは最新の値だけです。

サンプリングされたコントロール値のキャッシュに使用するバッファーの最大サイズを指定します。startCachingSamples が指定したよりも多くのメモリを必要とするサンプルを返す場合は、メモリエラーがスローされます。