【cocos2d-js官方文档】十四、cc.spriteFrameCache 改造说明

安稳与你 提交于 2019-12-05 15:01:59

统一引擎内部创建SpriteFrame的数据结构

将Plist的解析工作转移到了cc._plistLoader中去,对SAXParser进行了改造。

统一了引擎创建SpriteFrame的数据结构:

  1.  
    {
  2.  
    _inited : true,
  3.  
    frames : {
  4.  
    "a_frame_0.png" : {
  5.  
    rect : {x : 0, y : 0, width : 1, height : 1},
  6.  
    rotated : false,
  7.  
    offset : {x : 0, y : 0},
  8.  
    size : {width : 1, height : 1}
  9.  
    aliases : ["a_f_0"]
  10.  
    }
  11.  
    },
  12.  
    meta : {
  13.  
    image : "a.png"
  14.  
    }
  15.  
    }

引擎在创建SpriteFrame的时候,读取了plist配置文件的信息后,会将其转换为以上的数据格式。

自定义SpriteFrame的配置文件

采用cc.loader的插件机制,我们可以很轻松的自定义自己的配置文件格式。SpriteFrame的各种格式的配置文件,只要转换成对应格式就行了。

例如,我们自定义了一个文件,用于存储原本配置在多个plist(res/ui/tcc_issue_1.plist, res/ui/tcc_issue_2.plist)的SpriteFrame的打包信息, 名为res/ui/imgs.pkgJson(plist的内容就不贴了):

  1.  
    {
  2.  
    "tcc_issue_1.plist" : {
  3.  
    "frames" : {
  4.  
    "grossini_dance_01.png" : {
  5.  
    "rect" : [2, 79, 51, 109],
  6.  
    "offset" : [0, -1],
  7.  
    "size" : [85, 121],
  8.  
    "rotated" : true
  9.  
    },
  10.  
    "grossini_dance_05.png" : {
  11.  
    "rect" : [2, 2, 75, 109],
  12.  
    "offset" : [-1, -1],
  13.  
    "size" : [85, 121],
  14.  
    "rotated" : true
  15.  
    },
  16.  
    "grossini_dance_08.png" : {
  17.  
    "rect" : [2, 79, 51,109],
  18.  
    "offset" : [0, -1],
  19.  
    "size" : [85, 121]
  20.  
    }
  21.  
    }
  22.  
    },
  23.  
    "tcc_issue_2.plist" : {
  24.  
    "frames" : {
  25.  
    "grossini_dance_13.png" : {
  26.  
    "rect" : [2, 52, 51, 109],
  27.  
    "offset" : [0, -1],
  28.  
    "size" : [85, 121],
  29.  
    "rotated" : true
  30.  
    },
  31.  
    "grossinis_sister1.png" : {
  32.  
    "rect" : [2, 2, 48, 113],
  33.  
    "offset" : [-1, -11],
  34.  
    "size" : [52, 139],
  35.  
    "rotated" : true
  36.  
    },
  37.  
    "grossinis_sister2.png" : {
  38.  
    "rect" : [2, 105, 54, 126],
  39.  
    "offset" : [-1, -2],
  40.  
    "size" : [56, 138]
  41.  
    }
  42.  
    }
  43.  
    }
  44.  
    }

(由于meta.image为对应plist文件名改后缀名为png,故可以不配置meta属性。)

接着我们可以自定义一个loader插件用于加载、解析pkgJson,loader插件代码如下:

  1.  
     
  2.  
    /**
  3.  
    * This is a loader to merge plist files to one file.
  4.  
    */
  5.  
    cc._pkgJsonLoader = {
  6.  
    /**
  7.  
    * @constant
  8.  
    */
  9.  
    KEY : {
  10.  
    frames : "frames",
  11.  
    rect : "rect", size : "size", offset : "offset", rotated : "rotated", aliases : "aliases",
  12.  
     
  13.  
    meta : "meta",
  14.  
    image : "image"
  15.  
    },
  16.  
    /**
  17.  
    * @constant
  18.  
    */
  19.  
    MIN_KEY : {
  20.  
    frames : 0,
  21.  
    rect : 0, size : 1, offset : 2, rotated : 3, aliases : 4,
  22.  
     
  23.  
    meta : 1,
  24.  
    image : 0
  25.  
    },
  26.  
    _parse : function(data){
  27.  
    var KEY = data instanceof Array ? this.MIN_KEY : this.KEY;
  28.  
    var frames = {}, meta = data[KEY.meta] ? {image : data[KEY.meta][KEY.image]} : {};
  29.  
    var tempFrames = data[KEY.frames];
  30.  
    for (var frameName in tempFrames) {
  31.  
    var f = tempFrames[frameName];
  32.  
    var rect = f[KEY.rect];
  33.  
    var size = f[KEY.size];
  34.  
    var offset = f[KEY.offset];
  35.  
    frames[frameName] = {
  36.  
    rect : {x : rect[0], y : rect[1], width : rect[2], height : rect[3]},
  37.  
    size : {width : size[0], height : size[1]},
  38.  
    offset : {x : offset[0], y : offset[1]},
  39.  
    rotated : f[KEY.rotated],
  40.  
    aliases : f[KEY.aliases]
  41.  
    }
  42.  
    }
  43.  
    return {_inited : true, frames : frames, meta : meta};
  44.  
    },
  45.  
    load : function(realUrl, url, res, cb){
  46.  
    var self = this, locLoader = cc.loader, cache = locLoader.cache;
  47.  
    locLoader.loadJson(realUrl, function(err, pkg){
  48.  
    if(err) return cb(err);
  49.  
    var dir = cc.path.dirname(url);
  50.  
    for (var key in pkg) {
  51.  
    var filePath = cc.path.join(dir, key);
  52.  
    cache[filePath] = self._parse(pkg[key]);
  53.  
    }
  54.  
    cb(null, true);
  55.  
    });
  56.  
    }
  57.  
    };
  58.  
    cc.loader.register(["pkgJson"], cc._pkgJsonLoader);

pkgJson其实就是一个json文件,那为什么不直接叫做json呢?因为每个loader插件是根据后缀名进行处理的, 如果也叫json那就会使用cc._jsonLoader进行加载了。

还可以支持混淆压缩模式:

  1.  
    {
  2.  
    "tcc_issue_1.plist":[{
  3.  
    "grossini_dance_01.png":[[2, 79, 51, 109],[85, 121],[0, -1],1],
  4.  
    "grossini_dance_05.png":[[2, 2, 75, 109],[85, 121],[-1, -1],1],
  5.  
    "grossini_dance_08.png":[[2, 79, 51,109],[85, 121],[0, -1]]
  6.  
    }],
  7.  
    "tcc_issue_2.plist":[{
  8.  
    "grossini_dance_13.png":[[2, 52, 51, 109],[85, 121],[0, -1],1],
  9.  
    "grossinis_sister1.png":[[2, 2, 48, 113],[52, 139],[-1, -11],1],
  10.  
    "grossinis_sister2.png":[[2, 105, 54, 126],[56, 138],[-1, -2]]
  11.  
    }]
  12.  
    }

这个混淆压缩模式有什么用呢?

1、减少配置文件的大小;

2、将多个配置文件整理合并到一个,减少网络连接请求数量。

用这种方式可以很好的解决plist文件在H5上带来的各种问题,同时可以让开发者在开发的时候用plist进行开发,在发布的时候使用pkgJson进行发布, 却不需要改动项目代码,只需要把资源加载列表中的plsit替换成对于的pkgJson就可以了。

但是目前,jsb尚无法支持自定义资源加载器插件,该功能只能在HTML5上使用。

转载请注明:https://blog.csdn.net/qinning199/article/details/41924747

 
易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!