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

界说一个 LoaderManager class，用于管理各种资源加载器。它使用了对象池（Object Pool）来优化资源加载器的创建和烧毁，从而提高性能
举例界说一个 PrefabLoader

1. --[[
2.    Desc: 封装AAS的接口，加载Prefab
3. --]]
5. ---@alias PrefabLoader.CompleteDelegate fun(obj:table, l:PrefabLoader) | fun(l:PrefabLoader)
7. ---@class PrefabLoader : BaseLoader
8. ---@field result CS.UnityEngine.GameObject
9. ---@field callback PrefabLoader.CompleteDelegate
10. local PrefabLoader = SimpleClassUtil:class(require 'Topjoy.Engine.Resources.BaseLoader')
12. PrefabLoader.intType = CS.Topjoy.Base.ResourceManagement.ResourcesUtil.TypeInts.GameObject
14. ---@overload fun(parent:CS.UnityEngine.Transform): CS.UnityEngine.GameObject | CS.UnityEngine.Object
15. ---@overload fun(): CS.UnityEngine.GameObject | CS.UnityEngine.Object
16. ---@param parent CS.UnityEngine.Transform
17. ---@param worldStay boolean @默认false
18. ---@return CS.UnityEngine.GameObject | CS.UnityEngine.Object
19. function PrefabLoader:instantiate(parent, worldStay)
20.     if self.result then
21.         if parent then
22.             return CS.UnityEngine.GameObject.Instantiate(self.result, parent, worldStay==true)
23.         else
24.             return CS.UnityEngine.GameObject.Instantiate(self.result)
25.         end
26.     end
27. end
29. return PrefabLoader

复制代码

设计思绪：

• 引入了各种资源加载器，如AssetLoader、PrefabLoader等，这些加载器负责加载差别类型的资源。
  
• initialize方法调用onInit方法举行初始化。onInit方法中，起首获取资源管理器实例，然后初始化各种资源加载器池，每个池子使用TablePool来管理对象池。
  
• PrefabLoader为例，创建了一个对象池，池子大小为16。当需要新的PrefabLoader实例时，会调用传入的函数创建一个新的PrefabLoader对象，并设置其释放函数为self._assetPool:releaseObj(1)
  
• loadAssetAsync方法用于异步加载资源。它从对象池中获取一个PrefabLoader实例，初始化它，并调用其loadAsync方法举行异步加载。
  
• release方法用于释放所有资源加载器池，并清理资源管理器实例。
  

注意事项

• 对象池的使用：通过对象池管理资源加载器，可以减少对象的频仍创建和烧毁，提高性能。
  
• 异步加载：资源加载方法（如loadAssetAsync）都是异步的，可以避免阻塞主线程。
  
• 资源管理器：使用CS.Topjoy.Base.ResourceManagement.ResourceManager来管理资源加载，确保资源加载的同等性和效率。
  

1. ---@class LoaderManager
2. local LoaderManager = SimpleClassUtil:class()
4. local AssetLoader = require 'Topjoy.Engine.Resources.AssetLoader'
5. local PrefabLoader = require 'Topjoy.Engine.Resources.PrefabLoader'
6. local MaterialLoader = require 'Topjoy.Engine.Resources.MaterialLoader'
7. local TextureLoader = require 'Topjoy.Engine.Resources.TextureLoader'
8. local TextAssetLoader = require 'Topjoy.Engine.Resources.TextAssetLoader'
9. local ListSpriteLoader = require 'Topjoy.Engine.Resources.ListSpriteLoader'
10. local MultiAssetLoaders = require 'Topjoy.Engine.Resources.MultiAssetLoaders'
11. local SceneLoader = require 'Topjoy.Engine.Resources.SceneLoader'
12. local WwiseBankLoader = require 'Topjoy.Engine.Resources.WwiseBankLoader'
13. local WalletLoader = require 'Topjoy.Engine.Resources.Wallet.LoaderWallet'
15. function LoaderManager:initialize()
16.     self:onInit()
17. end
19. function LoaderManager:onInit()
20.     self._resourceManager = CS.Topjoy.Base.ResourceManagement.ResourceManager.Instance
22.     self._assetPool = TablePool:new(16, function()
23.         local loader = AssetLoader:new()
24.         loader.rlsFunc = function(l)
25.             self._assetPool:releaseObj(l)
26.         end
27.         return loader
28.     end)
29.     self._prefabPool = TablePool:new(16, function()
30.         local loader = PrefabLoader:new()
31.         loader.rlsFunc = function(l)
32.             self._prefabPool:releaseObj(l)
33.         end
34.         return loader
35.     end)
36.     self._materialPool = TablePool:new(16, function()
37.         local loader = MaterialLoader:new()
38.         loader.rlsFunc = function(l)
39.             self._materialPool:releaseObj(l)
40.         end
41.         return loader
42.     end)
43.     self._texturePool = TablePool:new(16, function()
44.         local loader = TextureLoader:new()
45.         loader.rlsFunc = function(l)
46.             self._texturePool:releaseObj(l)
47.         end
48.         return loader
49.     end)
50.     self._textAssetPool = TablePool:new(16, function()
51.         local loader = TextAssetLoader:new()
52.         loader.rlsFunc = function(l)
53.             self._textAssetPool:releaseObj(l)
54.         end
55.         return loader
56.     end)
57.     self._listSpritePool = TablePool:new(16, function()
58.         local loader = ListSpriteLoader:new()
59.         loader.rlsFunc = function(l)
60.             self._listSpritePool:releaseObj(l)
61.         end
62.         return loader
63.     end)
64.     self._multiAssetsPool = TablePool:new(16, function()
65.         local loader = MultiAssetLoaders:new()
66.         loader.rlsFunc = function(l)
67.             self._multiAssetsPool:releaseObj(l)
68.         end
69.         return loader
70.     end)
71.     self._scenePool = TablePool:new(16, function()
72.         local loader = SceneLoader:new()
73.         loader.rlsFunc = function(l)
74.             self._scenePool:releaseObj(l)
75.         end
76.         return loader
77.     end)
78.     self._wwiseBankPool = TablePool:new(4, function()
79.         local loader = WwiseBankLoader:new()
80.         loader.rlsFunc = function(l)
81.             self._wwiseBankPool:releaseObj(l)
82.         end
83.         return loader
84.     end)
85.     self._walletPool = TablePool:new(16,function ()
86.         local loader = WalletLoader:new()
87.         loader.rlsFunc = function(l)
88.            self._walletPool:releaseObj(l)
89.         end
90.         return loader
91.     end)
92. end
94. function LoaderManager:release()
95.     self._resourceManager = nil
96.     Logger.print("LoaderManager:release")
97.     self._assetPool:release()
98.     self._prefabPool:release()
99.     self._materialPool:release()
100.     self._texturePool:release()
101.     self._textAssetPool:release()
102.     self._listSpritePool:release()
103.     self._multiAssetsPool:release()
104.     self._scenePool:release()
105.     self._wwiseBankPool:release()
106.     self._walletPool:release()
107. end
109. ---@param path string
110. ---@return AssetLoader
111. function LoaderManager:newAssetLoader(path)
112.     local loader = self._assetPool:getObj()
113.     loader:init(path)
114.     return loader
115. end
117. ---@param path string
118. ---@param obj table @回调的self参数，可为nil
119. ---@param data any @loader的附加参数，可通过loader.data获取
120. ---@param callback AssetLoader.CompleteDelegate
121. ---@return AssetLoader
122. function LoaderManager:loadAssetAsync(path, callback, obj, data)
123.     ---@type AssetLoader
124.     local loader = self._assetPool:getObj()
125.     loader:init(path)
126.     loader:loadAsync(callback, obj, data)
127.     return loader
128. end
130. ---@param path string
131. ---@return PrefabLoader
132. function LoaderManager:newPrefabLoader(path)
133.     local loader = self._prefabPool:getObj()
134.     loader:init(path)
135.     return loader
136. end
138. ---@param path string
139. ---@param obj table @回调的self参数，可为nil
140. ---@param data any @loader的附加参数，可通过loader.data获取
141. ---@param callback PrefabLoader.CompleteDelegate
142. ---@return PrefabLoader
143. function LoaderManager:loadPrefabAsync(path, callback, obj, data)
144.     ---@type PrefabLoader
145.     local loader = self._prefabPool:getObj()
146.     loader:init(path)
147.     loader:loadAsync(callback, obj, data)
148.     return loader
149. end
151. ---@param path string
152. ---@return MaterialLoader
153. function LoaderManager:newMaterialLoader(path)
154.     local loader = self._materialPool:getObj()
155.     loader:init(path)
156.     return loader
157. end
159. ---@param path string
160. ---@param obj table @回调的self参数，可为nil
161. ---@param data any @loader的附加参数，可通过loader.data获取
162. ---@param callback MaterialLoader.CompleteDelegate
163. ---@return MaterialLoader
164. function LoaderManager:loadMaterialAsync(path, callback, obj, data)
165.     ---@type MaterialLoader
166.     local loader = self._materialPool:getObj()
167.     loader:init(path)
168.     loader:loadAsync(callback, obj, data)
169.     return loader
170. end
172. ---@param path string
173. ---@return TextureLoader
174. function LoaderManager:newTextureLoader(path)
175.     local loader = self._texturePool:getObj()
176.     loader:init(path)
177.     return loader
178. end
180. ---@param path string
181. ---@param obj table @回调的self参数，可为nil
182. ---@param data any @loader的附加参数，可通过loader.data获取
183. ---@param callback TextureLoader.CompleteDelegate
184. ---@return TextureLoader
185. function LoaderManager:loadTextureAsync(path, callback, obj, data)
186.     ---@type TextureLoader
187.     local loader = self._texturePool:getObj()
188.     loader:init(path)
189.     loader:loadAsync(callback, obj, data)
190.     return loader
191. end
193. ---@param path string
194. ---@return TextAssetLoader
195. function LoaderManager:newTextAssetLoader(path)
196.     local loader = self._textAssetPool:getObj()
197.     loader:init(path)
198.     return loader
199. end
201. ---@param path string
202. ---@param obj table @回调的self参数，可为nil
203. ---@param data any @loader的附加参数，可通过loader.data获取
204. ---@param callback TextAssetLoader.CompleteDelegate
205. ---@return TextAssetLoader
206. function LoaderManager:loadTextAssetAsync(path, callback, obj, data)
207.     ---@type TextAssetLoader
208.     local loader = self._textAssetPool:getObj()
209.     loader:init(path)
210.     loader:loadAsync(callback, obj, data)
211.     return loader
212. end
214. ---@param path string
215. ---@return ListSpriteLoader
216. function LoaderManager:newListSpriteLoader(path)
217.     local loader = self._listSpritePool:getObj()
218.     loader:init(path)
219.     return loader
220. end
222. ---@param path string
223. ---@param obj table @回调的self参数，可为nil
224. ---@param data any @loader的附加参数，可通过loader.data获取
225. ---@param callback ListSpriteLoader.CompleteDelegate
226. ---@return ListSpriteLoader
227. function LoaderManager:loadListSpriteAsync(path, callback, obj, data)
228.     ---@type ListSpriteLoader
229.     local loader = self._listSpritePool:getObj()
230.     loader:init(path)
231.     loader:loadAsync(callback, obj, data)
232.     return loader
233. end
235. ---@param callback MultiAssetLoaders.CompleteDelegate
236. ---@return MultiAssetLoaders
237. function LoaderManager:loadMultiAssetAsync(callback, obj, data, ...)
238.     ---@type MultiAssetLoaders
239.     local loader = self._multiAssetsPool:getObj()
240.     loader:init(...)
241.     loader:loadAsync(callback, obj, data)
242.     return loader
243. end
245. ---@param callback SceneLoader.CompleteDelegate
246. ---@return SceneLoader
247. function LoaderManager:loadSceneAsync(path, callback, obj, data)
248.     ---@type SceneLoader
249.     local loader = self._scenePool:getObj()
250.     loader:init(path)
251.     loader:loadAsync(callback, obj, data)
252.     return loader
253. end
255. ---@param callback WwiseBankLoader.CompleteDelegate
256. ---@return WwiseBankLoader
257. function LoaderManager:newWwiseBankLoader(path)
258.     ---@type SceneLoader
259.     local loader = self._wwiseBankPool:getObj()
260.     loader:init(path)
261.     return loader
262. end
264. ---@param owner @传self
265. ---@return LoaderWallet
266. function LoaderManager:newLoaderWallet(owner)
267.     local loader = self._walletPool:getObj()
268.     loader:setOwner(owner)
269.     return loader
270. end
272. ---@param maxExecute number @最大同时异步加载数量
273. ---@param maxComplete number @最大同帧回调数量
274. ---@return CS.Topjoy.Base.ResourceManagement.OperationHandles.OperationQueue
275. function LoaderManager:newLoaderQueue(maxExecute, maxComplete)
276.     local queue = self._resourceManager:NewOperationQueue(maxExecute, maxComplete)
277.     return queue
278. end
280. ---@param queue CS.Topjoy.Base.ResourceManagement.ResourceManager
281. function LoaderManager:destroyLoaderQueue(queue)
282.     self._resourceManager:DestroyOperationQueue(queue)
283. end
285. return LoaderManager

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。