エンティティ生成
dx12_create_entityCreates entities in the DX12 Engine editor, returning the generated entity details synchronously. Supports idempotency keys to prevent duplicate creation on retry.
Instructions
エンティティを生成する(エディタ専用)。フレーム境界で実処理されるが、Node が完了を待って【本物の {entityId, name, sceneGeneration} を同期で返す】({queued} は返らへん)。idempotency_key を付けると、再試行で同じキーが来ても二重生成されず同じ結果が返る。light_*/camera/particle_emitter/trigger は既定パラメータで生成される空エンティティ+コンポーネント(中身は dx12_describe_components 参照)。細かい値は生成後 dx12_set_component / dx12_set_transform で調整する。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | エンティティ名(一意推奨)。省略時は種別名。 | |
| type | Yes | 種別。empty は Transform のみ。light_*/camera/particle_emitter/trigger は該当コンポーネント付きで生成(値は既定。set_component で調整)。 | |
| position | No | [x,y,z]。省略時 [0,0,0]。 | |
| idempotency_key | No | 再試行の重複防止キー。同じキーの再送は二重生成されない。 |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No | エンジンからの生の結果。実際の形は各ツールの説明 / dx12_describe_components を参照。text にも同内容を JSON 文字列で格納。 |