Build Game Create / Docs / 8. copyObject() と複製の仕組み
Create へ戻る

Build Game Docs

8. copyObject() と複製の仕組み

弾や分身を量産するための中核が copyObject() です。この章では、どこまで深くコピーされるか、なぜ安全に増やせるのかを細かく見ます。

copyObject() は「今この瞬間の状態」を増やす

copyObject() は、クラス定義から新しく作り直す関数ではありません。いまの座標、角度、タグ、vars、tweens などを持った実体を、そのまま複製して増やします。

そのため、テンプレート弾を 1 つ置いておき、必要な時だけ複製して少し調整する、という作り方ととても相性が良いです。

複製に関わる関数

copyObject(sourceObject = this)

指定した GameObject を複製し、現在の Scene に追加します。引数を省略すると自分自身を複製します。

  • sourceObject: コピー元の GameObject です。省略時は this。
  • 戻り値: 新しく複製された GameObject を返します。

コピー先では id と number が新しくなり、isCopy は true になります。spawn() は再実行されず、isSpawned はすでに true の状態で追加されます。

isPlainObject(value)

値が「普通のオブジェクト」かどうかを判定する内部関数です。配列やクラスインスタンスではなく、{} のようなプレーンオブジェクトだけを対象にします。

  • value: 判定したい値です。
  • 戻り値: プレーンオブジェクトなら true、それ以外は false。

cloneRuntimeValue() が「どこまで再帰的にコピーしてよいか」を判断する時に使います。

cloneRuntimeValue(value)

配列やプレーンオブジェクトを再帰的に複製する内部関数です。単なる参照コピーではなく、コピー先が独立して値を持てるようにします。

  • value: 複製したい値です。配列・プレーンオブジェクト・数値・文字列などを受け取れます。
  • 戻り値: 複製後の値です。プリミティブ値ならそのまま返します。

copyObject() で vars や tweens を複製する時、この関数が重要になります。

Game.generateId()

新しい識別番号を 1 つ返します。通常はユーザーが直接呼ぶより、GameObject.constructor() や copyObject() の内部で自動的に使われます。

  • 引数: なし。
  • 戻り値: 一意な整数 ID を返します。

複製先を「元とほぼ同じだが別個体」として扱えるのは、この関数で新しい番号を振っているからです。