游戏引擎 / 系统课时

资源引用怎样避免常驻

资源引用怎样避免常驻

一张活动弹窗图片只显示十几秒,却可能因为单例缓存或漏掉释放而常驻整局游戏。本课用 Cocos Creator 3.8 的资源所有权和引用计数,把全局、场景、弹窗资源分开管理,让动态加载的资源在使用结束后有明确的归还动作。

学习目标

  • 按使用期限决定资源应由谁持有。
  • 正确配对动态资源的 addRef()、decRef() 和组件生命周期。
  • 识别单例、对象池与异步回调中的长期引用风险。

先确定资源归谁管

resources.load() 能把资源加载进 AssetManager 缓存,但回调里拿到对象,不代表引擎能识别你的业务代码何时不再使用它。资源所有权应当随实际消费场景变化,而不是统一塞进全局字典。

资源范围 典型资源 建议持有者
整局共享 通用 UI 图集、基础音效 受控的全局资源服务
单个场景 关卡贴图、模型 场景静态依赖或场景级管理器
临时界面 活动弹窗图标 弹窗组件自身

全局、场景与弹窗资源的持有期限和引用归还

共享资源不是绝对不能常驻,而是必须有理由:复用频繁、占用可控、明确受预算约束。低频的大图、只在某关卡使用的材质和短期活动资源,不宜被全局单例永久保存。

动态引用必须成对管理

引擎能追踪场景、Prefab 等序列化资源之间的静态依赖,却无法完整统计脚本赋值、闭包和单例形成的动态引用。需要跨越加载回调持续使用某个资源时,持有者调用一次 addRef();结束使用时清除组件关联,再执行一次对应的 decRef()。

decRef() 会减少引用计数,并按引擎的释放检查尝试回收。不要把 releaseAsset() 当作通用的“减引用”操作:它直接释放目标资源,可能导致另一个界面正在使用的图片失效。

实现一个自管理的弹窗图标

在 Cocos Creator 3.8 项目里准备 assets/resources/ui/popup-icon.png,将它导入为带 SpriteFrame 子资源的图片。新建弹窗节点与 Sprite 组件,将下列脚本挂在弹窗上,在属性检查器中把 icon 指向该 Sprite。

ts
import { _decorator, Component, Sprite, SpriteFrame, resources } from 'cc';

const { ccclass, property } = _decorator;

@ccclass('PopupIconOwner')
export class PopupIconOwner extends Component {
  @property(Sprite)
  icon: Sprite | null = null;

  private retained: SpriteFrame | null = null;
  private disposed = false;

  start(): void {
    const icon = this.icon;
    if (!icon) {
      console.warn('[popup] missing Sprite');
      return;
    }

    resources.load('ui/popup-icon/spriteFrame', SpriteFrame, (error, frame) => {
      if (error || !frame) {
        console.warn('[popup] load failed');
        return;
      }
      // 弹窗已销毁时,迟到的回调不能重新建立长引用
      if (this.disposed) return;
      frame.addRef();
      this.retained = frame;
      icon.spriteFrame = frame;
      console.log('[popup] acquired');
    });
  }

  onDestroy(): void {
    this.disposed = true;
    // 先切断界面引用,再归还本组件持有的一次引用
    if (this.icon) this.icon.spriteFrame = null;
    if (this.retained) {
      this.retained.decRef();
      this.retained = null;
      console.log('[popup] released');
    }
  }
}

预期输出(资源成功加载后再销毁弹窗节点):

text
[popup] acquired
[popup] released

如果配置缺失或加载失败,会输出对应的警告,不会虚构一次成功加载。弹窗销毁前加载回调尚未完成时,也不会执行 addRef();但该资源仍可能留在加载缓存中,需要结合是否共享和后续复用决定是否额外清理。

处理不会销毁的持有者

node.active = false 只是隐藏或停用节点,不会触发 onDestroy();对象池把弹窗放回池里时同样如此。若池长期保存组件,上述代码的引用也会留在内存里。此时应明确选择:保留小规模可复用资源并限制池容量,或者在“归还池”时主动清空显示引用并 decRef(),下次使用再加载,且防止重复释放。

全局服务只应缓存确实需要跨场景复用的资源,并记录获取、归还和淘汰时机。异步加载完成时还要再次检查请求发起者是否存活;切场景后才返回的结果不能偷偷写回全局缓存。

验证引用有没有越积越多

多次打开并销毁同一个弹窗,核对每次成功加载都对应一次释放日志;再在真机上比较重复操作后的稳定内存。若两次弹窗共用一张图片,各持有者分别 addRef() 和 decRef(),资源只有在不再被其他依赖使用时才适合回收。

资源能否及时退出内存,取决于谁拥有它、何时归还它,以及是否仍有其他使用者。把这三件事落实到组件的生命周期,往往比增加一套复杂的全局清理器更可靠。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

资源引用怎样避免常驻

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通