シーンの操作
シーンは、レベルやメニューなど、アプリが表示する1つの世界です。1つのプロジェクトに複数のシーンを持てます。各シーンには次のものが入っています。
- エンティティ: シーン内のオブジェクトで、階層構造で並んでいます。キャラクター、小道具、ライト、カメラ、空のグループなどになります。
- コンポーネント: 各エンティティに機能を与えるものです。モデルの描画、シーンの照明、衝突、サウンドの再生、スクリプトの実行などがあります。
- シーン設定: スカイボックス、環境光、フォグ、物理演算の重力など、シーン全体のプロパティです。ツールバーの歯車から開きます。レンダリング設定と物理設定を参照してください。
エンティティとコンポーネントが初めての方は、エンティティ・コンポーネント・システムでしくみを、Editorプロジェクトのしくみでプロジェクトの中でのシーンの位置づけを確認してください。
このセクションの内容
| ページ | 内容 |
|---|---|
| シーンの管理 | プロジェクト内のシーンを作成、開く、複製、削除します。 |
| ヒエラルキーパネル | エンティティを作成、検索、親子付け替え、複製、コピーします。 |
| ビューポート | シーン内を移動し、ギズモでエンティティをトランスフォームし、カメラと描画モードを切り替えます。 |
| インスペクターパネル | 選択したエンティティのコンポーネントとプロパティを編集します。 |
| コンポーネント | すべてのコンポーネントの種類と、Inspectorに表示されるプロパティ。 |
| テンプレート | エンティティの階層を再利用できるアセットとして保存し、何度でも配置して一度に更新します。Nested TemplatesとOverride Diff Viewも含みます。 |
アプリの実行中にシーンを読み込むには、スクリプトのシーンの読み込みを参照してください。
シーンのサイズ上限
PlayCanvasのサーバーは各シーンを1つのドキュメントとして保存しており、このドキュメントは16MBを超えられません。シーンがこの上限を超えることになる変更は保存されないため、シーンは上限より十分に小さく保ってください。
シーンに保存されるものはすべて上限に含まれます。
- エンティティ - すべてのエンティティと、そのすべてのコンポーネントおよびプロパティ値です。
- スクリプト属性 - 各スクリプトに設定された値で、JSON(JavaScript Object Notation)属性や配列も含みます。
- テンプレートのインスタンス - 各インスタンスは、エンティティ階層の完全なコピーをシーン内に保存します。テンプレートを100回配置すると、その階層が100回保存されます。
- シーン設定 - ごくわずかな容量しか使いません。
アセットは含まれません。モデル、テクスチャ、オーディオ、スクリプトなどのアセットは別に保存され、シーンはIDでそれらを参照するだけです。インポートしたモデルは、階層に追加するまでシーンのサイズを増やしません。追加するとモデルの各ノードがエンティティになり、それらのエンティティは上限に含まれます。
サイズの警告
JSONとして14MBを超えるデータを持つシーンを開くと、Editorに「You are close to your scene size limit.」という赤いバナーが表示されます。保存されるサイズはJSONのサイズと完全には一致しないため、余裕を持たせて早めに警告が表示されます。警告が出たら、シーンを小さくし始める合図と考えてください。
Editorがサイズを確認するのは、シーンを読み込むときだけです。シーンを小さくしたら、Editorを再読み込みして確認し直してください。また、エディターAPIを使い、ブラウザーの開発者コンソールで次のコードを実行すると、現在のシーンのサイズをいつでも測定できます。
JSON.stringify(editor.api.globals.realtime.scenes.current.data).length;
結果は文字数です。この値が14,680,064(14 × 1024 × 1024)を超えると警告が表示されます。
上限内に収める方法
- 複数のシーンに分割する - レベル、エリア、メニューごとにシーンを分けます。実行時にシーンを切り替えるか、複数のシーンを加算的に読み込んで大きなワールドを構成します。シーンの読み込みを参照してください。
- 実行時にテンプレートをインスタンス化する - Editorで配置したテンプレートのインスタンスはシーンに保存されますが、スクリプトから生成するテンプレートはアセットに1回だけ保存されます。敵、アイテム、小道具など何度も登場するオブジェクトは、コードから生成します。実行時にインスタンス化を参照してください。
- 実行時にデータを読み込む - レベルのレイアウト、会話、設定テーブルなどの大きなデータは、スクリプト属性ではなくJSONアセットに保存し、アプリケーションで必要になったときに読み込みます。読み込みとアンロードを参照してください。
- 不要なものを削除する - テスト用のオブジェクトや、インポートしたモデルの使わないノードなど、不要なエンティティを削除します。
シーン内の反復的な変更には、AIアシスタントとEditor MCP Serverで対象のエンティティとコンポーネントを特定し、一括編集を準備します。対象を確認し、ViewportとLauncherのキャプチャで不整合を探します。