Build Game Create / Docs / 3. GameObject の定義とタグ
Create へ戻る

Build Game Docs

3. GameObject の定義とタグ

GameObject はゲーム内のあらゆる存在の土台です。ここでは基本プロパティ、タグ、個別状態、破棄の考え方をまとめます。

GameObject が最初から持っているもの

GameObject は、位置、サイズ、角度、タグ、破棄フラグ、任意変数、Tween 情報など、ゲームでよく使う基本値を最初から持っています。

  • x / y: 現在位置です。
  • width / height: 矩形判定や矩形描画用のサイズです。
  • radius: 円判定や円描画用の半径です。
  • angle: 向きです。ラジアンで管理します。
  • hitType: "rect" か "circle" を入れます。
  • vars: 自分専用の自由な状態を入れるオブジェクトです。
  • tweens: moveTo() が使う補間移動キューです。
  • id / number: 個体識別用の番号です。
  • isCopy、isSpawned、isDestroyed: 内部管理用のフラグです。
class Player extends GameObject {
    spawn() {
        this.hitType = "circle";
        this.radius = 12;
        this.vars.hp = 5;
    }
}

GameObject の基本関数

GameObject.constructor(x = 0, y = 0)

GameObject の初期位置と基本状態を作ります。プレイヤーも敵も弾も、最終的にはこのコンストラクタの初期化を土台にして動きます。

  • x: 初期 X 座標です。省略すると 0 です。
  • y: 初期 Y 座標です。省略すると 0 です。
  • 戻り値: 新しい GameObject インスタンスです。

継承先で自分用の constructor を作る場合は、通常 super(x, y) でこの初期化を通します。

tags (set/get)

タグを設定したり、現在のタグ一覧を読み出したりするアクセサです。内部では常に配列で保持されるので、1 個でも複数個でも同じ書き味で使えます。

  • 設定時の val: 文字列 1 個でも配列でも渡せます。例: "enemy"、["enemy", "boss"]。
  • 取得時の戻り値: タグ配列を返します。

クラス名だけに役割を埋め込まず、タグで意味付けすることで、当たり判定や検索条件を柔軟にできます。

hasTag(tag)

そのオブジェクトが指定したタグを持っているか調べます。戻り値が true なら、そのタグを持っています。

  • tag: 調べたいタグ名の文字列です。
  • 戻り値: 持っていれば true、持っていなければ false。

getCollidingObject() の内部でもこの関数が使われています。

destroy()

このオブジェクトを削除予定にします。呼んだ瞬間に配列から取り除くのではなく、isDestroyed を立てて、Scene の更新処理の最後に安全に除去されます。

  • 引数: なし。
  • 戻り値: なし。

寿命が尽きた弾、倒された敵、終わったエフェクトは、配列を直接触らず必ずこの関数で消すのが基本です。