GameFrameworkLog.cs 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483
  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 System.Diagnostics;
  8. namespace GameFramework
  9. {
  10. /// <summary>
  11. /// 游戏框架日志类。
  12. /// </summary>
  13. public static partial class GameFrameworkLog
  14. {
  15. private static ILogHelper s_LogHelper = null;
  16. /// <summary>
  17. /// 设置游戏框架日志辅助器。
  18. /// </summary>
  19. /// <param name="logHelper">要设置的游戏框架日志辅助器。</param>
  20. public static void SetLogHelper(ILogHelper logHelper)
  21. {
  22. s_LogHelper = logHelper;
  23. }
  24. /// <summary>
  25. /// 打印调试级别日志,用于记录调试类日志信息。
  26. /// </summary>
  27. /// <param name="message">日志内容。</param>
  28. public static void Debug(object message)
  29. {
  30. if (s_LogHelper == null)
  31. {
  32. return;
  33. }
  34. s_LogHelper.Log(GameFrameworkLogLevel.Debug, message);
  35. }
  36. /// <summary>
  37. /// 打印调试级别日志,用于记录调试类日志信息。
  38. /// </summary>
  39. /// <param name="message">日志内容。</param>
  40. public static void Debug(string message)
  41. {
  42. if (s_LogHelper == null)
  43. {
  44. return;
  45. }
  46. s_LogHelper.Log(GameFrameworkLogLevel.Debug, message);
  47. }
  48. /// <summary>
  49. /// 打印调试级别日志,用于记录调试类日志信息。
  50. /// </summary>
  51. /// <param name="format">日志格式。</param>
  52. /// <param name="arg0">日志参数 0。</param>
  53. public static void Debug(string format, object arg0)
  54. {
  55. if (s_LogHelper == null)
  56. {
  57. return;
  58. }
  59. s_LogHelper.Log(GameFrameworkLogLevel.Debug, Utility.Text.Format(format, arg0));
  60. }
  61. /// <summary>
  62. /// 打印调试级别日志,用于记录调试类日志信息。
  63. /// </summary>
  64. /// <param name="format">日志格式。</param>
  65. /// <param name="arg0">日志参数 0。</param>
  66. /// <param name="arg1">日志参数 1。</param>
  67. public static void Debug(string format, object arg0, object arg1)
  68. {
  69. if (s_LogHelper == null)
  70. {
  71. return;
  72. }
  73. s_LogHelper.Log(GameFrameworkLogLevel.Debug, Utility.Text.Format(format, arg0, arg1));
  74. }
  75. /// <summary>
  76. /// 打印调试级别日志,用于记录调试类日志信息。
  77. /// </summary>
  78. /// <param name="format">日志格式。</param>
  79. /// <param name="arg0">日志参数 0。</param>
  80. /// <param name="arg1">日志参数 1。</param>
  81. /// <param name="arg2">日志参数 2。</param>
  82. public static void Debug(string format, object arg0, object arg1, object arg2)
  83. {
  84. if (s_LogHelper == null)
  85. {
  86. return;
  87. }
  88. s_LogHelper.Log(GameFrameworkLogLevel.Debug, Utility.Text.Format(format, arg0, arg1, arg2));
  89. }
  90. /// <summary>
  91. /// 打印调试级别日志,用于记录调试类日志信息。
  92. /// </summary>
  93. /// <param name="format">日志格式。</param>
  94. /// <param name="args">日志参数。</param>
  95. public static void Debug(string format, params object[] args)
  96. {
  97. if (s_LogHelper == null)
  98. {
  99. return;
  100. }
  101. s_LogHelper.Log(GameFrameworkLogLevel.Debug, Utility.Text.Format(format, args));
  102. }
  103. /// <summary>
  104. /// 打印信息级别日志,用于记录程序正常运行日志信息。
  105. /// </summary>
  106. /// <param name="message">日志内容</param>
  107. public static void Info(object message)
  108. {
  109. if (s_LogHelper == null)
  110. {
  111. return;
  112. }
  113. s_LogHelper.Log(GameFrameworkLogLevel.Info, message);
  114. }
  115. /// <summary>
  116. /// 打印信息级别日志,用于记录程序正常运行日志信息。
  117. /// </summary>
  118. /// <param name="message">日志内容</param>
  119. public static void Info(string message)
  120. {
  121. if (s_LogHelper == null)
  122. {
  123. return;
  124. }
  125. s_LogHelper.Log(GameFrameworkLogLevel.Info, message);
  126. }
  127. /// <summary>
  128. /// 打印信息级别日志,用于记录程序正常运行日志信息。
  129. /// </summary>
  130. /// <param name="format">日志格式。</param>
  131. /// <param name="arg0">日志参数 0。</param>
  132. public static void Info(string format, object arg0)
  133. {
  134. if (s_LogHelper == null)
  135. {
  136. return;
  137. }
  138. s_LogHelper.Log(GameFrameworkLogLevel.Info, Utility.Text.Format(format, arg0));
  139. }
  140. /// <summary>
  141. /// 打印信息级别日志,用于记录程序正常运行日志信息。
  142. /// </summary>
  143. /// <param name="format">日志格式。</param>
  144. /// <param name="arg0">日志参数 0。</param>
  145. /// <param name="arg1">日志参数 1。</param>
  146. public static void Info(string format, object arg0, object arg1)
  147. {
  148. if (s_LogHelper == null)
  149. {
  150. return;
  151. }
  152. s_LogHelper.Log(GameFrameworkLogLevel.Info, Utility.Text.Format(format, arg0, arg1));
  153. }
  154. /// <summary>
  155. /// 打印信息级别日志,用于记录程序正常运行日志信息。
  156. /// </summary>
  157. /// <param name="format">日志格式。</param>
  158. /// <param name="arg0">日志参数 0。</param>
  159. /// <param name="arg1">日志参数 1。</param>
  160. /// <param name="arg2">日志参数 2。</param>
  161. public static void Info(string format, object arg0, object arg1, object arg2)
  162. {
  163. if (s_LogHelper == null)
  164. {
  165. return;
  166. }
  167. s_LogHelper.Log(GameFrameworkLogLevel.Info, Utility.Text.Format(format, arg0, arg1, arg2));
  168. }
  169. /// <summary>
  170. /// 打印信息级别日志,用于记录程序正常运行日志信息。
  171. /// </summary>
  172. /// <param name="format">日志格式。</param>
  173. /// <param name="args">日志参数。</param>
  174. public static void Info(string format, params object[] args)
  175. {
  176. if (s_LogHelper == null)
  177. {
  178. return;
  179. }
  180. s_LogHelper.Log(GameFrameworkLogLevel.Info, Utility.Text.Format(format, args));
  181. }
  182. /// <summary>
  183. /// 打印警告级别日志,建议在发生局部功能逻辑错误,但尚不会导致游戏崩溃或异常时使用。
  184. /// </summary>
  185. /// <param name="message">日志内容。</param>
  186. public static void Warning(object message)
  187. {
  188. if (s_LogHelper == null)
  189. {
  190. return;
  191. }
  192. s_LogHelper.Log(GameFrameworkLogLevel.Warning, message);
  193. }
  194. /// <summary>
  195. /// 打印警告级别日志,建议在发生局部功能逻辑错误,但尚不会导致游戏崩溃或异常时使用。
  196. /// </summary>
  197. /// <param name="message">日志内容。</param>
  198. public static void Warning(string message)
  199. {
  200. if (s_LogHelper == null)
  201. {
  202. return;
  203. }
  204. s_LogHelper.Log(GameFrameworkLogLevel.Warning, message);
  205. }
  206. /// <summary>
  207. /// 打印警告级别日志,建议在发生局部功能逻辑错误,但尚不会导致游戏崩溃或异常时使用。
  208. /// </summary>
  209. /// <param name="format">日志格式。</param>
  210. /// <param name="arg0">日志参数 0。</param>
  211. public static void Warning(string format, object arg0)
  212. {
  213. if (s_LogHelper == null)
  214. {
  215. return;
  216. }
  217. s_LogHelper.Log(GameFrameworkLogLevel.Warning, Utility.Text.Format(format, arg0));
  218. }
  219. /// <summary>
  220. /// 打印警告级别日志,建议在发生局部功能逻辑错误,但尚不会导致游戏崩溃或异常时使用。
  221. /// </summary>
  222. /// <param name="format">日志格式。</param>
  223. /// <param name="arg0">日志参数 0。</param>
  224. /// <param name="arg1">日志参数 1。</param>
  225. public static void Warning(string format, object arg0, object arg1)
  226. {
  227. if (s_LogHelper == null)
  228. {
  229. return;
  230. }
  231. s_LogHelper.Log(GameFrameworkLogLevel.Warning, Utility.Text.Format(format, arg0, arg1));
  232. }
  233. /// <summary>
  234. /// 打印警告级别日志,建议在发生局部功能逻辑错误,但尚不会导致游戏崩溃或异常时使用。
  235. /// </summary>
  236. /// <param name="format">日志格式。</param>
  237. /// <param name="arg0">日志参数 0。</param>
  238. /// <param name="arg1">日志参数 1。</param>
  239. /// <param name="arg2">日志参数 2。</param>
  240. public static void Warning(string format, object arg0, object arg1, object arg2)
  241. {
  242. if (s_LogHelper == null)
  243. {
  244. return;
  245. }
  246. s_LogHelper.Log(GameFrameworkLogLevel.Warning, Utility.Text.Format(format, arg0, arg1, arg2));
  247. }
  248. /// <summary>
  249. /// 打印警告级别日志,建议在发生局部功能逻辑错误,但尚不会导致游戏崩溃或异常时使用。
  250. /// </summary>
  251. /// <param name="format">日志格式。</param>
  252. /// <param name="args">日志参数。</param>
  253. public static void Warning(string format, params object[] args)
  254. {
  255. if (s_LogHelper == null)
  256. {
  257. return;
  258. }
  259. s_LogHelper.Log(GameFrameworkLogLevel.Warning, Utility.Text.Format(format, args));
  260. }
  261. /// <summary>
  262. /// 打印错误级别日志,建议在发生功能逻辑错误,但尚不会导致游戏崩溃或异常时使用。
  263. /// </summary>
  264. /// <param name="message">日志内容。</param>
  265. public static void Error(object message)
  266. {
  267. if (s_LogHelper == null)
  268. {
  269. return;
  270. }
  271. s_LogHelper.Log(GameFrameworkLogLevel.Error, message);
  272. }
  273. /// <summary>
  274. /// 打印错误级别日志,建议在发生功能逻辑错误,但尚不会导致游戏崩溃或异常时使用。
  275. /// </summary>
  276. /// <param name="message">日志内容。</param>
  277. public static void Error(string message)
  278. {
  279. if (s_LogHelper == null)
  280. {
  281. return;
  282. }
  283. s_LogHelper.Log(GameFrameworkLogLevel.Error, message);
  284. }
  285. /// <summary>
  286. /// 打印错误级别日志,建议在发生功能逻辑错误,但尚不会导致游戏崩溃或异常时使用。
  287. /// </summary>
  288. /// <param name="format">日志格式。</param>
  289. /// <param name="arg0">日志参数 0。</param>
  290. public static void Error(string format, object arg0)
  291. {
  292. if (s_LogHelper == null)
  293. {
  294. return;
  295. }
  296. s_LogHelper.Log(GameFrameworkLogLevel.Error, Utility.Text.Format(format, arg0));
  297. }
  298. /// <summary>
  299. /// 打印错误级别日志,建议在发生功能逻辑错误,但尚不会导致游戏崩溃或异常时使用。
  300. /// </summary>
  301. /// <param name="format">日志格式。</param>
  302. /// <param name="arg0">日志参数 0。</param>
  303. /// <param name="arg1">日志参数 1。</param>
  304. public static void Error(string format, object arg0, object arg1)
  305. {
  306. if (s_LogHelper == null)
  307. {
  308. return;
  309. }
  310. s_LogHelper.Log(GameFrameworkLogLevel.Error, Utility.Text.Format(format, arg0, arg1));
  311. }
  312. /// <summary>
  313. /// 打印错误级别日志,建议在发生功能逻辑错误,但尚不会导致游戏崩溃或异常时使用。
  314. /// </summary>
  315. /// <param name="format">日志格式。</param>
  316. /// <param name="arg0">日志参数 0。</param>
  317. /// <param name="arg1">日志参数 1。</param>
  318. /// <param name="arg2">日志参数 2。</param>
  319. public static void Error(string format, object arg0, object arg1, object arg2)
  320. {
  321. if (s_LogHelper == null)
  322. {
  323. return;
  324. }
  325. s_LogHelper.Log(GameFrameworkLogLevel.Error, Utility.Text.Format(format, arg0, arg1, arg2));
  326. }
  327. /// <summary>
  328. /// 打印错误级别日志,建议在发生功能逻辑错误,但尚不会导致游戏崩溃或异常时使用。
  329. /// </summary>
  330. /// <param name="format">日志格式。</param>
  331. /// <param name="args">日志参数。</param>
  332. public static void Error(string format, params object[] args)
  333. {
  334. if (s_LogHelper == null)
  335. {
  336. return;
  337. }
  338. s_LogHelper.Log(GameFrameworkLogLevel.Error, Utility.Text.Format(format, args));
  339. }
  340. /// <summary>
  341. /// 打印严重错误级别日志,建议在发生严重错误,可能导致游戏崩溃或异常时使用,此时应尝试重启进程或重建游戏框架。
  342. /// </summary>
  343. /// <param name="message">日志内容。</param>
  344. public static void Fatal(object message)
  345. {
  346. if (s_LogHelper == null)
  347. {
  348. return;
  349. }
  350. s_LogHelper.Log(GameFrameworkLogLevel.Fatal, message);
  351. }
  352. /// <summary>
  353. /// 打印严重错误级别日志,建议在发生严重错误,可能导致游戏崩溃或异常时使用,此时应尝试重启进程或重建游戏框架。
  354. /// </summary>
  355. /// <param name="message">日志内容。</param>
  356. public static void Fatal(string message)
  357. {
  358. if (s_LogHelper == null)
  359. {
  360. return;
  361. }
  362. s_LogHelper.Log(GameFrameworkLogLevel.Fatal, message);
  363. }
  364. /// <summary>
  365. /// 打印严重错误级别日志,建议在发生严重错误,可能导致游戏崩溃或异常时使用,此时应尝试重启进程或重建游戏框架。
  366. /// </summary>
  367. /// <param name="format">日志格式。</param>
  368. /// <param name="arg0">日志参数 0。</param>
  369. public static void Fatal(string format, object arg0)
  370. {
  371. if (s_LogHelper == null)
  372. {
  373. return;
  374. }
  375. s_LogHelper.Log(GameFrameworkLogLevel.Fatal, Utility.Text.Format(format, arg0));
  376. }
  377. /// <summary>
  378. /// 打印严重错误级别日志,建议在发生严重错误,可能导致游戏崩溃或异常时使用,此时应尝试重启进程或重建游戏框架。
  379. /// </summary>
  380. /// <param name="format">日志格式。</param>
  381. /// <param name="arg0">日志参数 0。</param>
  382. /// <param name="arg1">日志参数 1。</param>
  383. public static void Fatal(string format, object arg0, object arg1)
  384. {
  385. if (s_LogHelper == null)
  386. {
  387. return;
  388. }
  389. s_LogHelper.Log(GameFrameworkLogLevel.Fatal, Utility.Text.Format(format, arg0, arg1));
  390. }
  391. /// <summary>
  392. /// 打印严重错误级别日志,建议在发生严重错误,可能导致游戏崩溃或异常时使用,此时应尝试重启进程或重建游戏框架。
  393. /// </summary>
  394. /// <param name="format">日志格式。</param>
  395. /// <param name="arg0">日志参数 0。</param>
  396. /// <param name="arg1">日志参数 1。</param>
  397. /// <param name="arg2">日志参数 2。</param>
  398. public static void Fatal(string format, object arg0, object arg1, object arg2)
  399. {
  400. if (s_LogHelper == null)
  401. {
  402. return;
  403. }
  404. s_LogHelper.Log(GameFrameworkLogLevel.Fatal, Utility.Text.Format(format, arg0, arg1, arg2));
  405. }
  406. /// <summary>
  407. /// 打印严重错误级别日志,建议在发生严重错误,可能导致游戏崩溃或异常时使用,此时应尝试重启进程或重建游戏框架。
  408. /// </summary>
  409. /// <param name="format">日志格式。</param>
  410. /// <param name="args">日志参数。</param>
  411. public static void Fatal(string format, params object[] args)
  412. {
  413. if (s_LogHelper == null)
  414. {
  415. return;
  416. }
  417. s_LogHelper.Log(GameFrameworkLogLevel.Fatal, Utility.Text.Format(format, args));
  418. }
  419. }
  420. }