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
缓冲池处理组件,用于节点的回收和复用逻辑,这个属性可以是组件类名或组件的构造函数。
metadescription
类型Function | String
定义于extensions/ccpool/CCNodePool.js:76



#### 方法



##### constructor


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

metadescription
定义于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 处理节点回收和复用事件逻辑的组件类型或名称。
示例
  1. properties: {
  2. template: cc.Prefab
  3. },
  4. onLoad () {
  5. // MyTemplateHandler is a component with 'unuse' and 'reuse' to handle events when node is reused or recycled.
  6. this.myPool = new cc.NodePool('MyTemplateHandler');
  7. }
size

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

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

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

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

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

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

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

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