assemble-scene について
assemble-sceneは、PlayCanvasシーン内のオブジェクトを構成・配置する開発スキルです。ルートとビジュアルの階層、コライダーの寸法、間隔、ライフサイクルの後処理、描画後の配置確認を扱います。
主な機能
- 01名前付きルートを基点にオブジェクトを構成
- 02測定した描画境界にコライダーを合わせる
- 03校正済みの占有範囲に基づく間隔設定
- 04UIなどをモデル階層の外に配置
- 05描画後に支持点と取り付け点を確認
- 06ルートの削除と所有イベントの解除
活用シーン
- 01オブジェクトを反復配置するシーンの構成
- 02コライダー寸法とオブジェクト間隔の設定
- 03オブジェクトの浮きや表面への貫通の確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ playcanvas/ skills --skill assemble-sceneインストール後、Claude Code で/assemble-sceneを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/direct-engine.mdreact.mdweb-components.md詳細
シーンの組み立て
各シーンオブジェクトには、名前付きのルートが 1 つあります。位置、向き、rigidbody、collision、スクリプトはルートに設定し、その下に calibrate-model で調整したビジュアルを配置します。調整は一度だけ適用してください。調整記録が見つからない場合は、先に調整してください。
- ルートには役割に応じた名前を付け、繰り返し配置するインスタンスには一貫性のある名前を付けます。
- コライダーは計測した境界に合わせてサイズを決め、レンダリング境界と位置を揃えます。
- ルート間の間隔は、ピボット位置ではなく、調整記録にあるスケーリング後の占有範囲を基準にします。90°以外のヨー回転では占有範囲が回転するため、より大きい水平方向の範囲を確保します。
- UI、エフェクト、カメラ、ライトはモデル階層の外に配置します。
- ルートを削除する際は、そのサーフェスのライフサイクルを通じて削除し、所有するイベントの登録を解除します。
- 剛体を使用する場合は、先に Ammo を読み込む必要があります(
build-app)。
配置を確認する
レンダリングされたフレームの後、inspect-runtime を通じて読み取ったマウントポイント、レイキャスト、またはジオメトリサンプルを使い、オブジェクトの実際の位置で各支持点や接続点を計測します。隙間が正の値なら浮いており、負の値ならめり込んでいます。無関係なルート間でワールド AABB が重なる場合は、異なる 2 つの視点から重なりが空間であることを確認できない限り、不合格です。
コードに合ったリファレンスだけを参照してください:direct Engine、React、または Web Components。
コメント
Markdown 対応