Class: Input

キーボードとゲームパッド(コントローラ)の入力に関する静的クラス。

JavaScript の KeyboardEventとGamepad 周りを扱う。

Properties:

Name	Type	Description
`keyRepeatWait`	Number	[static] キーリピートまでの待ち時間(フレーム)
`keyRepeatInterval`	Number	[static] キーリピート間隔(フレーム)
`keyMapper`	Object	[static] キーボード入力マップ
`gamepadMapper`	Object	[static] ゲームパッド入力マップ
`dir4`	Number	[static][read-only] 4 方向入力の数値(テンキー対応)
`dir8`	Number	[static][read-only] 8 方向入力の数値(テンキー対応)
`date`	Number	[static][read-only] 最後に入力された時刻(ミリ秒)
`_currentState`	Object	[static] 現在の入力状態 {[key: string]: boolean}
`_previousState`	Object	[static] 直前の入力状態 {[key: string]: boolean}
`_gamepadStates`	Array.<Array.<Boolean>>	[static] ゲームパッドの状態 (ゲームパッドの番号, code, 押されているか)
`_latestButton`	String	[static] 最新のボタン
`_pressedTime`	Number	[static] 入力時間
`_dir4`	Number	[static] 4 方向入力の数値
`_dir8`	Number	[static] 8 方向入力の数値
`_preferredAxis`	String	[static] x と y のうち優先軸 (4 方向入力を自然にするのに使われる)
`_date`	Number	[static] 入力時刻

キー名称

RPG ツクール MV では、実際のキーボードのキーやゲームパッドのボタンの名前ではなく、仮想のキー名を使って処理される。
なお、escape に関しては特殊処理が行われており、cancel としても menu としても働く。

キー名称	Description
ok	決定
cancel	キャンセル
shift	ダッシュ
menu	メニュー
pageup	ページアップ
pagedown	ページダウン
up	上移動
down	下移動
left	左移動
right	右移動
tab	N/A
control	N/A
escape	cancel と menu 兼用
debug	デバッグ

N/A は変換はされているものの、使われていない。

キーボード入力マップ

{ code: 'キー名称', ...} の形の、キーコードとキー名称の変換テーブル。
以下のキー名称は規定値。

code	キー名称	キーボード
9	tab	tab
13	ok	enter ※return
16	shift	shift
17	control	control
18	control	alt ※option
27	escape	escape
32	ok	space
33	pageup	pageup
34	pagedown	pagedown
37	left	left arrow
38	up	up arrow
39	right	right arrow
40	down	down arrow
45	escape	insert ※なし
81	pageup	Q
87	pagedown	W
88	escape	X
90	ok	Z
91		※command
96	escape	numpad 0
98	down	numpad 2
100	left	numpad 4
102	right	numpad 6
104	up	numpad 8
120	debug	F9

※ は Mac のキートップ名。
これらのキーを片方のプラットフォームの名前で説明すると、手元のキーボードに説明されているキーがないなど、プレイヤーが混乱する場合があるので注意。
command は参考。

ゲームパッド入力マップ

{ code: 'キー名称', ...} の形の、ゲームパッドのボタンコードとキー名称の変換テーブル。
アナログスティックの入力は up, down, right, left に変換される。
バッドによってボタンコードとボタンの対応はまちまち。
以下のキー名称は規定値。

code	キー名称	Xbox パッド
0	ok	A
1	cancel	B
2	shift	X
3	menu	Y
4	pageup	LB(パンパー)
5	pagedown	RB(パンパー)
6		LT(トリガー)
7		RT(トリガー)
8		back
9		Start
10		L stick push
11		R stick push
12	up	↑
13	down	↓
14	left	←
15	right	→

Xbox パッドは参考。

Methods

(static) _isEscapeCompatible (keyName) → {Boolean}

ESC キーに当たるキー(cancel, menu)か。

Parameters:

Name	Type	Description
`keyName`	String	キー名称

(static) _makeNumpadDirection (x, y) → {Number}

x,y 方向の入力からテンキー方向(0 : ニュートラル)を生成。

Parameters:

Name	Type	Description
`x`	Number	x 方向の入力(-1, 0, 1)
`y`	Number	y 方向の入力(-1, 0, 1)

(static) _onKeyDown (event)

キーが押し下げられた時に呼ばれるイベントハンドラ。

Parameters:

Name	Type	Description
`event`	KeyboardEvent	キーボードイベント

(static) _onKeyUp (event)

キーが離された時に呼ばれるイベントハンドラ。

Parameters:

Name	Type	Description
`event`	KeyboardEvent	キーボードイベント

(static) _onLostFocus ()

フォーカスが外れた時に呼ばれるイベントハンドラ。

(static) _pollGamepads ()

ゲームパッドの状態を監視(ポーリング)する関数。

(static) _setupEventHandlers ()

イベントハンドラの設定。

(static) _shouldPreventDefault (keyCode)

イベントの規定動作を防ぐか。
keyCode が 33:pageup, 34:pagedown, 37:left, 38:up, 39:right, 40:down のいずれかであった場合 true を返す。
これにより、キーボードによるブラウザの基本動作をある程度回避する。

Class: Input

Properties:

キー名称

キーボード入力マップ

ゲームパッド入力マップ

Methods

(static) _isEscapeCompatible (keyName) → {Boolean}

Parameters:

(static) _makeNumpadDirection (x, y) → {Number}

Parameters:

(static) _onKeyDown (event)

Parameters:

(static) _onKeyUp (event)

Parameters:

(static) _onLostFocus ()

(static) _pollGamepads ()

(static) _setupEventHandlers ()

(static) _shouldPreventDefault (keyCode)

Parameters:

(static) _signX ()

(static) _signY ()

(static) _updateDirection ()

(static) _updateGamepadState (gamepad, index)

Parameters:

(static) _wrapNwjsAlert ()

(static) clear ()

(static) initialize ()

(static) isLongPressed (keyName) → {Boolean}

Parameters:

(static) isPressed (keyName) → {Boolean}

Parameters:

(static) isRepeated (keyName) → {Boolean}

Parameters:

(static) isTriggered (keyName) → {Boolean}

Parameters:

(static) update ()