NodePool 类型

模块: cc

cc.NodePool 是用于管理节点对象的对象缓存池。
它可以帮助您提高游戏性能,适用于优化对象的反复创建和销毁
以前 cocos2d-x 中的 cc.pool 和新的节点事件注册系统不兼容,因此请使用 cc.NodePool 来代替。

新的 NodePool 需要实例化之后才能使用,每种不同的节点对象池需要一个不同的对象池实例,这里的种类对应于游戏中的节点设计,一个 prefab 相当于一个种类的节点。
在创建缓冲池时,可以传入一个包含 unuse, reuse 函数的组件类型用于节点的回收和复用逻辑。

一些常见的用例是:
1.在游戏中的子弹(死亡很快,频繁创建,对其他对象无副作用)
2.糖果粉碎传奇中的木块(频繁创建)。 等等....

索引

属性(properties)
  • poolHandlerComp Function|String 缓冲池处理组件,用于节点的回收和复用逻辑,这个属性可以是组件类名或组件的构造函数。
方法
  • constructor 使用构造函数来创建一个节点专用的对象池,您可以传递一个组件类型或名称,用于处理节点回收和复用时的事件逻辑。
  • size 获取当前缓冲池的可用对象数量
  • clear 销毁对象池中缓存的所有节点
  • put 向缓冲池中存入一个不再需要的节点对象。
  • get 获取对象池中的对象,如果对象池没有可用对象,则返回空。

Details

属性(properties)

poolHandlerComp

缓冲池处理组件,用于节点的回收和复用逻辑,这个属性可以是组件类名或组件的构造函数。

meta description
类型 Function | String
定义于 extensions/ccpool/CCNodePool.js:76

方法

constructor

使用构造函数来创建一个节点专用的对象池,您可以传递一个组件类型或名称,用于处理节点回收和复用时的事件逻辑。

meta description
定义于 extensions/ccpool/CCNodePool.js:57
参数列表
  • poolHandlerComp Function | String !#en The constructor or the class name of the component to control the unuse/reuse logic. !#zh 处理节点回收和复用事件逻辑的组件类型或名称。
示例
properties: {
   template: cc.Prefab
 },
 onLoad () {
// MyTemplateHandler is a component with 'unuse' and 'reuse' to handle events when node is reused or recycled.
   this.myPool = new cc.NodePool('MyTemplateHandler');
 }
size

获取当前缓冲池的可用对象数量

meta description
返回 Number
定义于 extensions/ccpool/CCNodePool.js:88
clear

销毁对象池中缓存的所有节点

meta description
定义于 extensions/ccpool/CCNodePool.js:98
put

向缓冲池中存入一个不再需要的节点对象。 这个函数会自动将目标节点从父节点上移除,但是不会进行 cleanup 操作。 这个函数会调用 poolHandlerComp 的 unuse 函数,如果组件和函数都存在的话。

meta description
定义于 extensions/ccpool/CCNodePool.js:111
参数列表
示例
let myNode = cc.instantiate(this.template);
  this.myPool.put(myNode);
get

获取对象池中的对象,如果对象池没有可用对象,则返回空。 这个函数会调用 poolHandlerComp 的 reuse 函数,如果组件和函数都存在的话。

meta description
返回 Node | Null
定义于 extensions/ccpool/CCNodePool.js:139
参数列表
  • params Any !#en Params to pass to 'reuse' method in poolHandlerComp !#zh 向 poolHandlerComp 中的 'reuse' 函数传递的参数
示例
let newNode = this.myPool.get();

条与 "" 相匹配的结果

    没有与 "" 匹配的结果