Build Game Docs
5. Input と基本ユーティリティ
入力や基本計算は、ゲームのどのクラスからでも使える共通道具です。ここでは Input、距離計算、範囲制限などの土台関数を整理します。
共通関数は「どこからでも呼べる道具箱」
Input、MathUtil、clamp() は、特定のプレイヤークラス専用ではなく、どの GameObject からでも使える共通ツールです。ゲームロジックの土台に置いておくと、同じ処理を何度も書かずに済みます。
Input と基本ユーティリティ関数
Input.init()
キーボード入力監視を初期化します。内部で keydown と keyup のイベントリスナーを登録し、押されているキーの状態を Input.keys に保存します。
- 引数: なし。
- 戻り値: なし。
- 注意点: 2 回目以降は何もしません。内部で
initializedを見て重複登録を防いでいます。
通常は Game.init() から自動で呼ばれるため、ユーザーが直接呼ぶ場面はあまりありません。
Input.isPressed(code)
指定したキーが現在押されているかを返します。移動、ショット、メニュー操作など、入力分岐の基本になります。
code:KeyboardEvent.code形式の文字列です。例:"ArrowUp"、"KeyZ"、"ShiftLeft"。- 戻り値: 押されていれば
true、押されていなければfalse。
if (Input.isPressed("ArrowLeft")) {
this.x -= 200 * dt;
}
MathUtil.dist(x1, y1, x2, y2)
2 点の距離を返します。円同士の当たり判定だけでなく、「プレイヤーまでの距離で行動を変える」「近い相手を探す」といった用途にも使えます。
x1/y1: 1 点目の座標です。x2/y2: 2 点目の座標です。- 戻り値: 2 点間の距離を数値で返します。
clamp(value, min, max)
値を指定範囲へ収める補助関数です。プレイヤーの座標を画面外へ出さないようにする時によく使います。
value: 範囲制限したい元の値です。min: 下限値です。max: 上限値です。- 戻り値:
min未満ならmin、max超過ならmax、範囲内なら元の値を返します。
this.x = clamp(this.x, 0, Game.width);
this.y = clamp(this.y, 0, Game.height);