メインコンテンツまでスキップ

エンティティ

Entity は、PlayCanvas シーンの基本的な構成要素です。

特徴

  • エンティティは 0 個以上のコンポーネント を持てます。
  • エンティティは 親子階層 を形成できます(addChildremoveChild)。
  • エンティティは 有効/無効 を切り替えられます(enabled)。
ヒント

エンティティは軽量に保ち、不要なコンポーネントの追加は避けましょう。

コードでエンティティを作成

const entity = new pc.Entity('MyEntity');
app.root.addChild(entity);

エンティティの有効/無効

entity.enabled = false; // エンティティとそのコンポーネントをすべて無効化
ヒント

未使用の間はエンティティを無効化し、処理負荷を下げましょう。

ライフサイクル

ヒント

不要になったエンティティは destroy を呼び出してリソースを解放しましょう。