Build Game Create / Docs / 5. Input と基本ユーティリティ
Create へ戻る

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);