Skip to content

Latest commit

 

History

History
133 lines (92 loc) · 4.97 KB

asset-management.md

File metadata and controls

133 lines (92 loc) · 4.97 KB

Manage project assets

Manage the scene

New scene

you can use the Editor.Ipc module to create the new scene:

Editor.Ipc.sendToPanel('scene', 'scene:new-scene');

Save the current scene

After modifying the scene data, you can use the Editor.Ipc module to save the current scene:

Editor.Ipc.sendToPanel('scene', 'scene:stash-and-save');

Load other scenes

Our expansion packs may need to traverse multiple scenes and operate and save them sequentially. In the previous section Call the engine API and project script, we introduced the method of accessing the engine API and the user project script through the scenario script. To load a new scene, use:

_Scene.loadSceneByUuid (uuid, function (error) {
    // do more work
});

Where _Scene is a special singleton that controls the scene instance loaded in the scene editor.
The incoming parameter is the uuid of the scene asset, which can be obtained by the asset manager interface described below.

Mapping of asset URL and UUID

In the Cocos Creator editor and extension, the url of the asset is shaped

Db: // assets / path / to / scene.fire

Such a form. Where db is an abbreviation for AssetDB. All assets under the asset path in the project are imported into Asset Library and can be referenced by uuid.

In the main process of the expansion package between the url and uuid can be transformed from each other:

  • Editor.assetdb.urlToUuid (url)
  • Editor.assetdb.uuidToUrl (uuid)

In addition, if you want to use the absolute path of the asset directly in the local file system, you can also use the fspathToUuid and uuidToFspath interfaces, where fspath represents the absolute path.

Manage assets

Import assets

To import new assets into a project, you can use the following interfaces

// main process
Editor.assetdb.import (['/ user / user / foo.js', '/User/user/bar.js'], 'db: // assets / foobar', function (err, results) {
    Results.forEach (function (result) {
    // result.uuid
    // result.parentUuid
    // result.url
    // result.path
    // result.type
    });
});

// renderer process
Editor.assetdb.import ([
    '/file/to/import/01.png',
    '/file/to/import/02.png',
    '/file/to/import/03.png',
], 'Db: // assets / foobar', callback);

Create an asset

A common misuse of using extended package management assets is to use the fs module of the Node.js when the extension package needs to create new assets, so that even if the creation of the file to the assets directory, it can not be automatically imported by the Assets. The correct workflow should use the create interface to create the asset.

// main process or renderer process
Editor.assetdb.create ('db: //assets/foo/bar.js', data, function (err, results) {
    Results.forEach (function (result) {
    // result.uuid
    // result.parentUuid
    // result.url
    // result.path
    // result.type
    });
});

The incoming data is the string of the contents of the asset file. In the creation is completed automatically after the import operation of the asset, the callback can be successful in the asset manager to see the assets.

Save existing assets

To replace the original asset using the new data, you can use the following interface

// main process or renderer process
Editor.assetdb.saveExists ('db: //assets/foo/bar.js', data, function (err, meta) {
    // do something
});

If you want to check whether the asset exists before saving, you can use it

// main process
Editor.assetdb.exists (url); // return true or false

In the rendering process, if given a target url, if the url points to the assets do not exist to create, the existence of assets to save the new data, you can use

// renderer process
Editor.assetdb.createOrSave ('db: //assets/foo/bar/foobar.js', data, callback);

Refresh the asset

When the asset file has been modified in the asset and there is no reintroduction for some reason, the asset data in the asset and the asset data displayed in the database are inconsistent (if the fs module direct operation of the contents of the file will appear), you can manually call the asset refresh interface to re-import assets

// main process or renderer process
Editor.assetdb.refresh ('db: // assets / foo / bar /', function (err, results) {});

Move and delete assets

As the assets will be generated after the import of the corresponding meta file, so separate delete and move the asset file itself will result in data consistency in the database damage, it is recommended to use a dedicated AssetDB interface to complete these tasks

Editor.assetdb.move (srcUrl, destUrl);
Editor.assetdb.delete ([url1, url2]);

For more information about these interfaces, please refer to AssetDB API Main and AssetDB API Renderer.