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 を返します。
複製先を「元とほぼ同じだが別個体」として扱えるのは、この関数で新しい番号を振っているからです。