Cocos Creator 获取和加载资源(摘自官方文档)
来源:互联网 发布:win7添加打印机usb端口 编辑:程序博客网 时间:2024/05/25 18:09
获取和加载资源
Cocos Creator 有一套统一的资源管理机制 ,在本篇教程,我们将介绍
- 资源的分类
- 如何在 属性检查器 里设置资源
- 动态加载 Asset
- 动态加载 Raw Asset
资源的分类
目前的资源分成两种,一种叫做 Asset,一种叫做 Raw Asset。
Asset
Creator 提供了名为 "Asset" 的资源类型,cc.SpriteFrame
, cc.AnimationClip
, cc.Prefab
等资源都属于 Asset。Asset 的加载是统一并且自动化的,相互依赖的 Asset 能够被自动预加载。
例如,当引擎在加载场景时,会先自动加载场景关联到的资源,这些资源如果再关联其它资源,其它也会被先被加载,等加载全部完成后,场景加载才会结束。
因此只要你拿到了一个 Asset 对象,这个对象一定是已经加载结束的,可以直接通过对象上的属性访问到资源的所有数据。当你要在引擎中使用这些资源,引擎的 API 接收的都必须是一个加载好的 Asset 对象。
脚本中可以这样定义一个 Asset 属性:
// NewScript.jscc.Class({ extends: cc.Component, properties: { spriteFrame: { default: null, type: cc.SpriteFrame }, }});
Raw Asset
为了兼容 Cocos2d 的一些既有 API,我们把保留原始资源文件扩展名资源叫做 "Raw Asset"。图片(cc.Texture2D
),声音(cc.AudioClip
),粒子(cc.ParticleAsset
)等资源都是 Raw Asset。Raw Asset 在脚本里由一个 url 字符串来表示,当你要在引擎中使用 Raw Asset,只要把 url 传给引擎的 API,引擎内部会自动加载这个 url 对应的资源。
当你在脚本里声明一个类型是 cc.Texture2D
的 Raw Asset,一开始可能会想这样定义:
cc.Class({ extends: cc.Component, properties: { textureURL: { default: null, type: cc.Texture2D } }});
这样写的问题在于,在代码中 textureURL
实际上是一个字符串,而不是 cc.Texture2D
的实例。为了不混淆 type 的语义,在 CCClass 中声明 Raw Asset 的属性时,要用 url: cc.Texture2D
而不是 type: cc.Texture2D
。
cc.Class({ extends: cc.Component, properties: { textureURL: { default: "", url: cc.Texture2D } }});
如何在属性检查器里设置资源
不论是 Asset 还是 Raw Asset,只要在脚本中定义好类型,就能直接在 属性检查器 很方便地设置资源。假设我们有这样一个组件:
// NewScript.jscc.Class({ extends: cc.Component, properties: { textureURL: { default: "", url: cc.Texture2D }, spriteFrame: { default: null, type: cc.SpriteFrame }, }});
将它添加到场景后,属性检查器 里是这样的:
接下来我们从 资源管理器 里面分别将一张贴图和一个 SpriteFrame 拖到 属性检查器 的对应属性中:
结果如下:
这样就能在脚本里直接拿到设置好的资源:
onLoad: function () { var spriteFrame = this.spriteFrame; var textureURL = this.textureURL; spriteFrame.setTexture(textureURL); }
在 属性检查器 里设置资源虽然很直观,但资源只能在场景里预先设好,没办法动态切换。如果需要动态切换,你需要看看下面的内容。
动态加载
所有需要通过脚本动态加载的资源,都必须放置在 resources
文件夹或它的子文件夹下。resources
需要在 assets 文件夹中手工创建,并且必须位于 assets 的根目录,就像这样:
这里的 image/image
, prefab
, anim
, font
都是常见的 Asset,而 image, audio 则是常见的 Raw Asset。
resources
文件夹里面的资源,可以关联依赖到文件夹外部的其它资源,同样也可以被外部场景或资源引用到。项目构建时,除了已在 构建发布 面板勾选的场景外,resources
文件夹里面的所有资源,连同它们关联依赖的resources
文件夹外部的资源,都会被导出。所以如果一份资源不需要由脚本直接动态加载,那么不用放在resources
文件夹里。
动态加载 Asset
Creator 提供了 cc.loader.loadRes
这个 API 来专门加载那些位于 resources 目录下的 Asset。和 cc.loader.load
不同的是,loadRes 一次只能加载单个 Asset。调用时,你只要传入相对 resources 的路径即可,并且路径的结尾处不能包含文件扩展名。
// 加载 Prefabcc.loader.loadRes("test assets/prefab", function (err, prefab) { var newNode = cc.instantiate(prefab); cc.director.getScene().addChild(newNode);});// 加载 AnimationClipcc.loader.loadRes("test assets/anim", function (err, clip) { myNode.getComponent(cc.Animation).addClip(clip, "anim");});// 加载 SpriteAtlas(图集),并且获取其中的一个 SpriteFrame// 注意 atlas 资源文件(plist)通常会和一个同名的图片文件(png)放在一个目录下, 所以需要在第二个参数指定资源类型cc.loader.loadRes("test assets/sheep", cc.SpriteAtlas, function (err, atlas) { var frame = atlas.getSpriteFrame('sheep_down_0'); sprite.spriteFrame = frame;});
加载独立的 SpriteFrame
图片设置为 Sprite 后,将会在资源管理器中生成一个对应的 SpriteFrame。但如果直接加载 test assets/image
,得到的类型将会是 cc.Texture2D。你必须指定第二个参数为资源的类型,才能加载到图片生成的 cc.SpriteFrame:
// 加载 SpriteFramecc.loader.loadRes("test assets/image", cc.SpriteFrame, function (err, spriteFrame) { myNode.getComponent(cc.Sprite).spriteFrame = spriteFrame;});
如果指定了类型参数,就会在路径下查找指定类型的资源。当你在同一个路径下同时包含了多个重名资源(例如同时包含 player.clip 和 player.psd),或者需要获取“子资源”(例如获取 Texture2D 生成的 SpriteFrame),就需要声明类型。
资源释放
loadRes
加载进来的单个资源如果需要释放,可以调用 cc.loader.releaseRes
,releaseRes
只能传入一个和 loadRes
相同的路径,不支持类型参数。
cc.loader.releaseRes("test assets/anim");
此外,你也可以使用 cc.loader.releaseAsset
来释放一个具体的 Asset 实例。
cc.loader.releaseAsset(spriteFrame);
动态加载 Raw Asset
Raw Asset 可以直接使用 url 从远程服务器上加载,也可以从项目中动态加载。对远程加载而言,原先 Cocos2d 的加载方式不变,使用 cc.loader.load 即可。对项目里的 Raw Asset,加载方式和 Asset 一样:
// 加载 Texture,不需要后缀名cc.loader.loadRes("test assets/image", function (err, texture) { ...});
cc.url.raw
Raw Asset 加载成功后,如果需要传给一些 url 形式的 API,还是需要给出完整路径才行。你需要用 cc.url.raw
进行一次 url 的转换:
// 原 url 会报错!文件找不到var texture = cc.textureCache.addImage("resources/test assets/image.png");// 用 cc.url.raw,此时需要声明 resources 目录和文件后缀名var realUrl = cc.url.raw("resources/test assets/image.png");var texture = cc.textureCache.addImage(realUrl);
资源批量加载
cc.loader.loadResAll
可以加载相同路径下的多个资源:
// 加载 test assets 目录下所有资源cc.loader.loadResAll("test assets", function (err, assets) { // ...});// 加载 sheep.plist 图集中的所有 SpriteFramecc.loader.loadResAll("test assets/sheep", cc.SpriteFrame, function (err, assets) { // assets 是一个 SpriteFrame 数组,已经包含了图集中的所有 SpriteFrame。 // 而 loadRes('test assets/sheep', cc.SpriteAtlas, function (err, atlas) {...}) 获得的则是整个 SpriteAtlas 对象。});
- Cocos Creator 获取和加载资源(摘自官方文档)
- Cocos Creator中获取和加载资源(官方文档摘录)
- Cocos Creator 加载和切换场景(摘自官方文档)
- Cocos Creator 创建和销毁节点(摘自官方文档)
- Cocos Creator 访问节点和组件(摘自官方文档)
- Cocos Creator 常用节点和组件接口(摘自官方文档)
- Cocos Creator 监听和发射事件(摘自官方文档)
- Cocos Creator 动作列表(摘自官方文档)
- Cocos Creator 使用计时器(摘自官方文档)
- Cocos Creator 网络接口(摘自官方文档)
- Cocos Creator 模块化脚本(摘自官方文档)
- Cocos Creator 插件脚本(摘自官方文档)
- Cocos Creator 加载和切换场景(官方文档摘录)
- Cocos Creator 使用 cc.Class 声明类型(摘自官方文档)
- Cocos Creator 生命周期回调(摘自官方文档)
- Cocos Creator 系统内置事件(摘自官方文档)
- Cocos Creator 玩家输入事件(摘自官方文档)
- Cocos Creator 中使用动作系统(摘自官方文档)
- Android中使用系统自带浏览器打开本地assets目录下的html文件
- plsql中暂停变量的使用,否则如果sql中出现一些 < >时无法插入
- min queue
- jdk动态代理
- mysql中将数据导入csv文件以及将csv文件导入mysql
- Cocos Creator 获取和加载资源(摘自官方文档)
- 输入一个链表,从尾到头打印链表每个节点的值。
- css不换行相关易混属性
- [IOS]Xcode 7 App Transport Security has blocked a cleartext HTTP 报错解决办法
- 单据自动转换并审核的方法示例
- Cocos Creator 模块化脚本(摘自官方文档)
- 常用正则表达式
- sed提取模式内容
- 压缩感知稀疏基之离散余弦变换(DCT)和离散正弦变换(DST)