mirror of
https://github.com/BTMuli/TeyvatGuide.git
synced 2026-03-29 06:09:45 +08:00
210 lines
6.5 KiB
TypeScript
210 lines
6.5 KiB
TypeScript
/**
|
||
* @file request/hk4eReq.ts
|
||
* @description Hk4eApi 请求模块
|
||
* @since Beta v0.8.4
|
||
*/
|
||
|
||
import { AnnoLangEnum } from "@enum/anno.js";
|
||
import { GameServerEnum } from "@enum/game.js";
|
||
import TGHttp from "@utils/TGHttp.js";
|
||
import { getDeviceInfo } from "@utils/toolFunc.js";
|
||
|
||
const AnnoApi: Readonly<string> = "https://hk4e-ann-api.mihoyo.com/common/hk4e_cn/announcement/api";
|
||
const AnnoApiGlobal: Readonly<string> =
|
||
"https://sg-hk4e-api.hoyoverse.com/common/hk4e_global/announcement/api";
|
||
const SdkApi: Readonly<string> = "https://hk4e-sdk.mihoyo.com/hk4e_cn/";
|
||
|
||
/**
|
||
* @description 判断是否为国内服务器
|
||
* @since Beta v0.8.0
|
||
* @param {TGApp.Game.Base.ServerTypeEnum} region 服务器
|
||
* @returns {boolean} 是否为国内服务器
|
||
*/
|
||
function isCN(region: TGApp.Game.Base.ServerTypeEnum): boolean {
|
||
switch (region) {
|
||
case GameServerEnum.CN_QD01:
|
||
case GameServerEnum.CN_GF01:
|
||
return true;
|
||
default:
|
||
return false;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* @description 根据服务器获取公告地址
|
||
* @since Beta v0.8.0
|
||
* @param {TGApp.Game.Base.ServerTypeEnum} region 服务器
|
||
* @returns {string} 公告地址
|
||
*/
|
||
function getAnnoApi(region: TGApp.Game.Base.ServerTypeEnum): string {
|
||
return isCN(region) ? AnnoApi : AnnoApiGlobal;
|
||
}
|
||
|
||
/**
|
||
* @description 获取游戏内公告参数
|
||
* @since Beta v0.8.0
|
||
* @param {TGApp.Game.Base.ServerTypeEnum} region 服务器
|
||
* @param {TGApp.BBS.Announcement.AnnoLangEnum} lang 语言
|
||
* @returns {TGApp.BBS.Announcement.Params}
|
||
*/
|
||
function getAnnoParams(
|
||
region: TGApp.Game.Base.ServerTypeEnum = GameServerEnum.CN_GF01,
|
||
lang: TGApp.BBS.Announcement.AnnoLangEnum = AnnoLangEnum.CHS,
|
||
): TGApp.BBS.Announcement.Params {
|
||
return {
|
||
game: "hk4e",
|
||
game_biz: isCN(region) ? "hk4e_cn" : "hk4e_global",
|
||
lang,
|
||
bundle_id: isCN(region) ? "hk4e_cn" : "hk4e_global",
|
||
platform: "pc",
|
||
region,
|
||
level: "55",
|
||
uid: "100000000",
|
||
};
|
||
}
|
||
|
||
/**
|
||
* @description 获取游戏内公告列表
|
||
* @since Beta v0.8.0
|
||
* @param {TGApp.Game.Base.ServerTypeEnum} region 服务器
|
||
* @param {TGApp.BBS.Announcement.AnnoLangEnum} lang 语言
|
||
* @returns {Promise<TGApp.BBS.Announcement.ListRes>}
|
||
*/
|
||
async function getAnnoList(
|
||
region: TGApp.Game.Base.ServerTypeEnum = GameServerEnum.CN_GF01,
|
||
lang: TGApp.BBS.Announcement.AnnoLangEnum = AnnoLangEnum.CHS,
|
||
): Promise<TGApp.BBS.Announcement.ListRes> {
|
||
const resp = await TGHttp<TGApp.BBS.Announcement.ListResp>(`${getAnnoApi(region)}/getAnnList`, {
|
||
method: "GET",
|
||
query: getAnnoParams(region, lang),
|
||
});
|
||
return resp.data;
|
||
}
|
||
|
||
/**
|
||
* @description 获取游戏内公告内容
|
||
* @since Beta v0.8.0
|
||
* @param {TGApp.Game.Base.ServerTypeEnum} region 服务器
|
||
* @param {TGApp.BBS.Announcement.AnnoLangEnum} lang 语言
|
||
* @returns {Promise<Array<TGApp.BBS.Announcement.AnnoDetail>>}
|
||
*/
|
||
async function getAnnoDetail(
|
||
region: TGApp.Game.Base.ServerTypeEnum = GameServerEnum.CN_GF01,
|
||
lang: TGApp.BBS.Announcement.AnnoLangEnum = AnnoLangEnum.CHS,
|
||
): Promise<Array<TGApp.BBS.Announcement.AnnoDetail>> {
|
||
const resp = await TGHttp<TGApp.BBS.Announcement.DetailResp>(
|
||
`${getAnnoApi(region)}/getAnnContent`,
|
||
{ method: "GET", query: getAnnoParams(region, lang) },
|
||
);
|
||
return resp.data.list;
|
||
}
|
||
|
||
/**
|
||
* @description 获取抽卡记录
|
||
* @since Beta v0.5.0
|
||
* @param {string} authKey authKey
|
||
* @param {string} gachaType 抽卡类型
|
||
* @param {string} endId 结束 id，默认为 0
|
||
* @returns {Promise<TGApp.Game.Gacha.GachaItem[] | TGApp.BBS.Response.Base>} 抽卡记录
|
||
*/
|
||
async function getGachaLog(
|
||
authKey: string,
|
||
gachaType: string,
|
||
endId: string = "0",
|
||
): Promise<TGApp.Game.Gacha.GachaItem[] | TGApp.BBS.Response.Base> {
|
||
const params = {
|
||
lang: "zh-cn",
|
||
auth_appid: "webview_gacha",
|
||
authkey: authKey,
|
||
authkey_ver: "1",
|
||
sign_type: "2",
|
||
gacha_type: gachaType,
|
||
size: "20",
|
||
end_id: endId,
|
||
};
|
||
const resp = await TGHttp<TGApp.Game.Gacha.GachaLogResp | TGApp.BBS.Response.Base>(
|
||
"https://public-operation-hk4e.mihoyo.com/gacha_info/api/getGachaLog",
|
||
{ method: "GET", query: params },
|
||
);
|
||
if (resp.retcode !== 0) return <TGApp.BBS.Response.Base>resp;
|
||
return resp.data.list;
|
||
}
|
||
|
||
/**
|
||
* @description 获取千星奇域抽卡记录
|
||
* @since Beta v0.8.4
|
||
* @param {string} authKey authKey
|
||
* @param {string} gachaType 抽卡类型
|
||
* @param {string} endId 结束 id，默认为 0
|
||
* @returns {Promise<Array<TGApp.Game.Gacha.GachaBItem>|TGApp.BBS.Response.Base>} 抽卡记录
|
||
*/
|
||
async function getBeyondGachaLog(
|
||
authKey: string,
|
||
gachaType: string,
|
||
endId: string = "0",
|
||
): Promise<Array<TGApp.Game.Gacha.GachaBItem> | TGApp.BBS.Response.Base> {
|
||
const params = {
|
||
lang: "zh-cn",
|
||
auth_appid: "webview_gacha",
|
||
authkey: authKey,
|
||
authkey_ver: "1",
|
||
sign_type: "2",
|
||
gacha_type: gachaType,
|
||
size: "5",
|
||
end_id: endId,
|
||
};
|
||
const resp = await TGHttp<TGApp.Game.Gacha.GachaBLogResp | TGApp.BBS.Response.Base>(
|
||
"https://public-operation-hk4e.mihoyo.com/gacha_info/api/getBeyondGachaLog",
|
||
{ method: "GET", query: params },
|
||
);
|
||
if (resp.retcode !== 0) return <TGApp.BBS.Response.Base>resp;
|
||
return resp.data.list;
|
||
}
|
||
|
||
/**
|
||
* @description 获取登录二维码
|
||
* @since Beta v0.7.2
|
||
* @param {string} appId 应用 ID // 目前只有2/7能用
|
||
* @returns {Promise<TGApp.Game.Login.QrRes|TGApp.BBS.Response.Base>}
|
||
*/
|
||
async function fetchPandaQr(
|
||
appId: number,
|
||
): Promise<TGApp.Game.Login.QrRes | TGApp.BBS.Response.Base> {
|
||
const data = { app_id: appId, device: getDeviceInfo("device_id") };
|
||
const resp = await TGHttp<TGApp.Game.Login.QrResp>(`${SdkApi}combo/panda/qrcode/fetch`, {
|
||
method: "POST",
|
||
body: JSON.stringify(data),
|
||
});
|
||
if (resp.retcode !== 0) return <TGApp.BBS.Response.Base>resp;
|
||
return resp.data;
|
||
}
|
||
|
||
/**
|
||
* @description 获取登录状态
|
||
* @since Beta v0.7.2
|
||
* @param {string} ticket 二维码 ticket
|
||
* @param {string} appId 应用 ID
|
||
* @returns {Promise<TGApp.BBS.Response.Base|TGApp.Game.Login.StatusRes>}
|
||
*/
|
||
async function queryPandaQr(
|
||
ticket: string,
|
||
appId: number,
|
||
): Promise<TGApp.BBS.Response.Base | TGApp.Game.Login.StatusRes> {
|
||
const data = { app_id: appId, ticket, device: getDeviceInfo("device_id") };
|
||
const resp = await TGHttp<TGApp.Game.Login.StatusResp>(`${SdkApi}combo/panda/qrcode/query`, {
|
||
method: "POST",
|
||
body: JSON.stringify(data),
|
||
});
|
||
if (resp.retcode !== 0) return <TGApp.BBS.Response.Base>resp;
|
||
return resp.data;
|
||
}
|
||
|
||
const hk4eReq = {
|
||
anno: { list: getAnnoList, detail: getAnnoDetail },
|
||
gacha: getGachaLog,
|
||
gachaB: getBeyondGachaLog,
|
||
loginQr: { create: fetchPandaQr, state: queryPandaQr },
|
||
};
|
||
|
||
export default hk4eReq;
|