lua 游戏架构 之 资源加载 LoaderManager (一)

定义一个 LoaderManager class,用于管理各种资源加载器。它使用了对象池(Object Pool)来优化资源加载器的创建和销毁,从而提高性能

举例定义一个 PrefabLoader

Lua 复制代码
--[[
   Desc: 封装AAS的接口,加载Prefab
--]]

---@alias PrefabLoader.CompleteDelegate fun(obj:table, l:PrefabLoader) | fun(l:PrefabLoader)

---@class PrefabLoader : BaseLoader
---@field result CS.UnityEngine.GameObject
---@field callback PrefabLoader.CompleteDelegate
local PrefabLoader = SimpleClassUtil:class(require 'Topjoy.Engine.Resources.BaseLoader')

PrefabLoader.intType = CS.Topjoy.Base.ResourceManagement.ResourcesUtil.TypeInts.GameObject

---@overload fun(parent:CS.UnityEngine.Transform): CS.UnityEngine.GameObject | CS.UnityEngine.Object
---@overload fun(): CS.UnityEngine.GameObject | CS.UnityEngine.Object
---@param parent CS.UnityEngine.Transform
---@param worldStay boolean @默认false
---@return CS.UnityEngine.GameObject | CS.UnityEngine.Object
function PrefabLoader:instantiate(parent, worldStay)
    if self.result then
        if parent then
            return CS.UnityEngine.GameObject.Instantiate(self.result, parent, worldStay==true)
        else
            return CS.UnityEngine.GameObject.Instantiate(self.result)
        end
    end
end

return PrefabLoader

设计思路:

  • 引入了各种资源加载器,如AssetLoaderPrefabLoader等,这些加载器负责加载不同类型的资源。

  • initialize方法调用onInit方法进行初始化。onInit方法中,首先获取资源管理器实例,然后初始化各种资源加载器池,每个池子使用TablePool来管理对象池。

  • PrefabLoader为例,创建了一个对象池,池子大小为16。当需要新的PrefabLoader实例时,会调用传入的函数创建一个新的PrefabLoader对象,并设置其释放函数为self._assetPool:releaseObj(1)

  • loadAssetAsync方法用于异步加载资源。它从对象池中获取一个PrefabLoader实例,初始化它,并调用其loadAsync方法进行异步加载。

  • release方法用于释放所有资源加载器池,并清理资源管理器实例。

注意事项

  1. 对象池的使用:通过对象池管理资源加载器,可以减少对象的频繁创建和销毁,提高性能。
  2. 异步加载 :资源加载方法(如loadAssetAsync)都是异步的,可以避免阻塞主线程。
  3. 资源管理器 :使用CS.Topjoy.Base.ResourceManagement.ResourceManager来管理资源加载,确保资源加载的一致性和效率。
Lua 复制代码
---@class LoaderManager
local LoaderManager = SimpleClassUtil:class()

local AssetLoader = require 'Topjoy.Engine.Resources.AssetLoader'
local PrefabLoader = require 'Topjoy.Engine.Resources.PrefabLoader'
local MaterialLoader = require 'Topjoy.Engine.Resources.MaterialLoader'
local TextureLoader = require 'Topjoy.Engine.Resources.TextureLoader'
local TextAssetLoader = require 'Topjoy.Engine.Resources.TextAssetLoader'
local ListSpriteLoader = require 'Topjoy.Engine.Resources.ListSpriteLoader'
local MultiAssetLoaders = require 'Topjoy.Engine.Resources.MultiAssetLoaders'
local SceneLoader = require 'Topjoy.Engine.Resources.SceneLoader'
local WwiseBankLoader = require 'Topjoy.Engine.Resources.WwiseBankLoader'
local WalletLoader = require 'Topjoy.Engine.Resources.Wallet.LoaderWallet'

function LoaderManager:initialize()
    self:onInit()
end

function LoaderManager:onInit()
    self._resourceManager = CS.Topjoy.Base.ResourceManagement.ResourceManager.Instance

    self._assetPool = TablePool:new(16, function()
        local loader = AssetLoader:new()
        loader.rlsFunc = function(l)
            self._assetPool:releaseObj(l)
        end
        return loader
    end)
    self._prefabPool = TablePool:new(16, function()
        local loader = PrefabLoader:new()
        loader.rlsFunc = function(l)
            self._prefabPool:releaseObj(l)
        end
        return loader
    end)
    self._materialPool = TablePool:new(16, function()
        local loader = MaterialLoader:new()
        loader.rlsFunc = function(l)
            self._materialPool:releaseObj(l)
        end
        return loader
    end)
    self._texturePool = TablePool:new(16, function()
        local loader = TextureLoader:new()
        loader.rlsFunc = function(l)
            self._texturePool:releaseObj(l)
        end
        return loader
    end)
    self._textAssetPool = TablePool:new(16, function()
        local loader = TextAssetLoader:new()
        loader.rlsFunc = function(l)
            self._textAssetPool:releaseObj(l)
        end
        return loader
    end)
    self._listSpritePool = TablePool:new(16, function()
        local loader = ListSpriteLoader:new()
        loader.rlsFunc = function(l)
            self._listSpritePool:releaseObj(l)
        end
        return loader
    end)
    self._multiAssetsPool = TablePool:new(16, function()
        local loader = MultiAssetLoaders:new()
        loader.rlsFunc = function(l)
            self._multiAssetsPool:releaseObj(l)
        end
        return loader
    end)
    self._scenePool = TablePool:new(16, function()
        local loader = SceneLoader:new()
        loader.rlsFunc = function(l)
            self._scenePool:releaseObj(l)
        end
        return loader
    end)
    self._wwiseBankPool = TablePool:new(4, function()
        local loader = WwiseBankLoader:new()
        loader.rlsFunc = function(l)
            self._wwiseBankPool:releaseObj(l)
        end
        return loader
    end)
    self._walletPool = TablePool:new(16,function ()
        local loader = WalletLoader:new()
        loader.rlsFunc = function(l)
           self._walletPool:releaseObj(l)
        end
        return loader
    end)
end

function LoaderManager:release()
    self._resourceManager = nil
    Logger.print("LoaderManager:release")
    self._assetPool:release()
    self._prefabPool:release()
    self._materialPool:release()
    self._texturePool:release()
    self._textAssetPool:release()
    self._listSpritePool:release()
    self._multiAssetsPool:release()
    self._scenePool:release()
    self._wwiseBankPool:release()
    self._walletPool:release()
end

---@param path string
---@return AssetLoader
function LoaderManager:newAssetLoader(path)
    local loader = self._assetPool:getObj()
    loader:init(path)
    return loader
end

---@param path string
---@param obj table @回调的self参数,可为nil
---@param data any @loader的附加参数,可通过loader.data获取
---@param callback AssetLoader.CompleteDelegate
---@return AssetLoader
function LoaderManager:loadAssetAsync(path, callback, obj, data)
    ---@type AssetLoader
    local loader = self._assetPool:getObj()
    loader:init(path)
    loader:loadAsync(callback, obj, data)
    return loader
end

---@param path string
---@return PrefabLoader
function LoaderManager:newPrefabLoader(path)
    local loader = self._prefabPool:getObj()
    loader:init(path)
    return loader
end

---@param path string
---@param obj table @回调的self参数,可为nil
---@param data any @loader的附加参数,可通过loader.data获取
---@param callback PrefabLoader.CompleteDelegate
---@return PrefabLoader
function LoaderManager:loadPrefabAsync(path, callback, obj, data)
    ---@type PrefabLoader
    local loader = self._prefabPool:getObj()
    loader:init(path)
    loader:loadAsync(callback, obj, data)
    return loader
end

---@param path string
---@return MaterialLoader
function LoaderManager:newMaterialLoader(path)
    local loader = self._materialPool:getObj()
    loader:init(path)
    return loader
end

---@param path string
---@param obj table @回调的self参数,可为nil
---@param data any @loader的附加参数,可通过loader.data获取
---@param callback MaterialLoader.CompleteDelegate
---@return MaterialLoader
function LoaderManager:loadMaterialAsync(path, callback, obj, data)
    ---@type MaterialLoader
    local loader = self._materialPool:getObj()
    loader:init(path)
    loader:loadAsync(callback, obj, data)
    return loader
end

---@param path string
---@return TextureLoader
function LoaderManager:newTextureLoader(path)
    local loader = self._texturePool:getObj()
    loader:init(path)
    return loader
end

---@param path string
---@param obj table @回调的self参数,可为nil
---@param data any @loader的附加参数,可通过loader.data获取
---@param callback TextureLoader.CompleteDelegate
---@return TextureLoader
function LoaderManager:loadTextureAsync(path, callback, obj, data)
    ---@type TextureLoader
    local loader = self._texturePool:getObj()
    loader:init(path)
    loader:loadAsync(callback, obj, data)
    return loader
end

---@param path string
---@return TextAssetLoader
function LoaderManager:newTextAssetLoader(path)
    local loader = self._textAssetPool:getObj()
    loader:init(path)
    return loader
end

---@param path string
---@param obj table @回调的self参数,可为nil
---@param data any @loader的附加参数,可通过loader.data获取
---@param callback TextAssetLoader.CompleteDelegate
---@return TextAssetLoader
function LoaderManager:loadTextAssetAsync(path, callback, obj, data)
    ---@type TextAssetLoader
    local loader = self._textAssetPool:getObj()
    loader:init(path)
    loader:loadAsync(callback, obj, data)
    return loader
end

---@param path string
---@return ListSpriteLoader
function LoaderManager:newListSpriteLoader(path)
    local loader = self._listSpritePool:getObj()
    loader:init(path)
    return loader
end

---@param path string
---@param obj table @回调的self参数,可为nil
---@param data any @loader的附加参数,可通过loader.data获取
---@param callback ListSpriteLoader.CompleteDelegate
---@return ListSpriteLoader
function LoaderManager:loadListSpriteAsync(path, callback, obj, data)
    ---@type ListSpriteLoader
    local loader = self._listSpritePool:getObj()
    loader:init(path)
    loader:loadAsync(callback, obj, data)
    return loader
end

---@param callback MultiAssetLoaders.CompleteDelegate
---@return MultiAssetLoaders
function LoaderManager:loadMultiAssetAsync(callback, obj, data, ...)
    ---@type MultiAssetLoaders
    local loader = self._multiAssetsPool:getObj()
    loader:init(...)
    loader:loadAsync(callback, obj, data)
    return loader
end

---@param callback SceneLoader.CompleteDelegate
---@return SceneLoader
function LoaderManager:loadSceneAsync(path, callback, obj, data)
    ---@type SceneLoader
    local loader = self._scenePool:getObj()
    loader:init(path)
    loader:loadAsync(callback, obj, data)
    return loader
end

---@param callback WwiseBankLoader.CompleteDelegate
---@return WwiseBankLoader
function LoaderManager:newWwiseBankLoader(path)
    ---@type SceneLoader
    local loader = self._wwiseBankPool:getObj()
    loader:init(path)
    return loader
end

---@param owner @传self
---@return LoaderWallet
function LoaderManager:newLoaderWallet(owner)
    local loader = self._walletPool:getObj()
    loader:setOwner(owner)
    return loader
end

---@param maxExecute number @最大同时异步加载数量
---@param maxComplete number @最大同帧回调数量
---@return CS.Topjoy.Base.ResourceManagement.OperationHandles.OperationQueue
function LoaderManager:newLoaderQueue(maxExecute, maxComplete)
    local queue = self._resourceManager:NewOperationQueue(maxExecute, maxComplete)
    return queue
end

---@param queue CS.Topjoy.Base.ResourceManagement.ResourceManager
function LoaderManager:destroyLoaderQueue(queue)
    self._resourceManager:DestroyOperationQueue(queue)
end

return LoaderManager
相关推荐
李詹1 小时前
WAF防护规则配置技巧与企业级安全实践指南
网络·tcp/ip·安全·架构·ddos
人类群星闪耀时4 小时前
跳跃游戏的最优解法——贪心算法的智慧与实践
算法·游戏·贪心算法
橘子青衫4 小时前
掌握HttpClient技术:从基础到实战(Apache)
java·后端·架构
双叶8365 小时前
(51单片机)矩阵按键密码锁表白(C语言代码编撰)(矩阵按键教程)(LCD1602浅教程)
c语言·开发语言·c++·算法·游戏·矩阵·51单片机
程序员JerrySUN5 小时前
深入解析ARM与RISC-V架构的Bring-up核心流程
arm开发·架构·risc-v
小小工匠5 小时前
架构思维: 数据一致性的两种场景深度解读
架构·数据一致性·最终一致性·实时一致性
郭涤生6 小时前
第一章:服务架构演进史_《凤凰架构:构建可靠的大型分布式系统》_Notes
笔记·架构·系统架构
hycccccch6 小时前
超卖问题解决方案
java·笔记·lua
小小工匠6 小时前
架构思维: 全链路日志深度解析
微服务·架构·skywalking
monstercl6 小时前
【Lua】pcall使用详解
开发语言·lua