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

アセット

アセットは、PlayCanvas アプリケーションの構成要素です。3D モデル、テクスチャ、オーディオファイル、スクリプトなど、アプリケーションに必要なすべての外部リソースを表します。

アセットとリソースの違い​

PlayCanvas では、アセットとリソースには重要な違いがあります。

  • アセット - アセットレジストリ内のレコードで、リソースに関するメタデータ（名前、タイプ、タグ、基になるリソースデータへの参照など）を含みます。アセットは AssetRegistry によって管理されます。

  • リソース - メモリに読み込まれ、エンジンによって使用される実際のランタイムデータです。たとえば、テクスチャアセットのリソースは、マテリアルに適用できる実際の画像データです。

アセットを読み込むと、PlayCanvas は基になるファイルをダウンロードして解析し、リソースを作成します。アセットオブジェクトは、resource プロパティを通じてこのリソースへの参照を保持します。

const asset = this.app.assets.find('my-texture');
asset.ready((asset) => {
    const texture = asset.resource; // 実際の Texture オブジェクト
});
this.app.assets.load(asset);

アセットのライフサイクル​

アセットは、アプリケーションの実行中にいくつかの段階を経ます。

  1. レジストリ - アセットは AssetRegistry に登録され、ID、名前、またはタグで検索可能になります
  2. 読み込み - アセットデータがサーバーからダウンロードされます
  3. 準備完了 - リソースが解析され、使用可能になります
  4. アンロード - メモリを解放するためにリソースをアンロードできます

アセットの読み込みタイミングを制御する方法については、プリロード と 読み込みとアンロード を参照してください。

サポートされているフォーマット​

PlayCanvas は、さまざまなアセットタイプに対して多様なファイルフォーマットをサポートしています。完全なリストについては、サポートされているフォーマット を参照してください。

アセットの操作​

エディタでの操作​

PlayCanvas エディタを使用している場合は、エディタアセットガイド で以下の情報を確認してください。

  • アセットのインポートと整理
  • アセットプロパティの設定
  • アセットストアの使用

プログラムでの操作​

コードでアセットを操作する場合：

アセットの入手先​

プロジェクト用の 3D モデル、テクスチャ、オーディオをお探しですか？アセットマーケットプレイスやリソースのリストについては、アセットの入手先 を参照してください。