BaseComponent.cs 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426
  1. //------------------------------------------------------------
  2. // Game Framework
  3. // Copyright © 2013-2021 Jiang Yin. All rights reserved.
  4. // Homepage: https://gameframework.cn/
  5. // Feedback: mailto:ellan@gameframework.cn
  6. //------------------------------------------------------------
  7. using GameFramework;
  8. using GameFramework.Localization;
  9. using GameFramework.Resource;
  10. using System;
  11. using UnityEngine;
  12. namespace UnityGameFramework.Runtime
  13. {
  14. /// <summary>
  15. /// 基础组件。
  16. /// </summary>
  17. [DisallowMultipleComponent]
  18. [AddComponentMenu("Game Framework/Base")]
  19. public sealed class BaseComponent : GameFrameworkComponent
  20. {
  21. private const int DefaultDpi = 96; // default windows dpi
  22. private float m_GameSpeedBeforePause = 1f;
  23. [SerializeField]
  24. private bool m_EditorResourceMode = true;
  25. [SerializeField]
  26. private Language m_EditorLanguage = Language.Unspecified;
  27. [SerializeField]
  28. private string m_TextHelperTypeName = "UnityGameFramework.Runtime.DefaultTextHelper";
  29. [SerializeField]
  30. private string m_VersionHelperTypeName = "UnityGameFramework.Runtime.DefaultVersionHelper";
  31. [SerializeField]
  32. private string m_LogHelperTypeName = "UnityGameFramework.Runtime.DefaultLogHelper";
  33. [SerializeField]
  34. private string m_CompressionHelperTypeName = "UnityGameFramework.Runtime.DefaultCompressionHelper";
  35. [SerializeField]
  36. private string m_JsonHelperTypeName = "UnityGameFramework.Runtime.DefaultJsonHelper";
  37. [SerializeField]
  38. private int m_FrameRate = 30;
  39. [SerializeField]
  40. private float m_GameSpeed = 1f;
  41. [SerializeField]
  42. private bool m_RunInBackground = true;
  43. [SerializeField]
  44. private bool m_NeverSleep = true;
  45. /// <summary>
  46. /// 获取或设置是否使用编辑器资源模式(仅编辑器内有效)。
  47. /// </summary>
  48. public bool EditorResourceMode
  49. {
  50. get
  51. {
  52. return m_EditorResourceMode;
  53. }
  54. set
  55. {
  56. m_EditorResourceMode = value;
  57. }
  58. }
  59. /// <summary>
  60. /// 获取或设置编辑器语言(仅编辑器内有效)。
  61. /// </summary>
  62. public Language EditorLanguage
  63. {
  64. get
  65. {
  66. return m_EditorLanguage;
  67. }
  68. set
  69. {
  70. m_EditorLanguage = value;
  71. }
  72. }
  73. /// <summary>
  74. /// 获取或设置编辑器资源辅助器。
  75. /// </summary>
  76. public IResourceManager EditorResourceHelper
  77. {
  78. get;
  79. set;
  80. }
  81. /// <summary>
  82. /// 获取或设置游戏帧率。
  83. /// </summary>
  84. public int FrameRate
  85. {
  86. get
  87. {
  88. return m_FrameRate;
  89. }
  90. set
  91. {
  92. Application.targetFrameRate = m_FrameRate = value;
  93. }
  94. }
  95. /// <summary>
  96. /// 获取或设置游戏速度。
  97. /// </summary>
  98. public float GameSpeed
  99. {
  100. get
  101. {
  102. return m_GameSpeed;
  103. }
  104. set
  105. {
  106. Time.timeScale = m_GameSpeed = value >= 0f ? value : 0f;
  107. }
  108. }
  109. /// <summary>
  110. /// 获取游戏是否暂停。
  111. /// </summary>
  112. public bool IsGamePaused
  113. {
  114. get
  115. {
  116. return m_GameSpeed <= 0f;
  117. }
  118. }
  119. /// <summary>
  120. /// 获取是否正常游戏速度。
  121. /// </summary>
  122. public bool IsNormalGameSpeed
  123. {
  124. get
  125. {
  126. return m_GameSpeed == 1f;
  127. }
  128. }
  129. /// <summary>
  130. /// 获取或设置是否允许后台运行。
  131. /// </summary>
  132. public bool RunInBackground
  133. {
  134. get
  135. {
  136. return m_RunInBackground;
  137. }
  138. set
  139. {
  140. Application.runInBackground = m_RunInBackground = value;
  141. }
  142. }
  143. /// <summary>
  144. /// 获取或设置是否禁止休眠。
  145. /// </summary>
  146. public bool NeverSleep
  147. {
  148. get
  149. {
  150. return m_NeverSleep;
  151. }
  152. set
  153. {
  154. m_NeverSleep = value;
  155. Screen.sleepTimeout = value ? SleepTimeout.NeverSleep : SleepTimeout.SystemSetting;
  156. }
  157. }
  158. /// <summary>
  159. /// 游戏框架组件初始化。
  160. /// </summary>
  161. protected override void Awake()
  162. {
  163. base.Awake();
  164. InitTextHelper();
  165. InitVersionHelper();
  166. InitLogHelper();
  167. Log.Info("Game Framework Version: {0}", GameFramework.Version.GameFrameworkVersion);
  168. Log.Info("Game Version: {0} ({1})", GameFramework.Version.GameVersion, GameFramework.Version.InternalGameVersion);
  169. Log.Info("Unity Version: {0}", Application.unityVersion);
  170. #if UNITY_5_3_OR_NEWER || UNITY_5_3
  171. InitCompressionHelper();
  172. InitJsonHelper();
  173. Utility.Converter.ScreenDpi = Screen.dpi;
  174. if (Utility.Converter.ScreenDpi <= 0)
  175. {
  176. Utility.Converter.ScreenDpi = DefaultDpi;
  177. }
  178. m_EditorResourceMode &= Application.isEditor;
  179. if (m_EditorResourceMode)
  180. {
  181. Log.Info("During this run, Game Framework will use editor resource files, which you should validate first.");
  182. }
  183. Application.targetFrameRate = m_FrameRate;
  184. Time.timeScale = m_GameSpeed;
  185. Application.runInBackground = m_RunInBackground;
  186. Screen.sleepTimeout = m_NeverSleep ? SleepTimeout.NeverSleep : SleepTimeout.SystemSetting;
  187. #else
  188. Log.Error("Game Framework only applies with Unity 5.3 and above, but current Unity version is {0}.", Application.unityVersion);
  189. GameEntry.Shutdown(ShutdownType.Quit);
  190. #endif
  191. #if UNITY_5_6_OR_NEWER
  192. Application.lowMemory += OnLowMemory;
  193. #endif
  194. }
  195. private void Start()
  196. {
  197. }
  198. private void Update()
  199. {
  200. GameFrameworkEntry.Update(Time.deltaTime, Time.unscaledDeltaTime);
  201. }
  202. private void OnApplicationQuit()
  203. {
  204. #if UNITY_5_6_OR_NEWER
  205. Application.lowMemory -= OnLowMemory;
  206. #endif
  207. StopAllCoroutines();
  208. }
  209. private void OnDestroy()
  210. {
  211. GameFrameworkEntry.Shutdown();
  212. }
  213. /// <summary>
  214. /// 暂停游戏。
  215. /// </summary>
  216. public void PauseGame()
  217. {
  218. if (IsGamePaused)
  219. {
  220. return;
  221. }
  222. m_GameSpeedBeforePause = GameSpeed;
  223. GameSpeed = 0f;
  224. }
  225. /// <summary>
  226. /// 恢复游戏。
  227. /// </summary>
  228. public void ResumeGame()
  229. {
  230. if (!IsGamePaused)
  231. {
  232. return;
  233. }
  234. GameSpeed = m_GameSpeedBeforePause;
  235. }
  236. /// <summary>
  237. /// 重置为正常游戏速度。
  238. /// </summary>
  239. public void ResetNormalGameSpeed()
  240. {
  241. if (IsNormalGameSpeed)
  242. {
  243. return;
  244. }
  245. GameSpeed = 1f;
  246. }
  247. internal void Shutdown()
  248. {
  249. Destroy(gameObject);
  250. }
  251. private void InitTextHelper()
  252. {
  253. if (string.IsNullOrEmpty(m_TextHelperTypeName))
  254. {
  255. return;
  256. }
  257. Type textHelperType = Utility.Assembly.GetType(m_TextHelperTypeName);
  258. if (textHelperType == null)
  259. {
  260. Log.Error("Can not find text helper type '{0}'.", m_TextHelperTypeName);
  261. return;
  262. }
  263. Utility.Text.ITextHelper textHelper = (Utility.Text.ITextHelper)Activator.CreateInstance(textHelperType);
  264. if (textHelper == null)
  265. {
  266. Log.Error("Can not create text helper instance '{0}'.", m_TextHelperTypeName);
  267. return;
  268. }
  269. Utility.Text.SetTextHelper(textHelper);
  270. }
  271. private void InitVersionHelper()
  272. {
  273. if (string.IsNullOrEmpty(m_VersionHelperTypeName))
  274. {
  275. return;
  276. }
  277. Type versionHelperType = Utility.Assembly.GetType(m_VersionHelperTypeName);
  278. if (versionHelperType == null)
  279. {
  280. throw new GameFrameworkException(Utility.Text.Format("Can not find version helper type '{0}'.", m_VersionHelperTypeName));
  281. }
  282. GameFramework.Version.IVersionHelper versionHelper = (GameFramework.Version.IVersionHelper)Activator.CreateInstance(versionHelperType);
  283. if (versionHelper == null)
  284. {
  285. throw new GameFrameworkException(Utility.Text.Format("Can not create version helper instance '{0}'.", m_VersionHelperTypeName));
  286. }
  287. GameFramework.Version.SetVersionHelper(versionHelper);
  288. }
  289. private void InitLogHelper()
  290. {
  291. if (string.IsNullOrEmpty(m_LogHelperTypeName))
  292. {
  293. return;
  294. }
  295. Type logHelperType = Utility.Assembly.GetType(m_LogHelperTypeName);
  296. if (logHelperType == null)
  297. {
  298. throw new GameFrameworkException(Utility.Text.Format("Can not find log helper type '{0}'.", m_LogHelperTypeName));
  299. }
  300. GameFrameworkLog.ILogHelper logHelper = (GameFrameworkLog.ILogHelper)Activator.CreateInstance(logHelperType);
  301. if (logHelper == null)
  302. {
  303. throw new GameFrameworkException(Utility.Text.Format("Can not create log helper instance '{0}'.", m_LogHelperTypeName));
  304. }
  305. GameFrameworkLog.SetLogHelper(logHelper);
  306. }
  307. private void InitCompressionHelper()
  308. {
  309. if (string.IsNullOrEmpty(m_CompressionHelperTypeName))
  310. {
  311. return;
  312. }
  313. Type compressionHelperType = Utility.Assembly.GetType(m_CompressionHelperTypeName);
  314. if (compressionHelperType == null)
  315. {
  316. Log.Error("Can not find compression helper type '{0}'.", m_CompressionHelperTypeName);
  317. return;
  318. }
  319. Utility.Compression.ICompressionHelper compressionHelper = (Utility.Compression.ICompressionHelper)Activator.CreateInstance(compressionHelperType);
  320. if (compressionHelper == null)
  321. {
  322. Log.Error("Can not create compression helper instance '{0}'.", m_CompressionHelperTypeName);
  323. return;
  324. }
  325. Utility.Compression.SetCompressionHelper(compressionHelper);
  326. }
  327. private void InitJsonHelper()
  328. {
  329. if (string.IsNullOrEmpty(m_JsonHelperTypeName))
  330. {
  331. return;
  332. }
  333. Type jsonHelperType = Utility.Assembly.GetType(m_JsonHelperTypeName);
  334. if (jsonHelperType == null)
  335. {
  336. Log.Error("Can not find JSON helper type '{0}'.", m_JsonHelperTypeName);
  337. return;
  338. }
  339. Utility.Json.IJsonHelper jsonHelper = (Utility.Json.IJsonHelper)Activator.CreateInstance(jsonHelperType);
  340. if (jsonHelper == null)
  341. {
  342. Log.Error("Can not create JSON helper instance '{0}'.", m_JsonHelperTypeName);
  343. return;
  344. }
  345. Utility.Json.SetJsonHelper(jsonHelper);
  346. }
  347. private void OnLowMemory()
  348. {
  349. Log.Info("Low memory reported...");
  350. ObjectPoolComponent objectPoolComponent = GameEntry.GetComponent<ObjectPoolComponent>();
  351. if (objectPoolComponent != null)
  352. {
  353. objectPoolComponent.ReleaseAllUnused();
  354. }
  355. ResourceComponent resourceCompoent = GameEntry.GetComponent<ResourceComponent>();
  356. if (resourceCompoent != null)
  357. {
  358. resourceCompoent.ForceUnloadUnusedAssets(true);
  359. }
  360. }
  361. }
  362. }