CocosCreator之AssetBundle使用方案分享

前言

Creator2.4 推出了AssetBundle，使得全部平台都有了分包的能力。那么该如何使用这个强大的功能呢？下面介绍一下我我的的用法，仅供参考，水平有限，非喜勿喷。
根据官方文档 指出，以前的cc.loader 须要用cc.resource替换

而cc.resource 自己就是一个Bundle

也就是说，2.4以前，整个引擎只有一个cc.loader 管理资源，2.4以后采用了多个Bundle来管理资源，只是cc.resource这个Bundle负责管理resource目录下的动态资源，已是引擎规定好的了。而自定义的Bundle实际上是与cc.resource平级的。那么只要咱们给资源管理器传入不一样的Bunlde，天然就是加载不一样Bundle中的内容了。

概念

在介绍个人用法以前，先说明如下几个概念

1. 分包 AssetBundle
   一个Bundle 就是一个分包，cc.resource 就是引擎默认的Bundle。
2. 模块 Module
   将游戏按照功能划分为不一样的模块。能够多个模块共用一个分包。也能够一个模块使用一个分包。不使用分包的模块默认使用cc.resource。这个模块类跟游戏中你定义的系统，例如，设置，大厅，战斗，背包等等并非非要一一对应的，并非有多少个系统就须要建立多少个Module.这个根据你的需求而定。可是个人资源清理都是根据不一样的Module来作的，划分的越多，清理就越细致。

import ResLoader from "../../cfw/res/ResLoader";
import AudioManager from "../../cfw/audio/AudioManager";
import ResHelper from "../../engine/ResHelper";
import { isNull } from "../../cfw/tools/Define";
export default class Module {
    private loader: ResLoader;
    protected audio: AudioManager;
    protected moduleName: string = ''
    protected projectName: string = ''
    constructor(projectName: string, moduleName: string) {
        this.projectName = projectName;
        this.moduleName = moduleName;
        //有名称的模块，须要在适当的时候加载bundle 并设置。
        if (!this.moduleName) {//name != '' 的 说明是自定义的bundle。
            this.setLoader(new ResLoader(new ResHelper(cc.resources)))
        }

    }
    setAudio() {
        if (this.loader) {
            this.audio = new AudioManager(this.projectName, this.loader)
        }
    }
    hasLoader() {
        return !isNull(this.loader)
    }
    setLoader(loader: ResLoader) {
        this.loader = loader
    }
    setLoaderByBundle(bundle: cc.AssetManager.Bundle) {
        this.setLoader(new ResLoader(new ResHelper(bundle, this.moduleName)))
    }
    getName() {
        return this.moduleName;
    }
    getLoader() {
        return this.loader;
    }
    getAudio() {
        return this.audio;
    }
}

3. 模块管理器 ModuleManager
   负责初始化模块，得到和设置模块。设置模块ID对应的Bundle名称，不使用分包的模块名称设置为空字符串。

import Module from "./Module";
import XlsxDataManager from "../../cfw/xlsx/XlsxDataManager";
import { ResType } from "../../cfw/res/ResInterface";
import ResItem from "../../cfw/res/ResItem";


//模块id
export enum ModuleID {
    PUBLIC,
    LOGIN,
    BATTLE,
    LOBBY,
    MAX
}

//有分包的模块就有bundle的名字，没有就是使用cc.resource 
let moduleName: string[] = ['', '', 'battle', '']

export default class ModuleManager {


    private static mgrMap: Module[] = []

    private static moduleID: ModuleID = ModuleID.PUBLIC;


    static dataManager: XlsxDataManager;

    static init(projectName: string) {
        for (let index = 0; index < moduleName.length; index++) {
            this.mgrMap[index] = new Module(projectName, moduleName[index]);
        }
        this.mgrMap[ModuleID.PUBLIC].setAudio()
        this.dataManager = new XlsxDataManager()
    }

    static getAudio(id: ModuleID = this.moduleID) {
        return this.mgrMap[id].getAudio()
    }

    static publicAudio() {
        return this.mgrMap[ModuleID.PUBLIC].getAudio()
    }

    static publicLoader() {
        return this.mgrMap[ModuleID.PUBLIC].getLoader()
    }


    static loadRes(url: string, type: ResType, callback: (err: string, res: ResItem) => void) {
        this.getLoader().loadRes(url, type, callback)
    }

    static getName(id: ModuleID = this.moduleID) {
        return this.mgrMap[id].getName()
    }

    static setLoaderByBundle(id: ModuleID = this.moduleID, bundle: cc.AssetManager.Bundle) {
        this.mgrMap[id].setLoaderByBundle(bundle)
    }

    static setModuleID(id: ModuleID) {
        this.moduleID = id;
    }

    static getLoader(id: ModuleID = this.moduleID) {
        return this.mgrMap[id].getLoader()
    }

    static hasLoader(id: ModuleID = this.moduleID) {
        return this.mgrMap[id].hasLoader()
    }


    /**
     * 为某个模块设置bundle
     * @param moduleID 
     * @param callback 
     */
    static loadBundle(moduleID: ModuleID, callback: Function) {
        this.publicLoader().loadRes(ModuleManager.getName(moduleID),
         ResType.AssetBundle, (err, item: ResItem) => {
            if (err) {
                return;
            }
            ModuleManager.setLoaderByBundle(moduleID, item.getRes())
            callback();
        })
    }

}

4. 资源管理器 ResLoader
   负责加载资源
   

5. 资源项： ResItem 负责管理资源的引用计数
   

6. ResHelper
   为了跨引擎使用ResLoader,我自定义了ResType枚举、ResInterface 接口和这个Creator加载辅助类ResHelper，若是不涉及到跨引擎的话，能够去掉这几个东西，而后直接把AssetBundle传到ResLoader中使用。
   

使用

1. 将一个模块的资源放入一个目录中，将这个目录设置为Bundle
   
2. 在ModuleManger中设置bundle的名字
   
3. 点击进入时或者在loading的时候设置对应模块的Bundle
   
4. 进入模块以前设置为此模块对应的模块ID,那么此时得到的ResLoader 天然就是battle模块的ResLoader了,而且ResLoader使用的Bundle 是名称为 battle 的Bunlde。
   
5. 清理资源，这里须要指定模块ID。因为引擎作了资源引用计数的事情，因此咱们不用再去管理依赖关系，省了不少事情。
   

注意事项

1. 若是是resource中的资源做为bundle以后，须要从resource中拿到外边。
   

2. 发布小游戏时压缩类型设置为小游戏子包，官方文档已说明
   

资源管理的一些问题

看到论坛对于2.4的引用计数问题讨论的很是激烈。
https://forum.cocos.org/t/2-4-0/95076/32
我作的资源管理器有以下规则

1. 全部资源必须经过资源项ResItem的getRes接口得到，保证使用一次计数增长一次，不参与引擎提供的计数管理。因为引擎本身管理的依赖关系，因此2.4以后再也不须要维护资源的依赖关系。只维护好本身的使用次数就好。
   
   

2. ResLoader 提供删除某个资源的功能，应对ui清理需求。若是删除整个模块，调用release 接口便可。
   

3. ResLoader 支持直接缓存一个挂载到场景中的资源，好比初始场景会直接挂载一个预制体，避免黑屏。若是不想清理场景只想清理这个预制体就能够这样使用。
   
   
   

4. 实际应用可能复杂的多，每一个人的用法不一样，不保证没有问题。

结语

1. 以上各类方案仅是我我的的使用方式，并不是最佳方案，可能会有bug，仅供你们参考，谁有更好的方式，也分享出来，互相学习。

2. demo 在个人框架项目中，已经更新到2.4。因为以前忽略文件的缘由，请使用空文件夹从新clone。

欢迎扫码关注公众号《微笑游戏》，浏览更多内容。

欢迎扫码关注公众号《微笑游戏》，浏览更多内容。