♻️ 重构公告模块，降低请求次数

2026-03-19 04:29:45 +08:00 · 2025-06-01 19:31:40 +08:00
parent 33e9704f2d
commit 70a716842f
16 changed files with 419 additions and 234 deletions
--- a/src/enum/anno.ts
+++ b/src/enum/anno.ts
@@ -0,0 +1,98 @@
+/**
+ * @file src/enum/anno.ts
+ * @description 游戏内公告相关枚举
+ * @since Beta v0.7.7
+ */
+
+/**
+ * @description 公告语言类型
+ * @since Beta v0.7.7
+ * @const AnnoLangEnum
+ */
+export const AnnoLangEnum: typeof TGApp.BBS.Announcement.AnnoLang = {
+  CHS: "zh-cn",
+  CHT: "zh-tw",
+  EN: "en",
+  JP: "ja",
+};
+
+/**
+ * @description 获取公告语音描述
+ * @since Beta v0.7.7
+ * @param {TGApp.BBS.Announcement.AnnoLangEnum} lang 公告语言
+ * @return {string} 公告语言描述
+ */
+export function getAnnoLangDesc(lang: TGApp.BBS.Announcement.AnnoLangEnum): string {
+  switch (lang) {
+    case AnnoLangEnum.CHS:
+      return "简体中文";
+    case AnnoLangEnum.CHT:
+      return "繁体中文";
+    case AnnoLangEnum.EN:
+      return "英语";
+    case AnnoLangEnum.JP:
+      return "日语";
+  }
+}
+
+/**
+ * @description 公告服务器类型
+ * @since Beta v0.7.7
+ * @const AnnoServerEnum
+ */
+export const AnnoServerEnum: typeof TGApp.BBS.Announcement.AnnoServer = {
+  CN_GF01: "cn_gf01",
+  CN_QD01: "cn_qd01",
+  OS_USA: "os_usa",
+  OS_EURO: "os_euro",
+  OS_ASIA: "os_asia",
+  OS_CHT: "os_cht",
+};
+
+/**
+ * @description 获取公告服务器描述
+ * @since Beta v0.7.7
+ * @param {TGApp.BBS.Announcement.AnnoServerEnum} server 公告服务器
+ * @return {string} 公告服务器描述
+ */
+export function getAnnoServerDesc(server: TGApp.BBS.Announcement.AnnoServerEnum): string {
+  switch (server) {
+    case AnnoServerEnum.CN_GF01:
+      return "国服-官方服";
+    case AnnoServerEnum.CN_QD01:
+      return "国服-渠道服";
+    case AnnoServerEnum.OS_USA:
+      return "国际服-美服";
+    case AnnoServerEnum.OS_EURO:
+      return "国际服-欧服";
+    case AnnoServerEnum.OS_ASIA:
+      return "国际服-亚服";
+    case AnnoServerEnum.OS_CHT:
+      return "国际服-港澳台服";
+  }
+}
+
+/**
+ * @description 公告类型
+ * @since Beta v0.7.7
+ * @const AnnoTypeEnum
+ */
+export const AnnoTypeEnum: typeof TGApp.BBS.Announcement.AnnoType = {
+  ACTIVITY: "activity",
+  GAME: "game",
+};
+
+/**
+ * @description 获取公告类型描述
+ * @since Beta v0.7.7
+ * @param {TGApp.BBS.Announcement.AnnoTypeEnum} type 公告类型
+ * @return {string} 公告类型描述
+ */
+export function getAnnoTypeDesc(type: TGApp.BBS.Announcement.AnnoTypeEnum): string {
+  switch (type) {
+    case AnnoTypeEnum.ACTIVITY:
+      return "活动公告";
+    case AnnoTypeEnum.GAME:
+      return "游戏公告";
+  }
+}