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

Editorプロジェクトのしくみ

PlayCanvas Editorのプロジェクトには、1つのアプリを構成するものがすべて入っています。シーン、シーンが使うアセット、スクリプト、そして設定です。このページでは、これらがどう組み合わさっているかを説明します。これを押さえておくと、このマニュアルの他のページが理解しやすくなります。まだの場合は、先に初めてのアプリを作ってみてください。ここで説明するすべての要素に、15分ほどで一通り触れられます。

シーン、エンティティ、コンポーネント​

シーンは、レベルやメニューなど、アプリが表示する1つの世界です。1つのプロジェクトに複数のシーンを持つことができます。アプリは1つのシーンから始まり、実行中に別のシーンを読み込むこともできます。シーンの作成や切り替えはシーンの管理から行います。

シーンはエンティティの階層でできていて、Hierarchyパネルに表示されます。エンティティ単体では、位置、回転、スケールしか持ちません。エンティティに機能を与えるのがコンポーネントです。Renderコンポーネントは形状やモデルを描画し、Lightはシーンを照らし、CollisionとRigid Bodyのコンポーネントはエンティティを物理シミュレーションに参加させ、Scriptコンポーネントはあなたのコードを実行します。エンティティを選択すると、そのコンポーネントをInspectorで編集できます。このしくみについてはエンティティ・コンポーネント・システムで詳しく説明しています。

シーンには、スカイボックス、環境光、物理演算の重力など、シーン固有の設定もあります。

アセット​

アセットは、シーンが使うファイルやデータです。モデル、マテリアル、テクスチャ、オーディオ、フォント、スクリプトなどがあります。アセットは1つのシーンではなくプロジェクトに属しているので、どのシーンからも使うことができ、Assetsパネルで管理します。エンティティがアセットを使うのは、Renderコンポーネントのマテリアルのように、そのコンポーネントがアセットを参照しているときです。

ファイルをアップロードすると、Editorのインポートパイプラインが元のファイルをソースアセットとして保持し、アプリが読み込むターゲットアセットを作成します。たとえば3Dモデルをアップロードすると、モデルの階層を持つテンプレート、メッシュごとのRenderアセット、そしてマテリアルとテクスチャが作成されます。モデルを更新するときは同じファイルをもう一度アップロードすると、そこから作られたアセットがすべて更新されます。

テンプレートもアセットの一種です。テンプレートはプレハブのように保存したエンティティの階層で、何度でも配置でき、あとから全部を一度に変更できます。

スクリプト​

スクリプトはJavaScriptのアセットです。エンティティに動きを与えるには、Scriptコンポーネントを追加してスクリプトをアタッチします。スクリプト属性を使うと値がInspectorに表示されるので、コードを編集せずにスクリプトを調整できます。スクリプトは組み込みのコードエディターで書くことも、PlayCanvas拡張機能を入れたVisual Studio Codeで書くこともできます。

スクリプトはPlayCanvas Engineを直接扱うので、スクリプティングの内容はすべてスクリプトに当てはまります。

何が保存され、誰に見えるか​

シーンには保存ボタンがありません。エンティティ、コンポーネント、アセット、設定への変更は、変更したその場で保存され、同じブランチで作業している他の人にもすぐに表示されます。リアルタイムコラボレーションを参照してください。

  • スクリプトは例外です。 コードエディターでの変更は、Ctrl+S(macOS では Cmd+S)でファイルを保存したときに保存されます。起動したときに実行されるのは、保存済みのコードだけです。
  • 元に戻せるのは自分の変更です。 Ctrl+Z(macOS では Cmd+Z)で戻れるのは自分の変更だけで、他の人の変更は戻りません。
  • ほとんどの設定は共有されます。 プロジェクト設定はブランチ上の全員に適用されますが、Editorのカメラやギズモの好みのように、自分だけに適用されるものもいくつかあります。どれがどちらかはプロジェクト設定で説明しています。

プロジェクトはユーザーか組織が所有し、誰が閲覧・編集できるかはプロジェクトのチームで決まります。

起動ページでテストする​

Viewport右上のLaunchを選択すると、現在のシーンが新しいブラウザタブで実行されます。起動ページはEditorとつながったままなので、エンティティ、コンポーネント、マテリアル、設定への変更は、変更したその場で実行中のアプリに反映されます。新しいアセットやスクリプトの変更を反映するには、ページを再読み込みします。ただし、ホットリロードに対応したスクリプトは再読み込みなしで反映されます。

同じページをPlayCanvasアカウントにログインしたスマートフォンやタブレットで開けば、実機でテストできます。

ブランチとチェックポイント​

どのプロジェクトもmainブランチから始まり、上の図にあるものはすべてブランチの中にあります。チェックポイントは、あとで戻れるプロジェクトのスナップショットです。ブランチは独立した作業の流れで、mainブランチに影響を与えずに何かを試し、準備ができたらマージして戻せます。バージョン管理を参照してください。

ビルド​

アプリを公開できる状態になったら、ビルドを公開します。ビルドは選んだシーンのスナップショットで、単独で動くようにパッケージされます。playcanvas.comでホストして誰にでも送れるリンクで公開することも、ダウンロードして自分でホストすることもできます。公開後に加えた変更は、新しいビルドを公開するまでビルドには反映されません。

EditorとEngine​

EditorはPlayCanvas Engineの上に作られています。Viewportはシーンをこのエンジンで描画し、起動したアプリや公開したアプリもこのエンジンで動きます。そのため、グラフィックス、物理演算、アニメーションなど、このマニュアルの共通トピックはEditorのプロジェクトにも当てはまります。多くのページには、Editorでの手順を示すEditorタブがあります。起動と公開に使うEngineのバージョンはEngine設定で選べます。

次のステップ​