アセット

アセットパネルは、プロジェクトで利用可能なすべてのアセットを管理します。ここから、アセットの作成、アップロード、削除、検査、編集などが行えます。

フォルダーの階層

フォルダーパネルを使用すると、アセットをフォルダのツリー形式で整理することができます。

新しいフォルダーを作成するには、Add Asset (+) ボタンをクリック、 'Folder' を選択します。または、新しいフォルダを作成したいフォルダを右クリックし、 'New Asset' > 'Folder' を選択します。

フォルダーの名前を変更するには、ヒエラルキーパネルでそれをダブルクリックして、InspectorのName フィールドを編集します。

フォルダーを削除するには、でそれをダブルクリックしてdeleteを押します。また、削除したいフォルダを右クリックして、コンテキストメニューからDeleteを選択します。

フォルダの構成を整理するにはフォルダを互いの中にドラッグすることができます。

アセットの作成とアップロード

コンピューターのファイルシステムからアセットパネルにファイルをドラッグして新しいアセットを作成することができます。Editorがアセットをアップロード及びインポートします。

Add Asset (+) アイコンを使用して特定のアセットタイプを作成することもできます。

アセットを選択してDelete Assetアイコンをクリックすると、削除できます。

アセットの編集

次の特定のテキストベースのアセットはPlayCanvas Script Editorで開いて編集することができます：text, json, shader, html, css, script asset。これを行うには、アセットのサムネイルをダブルクリックします。

アセットの調査

任意のアセットの詳細を確認するには、アセットパネルのサムネイルを選択します。アセットの詳細がInspectorに表示されます。

フィルタリング

フィルタドロップダウンから表示させるアセットの種類を選択して表示されているアセットをフィルタします。

検索

検索ボックスを使用して、プロジェクト内のアセットのグローバル検索を実行することができます。ボックスに入力し始めると、Editorは一致する結果を動的にアセットパネルで表示します。

ID - 特定のアセットを固有のIDで検索することができます。検索フィールドにIDを入力するだけで正確な一致が認識され、そのIDを持つひとつのアセットが表示されます。

RegExp - 正規表現を使用して検索することもできます。検索フィールドの先頭に * を追加し、後ろにregexpクエリを入力してください。すべてのアセットを検索するには *.(任意の文字の)正規表現クエリを使用します。

Tags - タグとその組み合わせから検索するには、大括弧[ ]にタグを入力します。単純なクエリ演算子：AND, ORはクエリを文字列の配列、または文字列を持つ他の配列として表現することによって可能になります。クエリのロジックは、 AssetsRegistryのfindByTagと同じです。 いくつかの例を示します：

[ level-1 ] - level-1によってタグ付けされたすべてのアセットを返します。 [ level-1, level-2 ] - level-1 OR level-2によってタグ付けされたすべてのアセットを返します。 [ [ level-1, monster ] ] - level-1 AND monsterによってタグ付けされたすべてのアセットを返します。 角括弧の数に注意してください。 [ [ level-1, monster ], [ level-2, monster ] ] - (level-1 AND monster) OR (level-2 AND monster)によってタグ付けされたすべてのアセットを返します。

ドラッグ＆ドロップ

アセットは、メインパネルからフォルダ階層内のフォルダにドラッグして別のフォルダに移動することができます。アセットは複数選択に対応しています。CTRL+ Aで、現在選択されているフォルダ内のすべてのアセットを選択します。

アセットパネルから、Inspectorでハイライトされたスロットにアセットをドラッグすることもできます。Inspectorのスロットは、コンポーネントのアセット属性またはアセットタイプのスクリプト属性のどちらかになります。

モデル、マテリアル、キューブマップなどのアセットを直接 ビューポートにドラッグすることもできます。

• ビューポートにモデルアセットをドラッグすると、モデルアセットが割り当てられたモデルコンポーネントを有する新しいエンティティが作成されます。ビューポートのカメラは自動的に新しく作成されたエンティティにズームします。
• ビューポート内の特定のメッシュインスタンスの上にマテリアルをドラッグすると、マテリアルは(プレビューとして)ドラッグされるマテリアルに切り替えられます。マテリアルの変更を保持するには、マテリアルをドロップします。
• ビューポートでシーンの背景の上にキューブマップをドラッグすると、キューブマップはシーンのスカイボックスのキューブマップとして割り当てられます。プロパティはScene Settingsからも設定することができます。

プロジェクト間でのコピーと貼り付け

プロジェクト間でアセットまたは複数のアセットをコピーするには、アセットを選択し、右クリックしてコンテキストメニューを表示し、 'Copy' を選択します。読み取り専用のプロジェクトの場合、コンテキストメニューが使用できない場合は、代わりにホットキーCtrl/Cmd + Cを使用することもできます。

アセットをコピーしたいプロジェクトで、アセットパネルを右クリックし、 'Paste' を選択します。Ctrl/Cmd + Vのホットキーを使用することもできます。これにより、アセットがコピー先のプロジェクトに貼り付けられます。

アセットのコピーと貼り付けでは、アセットに関連する依存関係もコピーされます。例えば、モデルが2つのマテリアルを参照し、それらのマテリアルが一連のテクスチャを参照している場合、それらの依存関係もコピーされます。

別のプロジェクトにModelアセットをコピー＆ペーストする場合、そのアセットの依存関係も一緒にコピーされます。

デフォルトでは、フラットなヒエラルキーで貼り付けられます。もしフォルダ構造を維持したい場合は、コンテキストメニューが開かれたときにShiftキーを押し続けると、'Paste (keep folders)' というオプションが表示されます。これにより、貼り付け先のフォルダをルートフォルダとしてフォルダ構造を維持しようとします。

以下のように、フォルダ構造が保持された結果となります。

一般的には、再利用可能なライブラリやアセットにこの機能を使用する場合は、他のプロジェクトに簡単にコピー＆ペーストできるよう、ルートレベルのフォルダに収めることをおすすめします。これにより、プロジェクトのフォルダ構造がシンプルで整理された状態を保つことができます。

参照の確認

特定のシーン内でアセットが使用されている(または参照されている)場所を知ることが有用な場合もあります。エディターがアセットの参照を検出できない場合、サムネイルに小さい点が表示されます。

アセットに参照がある場合は、Referencesコンテンツメニュー項目を使用して参照することができます。

参照を選択するとインスペクターパネルに読み込まれます。