网络层

2025-08-15 00:36:54 +08:00
parent 80dcd70415
commit 9c67163cfd
28 changed files with 21014 additions and 1382 deletions
@@ -0,0 +1,37 @@
+
+syntax = "proto3";
+option go_package = "./pt";
+package ProtoMsg;
+
+import "error.proto";
+
+//公用消息回复
+message CommonRsp {
+	ErrorCode  	RetCode	= 1;		//错误码，成功的话是0
+	string  ErrMsg	= 2;
+	int32 	MsgId 	= 3;
+	int32 	SubMsgId	= 4;
+	int32  	DataType	= 5;	//数据类型，1：json数据；2：protobuff数据
+	string  Data 		= 6;	//回复数据内容
+}
+
+
+
+enum MsgId {
+	None 		= 0;	//空,不使用
+	Account 	= 1;	//账号相关
+	PlayerData	= 2;	//通用玩家数据
+
+	Admin	 	= 99;	//管理端相关
+}
+
+enum SubMsgId_Account {
+	Account_None 	= 0;	//空,不使用
+	Login 			= 1;	//登录		/login
+}
+
+enum SubMsgId_PlayerData {
+	PlayerData_None = 0;	//空,不使用	
+	QueryPlayerData = 1; //请求好友列表 		/playerdata/query_player_data, QueryPlayerDataReq
+	SavePlayerData 	= 2; //请求新手引导信息 	/playerdata/save_player_data, SavePlayerDataReq
+}
@@ -0,0 +1,28 @@
+
+syntax = "proto3";
+option go_package = "./pt";
+package ProtoMsg;
+
+enum ErrorCode {
+
+	Succeed 	= 0;	//成功
+	TokenWrong 	= 1;	//Token验证失败
+	TokenExpire = 2;	//Token过期
+	SystemFail 	= 3;	//系统错误
+	RequestParamWrong = 4;	//请求参数有误
+	HeaderParamWrong = 5;	//Header参数有误
+	ConfigError = 6;	//配置错误
+	MachineIdentifierNotMathch = 7;	//机器识别码不匹配
+	
+	ModuleNotOpen = 10;	//模块未开启
+	
+	SystemError = 100;	//服务端内部错误,错误原因和描述不固定
+	RewardClaimed = 101;	//奖励已经领取了
+	ItemNotEnough = 102;	//需要的物品不足
+	ItemConfigNotExist = 103;	//物品配置不存在
+	PlayerNotExist 		= 104;	//玩家不存在
+	PlayerLevelNotEnough 	= 105;	//玩家等级不足
+	PlayerNameAlreadyExist 	= 106;	//玩家名字已经存在
+	RewardNotAchieve = 107;	//奖励未达成
+
+}
@@ -1,14 +1,35 @@
+
 syntax = "proto3";
+option go_package = "./pt";
+package ProtoMsg;

-// 登录请求
+
+//请求登录
 message LoginReq {
-  string username = 1; // 用户名
-  string password = 2; // 密码
+	string GameName				= 1;	//游戏名字,作为不同游戏的标识
+    string Identifier 			= 2;	//身份识别码，游客的话是设备号，微信的话是openid，googleplay用户的话是gp平台uid
+    int32 IdentityType 			= 3;	//身份类型，1：游客；2：微信；3：googleplay；4：寰城
+	int32 OperateType			= 4;	//操作类型，1：登录界面；2：断线重连；3：其他
+	string ShareDeposit 		= 5;	//微信邀请分享的寄存内容，如果不是邀请玩家，就填空
+	optional string MachineIdentifier    = 6;	//机器设备名
+	optional string SdkUid		= 7;	//sdk体系的UID，比如寰城
 }

-// 登录响应
-message LoginRes {
-  bool success = 1;    // 是否成功
-  string token = 2;    // 登录成功返回的 token
-  string message = 3;  // 失败时的错误信息
+//登录回复
+message LoginRsp {
+	
+	string GameName		= 1;	//游戏名字
+    string Identifier 	= 2;	//身份识别码，游客的话是设备号，googleplay用户的话是gp平台uid
+    int32 IdentityType 	= 3;	//身份类型，1：游客；2：微信；3：googleplay
+	int32 OperateType	= 4;	//操作类型，1：登录界面；2：断线重连；3：其他
+	int64 Uid 			= 5;	//玩家Uid
+	string Token 		= 6;	//临时有效的token认证
+	int64 ServerTime 	= 7;	//服务端时间戳
+	int32 TimezoneOffset = 8;	//服务器时区
+	string Ip 			= 10;	//公网IP
+	optional string MachineIdentifier   = 11;	//机器设备名
+	optional string SdkUid			= 12;	//sdk体系的UID，比如寰城
+	optional bool IsNewGuide 		= 13;	//是否新手
+	optional bool IsNewRegist 		= 14;	//是否刚注册
+	optional int64 LastLoginTime 	= 15;	//上次登陆时间
 }
@@ -0,0 +1,41 @@
+
+syntax = "proto3";
+option go_package = "./pt";
+package ProtoMsg;
+
+import "google/protobuf/descriptor.proto";
+
+//请求拉取玩家数据
+message QueryPlayerDataReq {
+	bool 	IsAll = 1;	//是否要全部拉取
+	string GameName	= 2;	//游戏名字
+	repeated string DataFlagList = 3;	//IsAll为false时，指定要拉取的数据标识
+	
+}
+
+//返回拉取玩家数据
+message QueryPlayerDataRsp {
+	bool 	IsAll = 1;	//是否要全部拉取
+	string GameName	= 2;	//游戏名字
+	repeated PlayerDataPair PlayerDataList = 3;	// 玩家数据列表
+}
+
+//玩家数据
+message PlayerDataPair {
+	string DataFlag = 1;	//数据标识
+	string Content  = 2;	//数据内容
+}
+
+
+//请求保存玩家数据
+message SavePlayerDataReq {
+	string GameName	= 1;	//游戏名字
+	string DataFlag = 2;	//数据标识
+	string Content  = 3;	//数据内容
+}
+
+//返回保存玩家数据的结果
+message SavePlayerDataRsp {
+	string GameName	= 1;	//游戏名字
+	string DataFlag = 2;	//数据标识
+}
@@ -1,22 +0,0 @@
-syntax = "proto3";
-
-package user;
-
-// 用户信息
-message UserInfo {
-  int32 id = 1;        // 用户ID
-  string nickname = 2; // 昵称
-  string email = 3;    // 邮箱
-}
-
-// 获取用户信息请求
-message GetUserReq {
-  int32 id = 1;        // 要查询的用户ID
-}
-
-// 获取用户信息响应
-message GetUserRes {
-  bool success = 1;    // 是否成功
-  UserInfo data = 2;   // 用户数据
-  string message = 3;  // 错误信息
-}
@@ -1,109 +0,0 @@
-/**
- * Http管理器
- * 
- */
-
-import { sys } from "cc";
-import SubManager from "../../Sub/SubManager";
-
-export class HttpManager {
-    private static _I: HttpManager | null = null;
-    public static get I(): HttpManager {
-        if (!HttpManager._I) HttpManager._I = new HttpManager();
-        return HttpManager._I;
-    }
-
-    private constructor() {}
-
-    /**
-     * 发送请求
-     * @param url 接口地址
-     * @param data 消息字符串 (json格式)
-     * @param method 请求方式
-     * @param bLock 是否锁定屏幕
-     * @param formData 是否formData
-     * @returns 
-     */
-    public async send(url: string, data: any, method: "GET" | "POST" | "PUT" = "GET") {
-        console.log("[Http] 请求Url:",url, " 方式:", method, " 数据:", data);
-        var xhr = new XMLHttpRequest();
-        xhr.timeout = 10000;
-        if (method == 'GET') {
-            url = url + encodeURI(this.jsonToQueryString(data));
-            xhr.open(method, url, true);
-            if (sys.isNative) {
-                xhr.setRequestHeader("Accept-Encoding", "gzip,deflate");
-                xhr.setRequestHeader("content-type", "text/html;charset=utf-8");
-            }
-        } else {
-            xhr.open(method, url, true);
-            xhr.setRequestHeader("Content-type", "application/json");
-        }
-        let self = this;
-        return new Promise((resolve, reason) => {
-            self.quest(xhr, method, data).then(value => {
-                resolve(value);
-            }).catch(err => {
-                resolve(null);
-            });
-        });
-
-    } 
-    
-    /**
-     * 把对象转 ?a=1&b=2 的查询串
-     */    
-    private jsonToQueryString(json: any) {
-        var str = '';
-        if (typeof json == "object") {
-            str = "?";
-            for (var k in json) {
-                if (str != "?") {
-                    str += "&";
-                }
-                str += encodeURIComponent(k) + "=" + encodeURIComponent(json[k]);
-            }
-        }
-        return str;
-    }      
-
-    /**
-     * 统一封装 XHR 的发送与状态回调
-     */       
-    private async quest(xhr: XMLHttpRequest, method: "GET" | "POST" | "PUT" = "GET", data: Object) {
-        return new Promise((resolve, reason) => {
-            xhr.onreadystatechange = () => {
-                if (xhr.readyState == 4) {
-                    if (xhr.status >= 200 && xhr.status < 300) {
-                        console.log("[Http] 返回", xhr.response);
-                        try {
-                            resolve(JSON.parse(xhr.response));
-                        } catch (e) {
-                            reason(e);
-                        }                                        
-                    } else {
-                        reason(xhr.status)
-                    }
-                }
-            };
-            xhr.onerror = (error) => {
-                console.error("http request onerror");
-                SubManager.ShowPrompt("网络错误，请检查网络连接");
-                reason(error)
-            };
-            xhr.ontimeout = (e) => {
-                console.error("http request timeout");
-                SubManager.ShowPrompt("网络错误，请检查网络连接");
-                reason(e)
-            }
-            //根据POST和GET方式，选择是否发送msg数据
-            if (method == 'POST') {
-                xhr.send(JSON.stringify(data));
-            } else if (method == 'PUT') {
-                xhr.send(JSON.stringify(data));
-            } else {
-                xhr.send();
-            }
-        });
-    }
-}
@@ -6,6 +6,13 @@ import { BaseData } from "./BaseData";
 export class LoginData extends BaseData {
    // 登录状态：0未登录 1登录中 2已登录
    private _loginState = 0;
+    // token
+    private _token = "";
+
+    /**是否已登录成功 */
+    public isLogin(): boolean {
+        return this._loginState === 2;
+    }

    /** 设置登录状态 */
    public setLoginState(state: number): void {
@@ -17,9 +24,14 @@ export class LoginData extends BaseData {
        return this._loginState;
    }

-    /**是否已登录成功 */
-    public isLogin(): boolean {
-        return this._loginState === 2;
+    /** 设置登录token */
+    public setToken(token: string): void {
+        this._token = token;
+    }
+
+    /** 获取登录token */
+    public getToken(): string {
+        return this._token;
    }    

    public reset(): void {
@@ -0,0 +1,9 @@
+{
+  "ver": "1.2.0",
+  "importer": "directory",
+  "imported": true,
+  "uuid": "3bd0a57e-1aa4-4a82-a6a6-b8b7ea86929f",
+  "files": [],
+  "subMetas": {},
+  "userData": {}
+}
@@ -0,0 +1,9 @@
+{
+  "ver": "1.2.0",
+  "importer": "directory",
+  "imported": true,
+  "uuid": "12bc03b2-c6a3-4f19-afd9-5b48aa490068",
+  "files": [],
+  "subMetas": {},
+  "userData": {}
+}
@@ -0,0 +1,86 @@
+
+import { HttpManager, HttpMethod } from "../transport/HttpManager";
+import { JsonCodec } from "../codec/JsonCodec";
+import { ProtoCodec } from "../codec/ProtoCodec";
+import type { Endpoint } from "./endpoints";
+import { ApiCode, type ApiResponse } from "./types";
+import { DataManager, DataId } from "db://assets/Scripts/chat18x/data/DataManager";
+import { LoginData } from "db://assets/Scripts/chat18x/data/LoginData";
+
+export class ApiClient {
+  private static _I: ApiClient | null = null;
+  public static get I(): ApiClient {
+    if (!ApiClient._I) ApiClient._I = new ApiClient();
+    return ApiClient._I;
+  }
+  private constructor(private http = HttpManager.I) {}
+  // TODO
+  private get baseUrl() { return "http://43.139.27.67:8081" }
+  private get token()   { return DataManager.I.getDataById<LoginData>(DataId.Login).getToken();}
+
+  public async call<Req, Res>(ep: Endpoint<Req, Res>, req: Req): Promise<ApiResponse<Res>> {
+    const url = `${this.baseUrl}/${ep.path.replace(/^\/+/, "")}`;
+    const headers: Record<string, string> = {};
+    let responseType: XMLHttpRequestResponseType | undefined;
+    let rawBody: XMLHttpRequestBodyInit | null | undefined;
+    let jsonData: any;
+
+    if (ep.needsAuth && this.token) {
+      headers["Authorization"] = `Bearer ${this.token}`;
+    }
+
+    // 编码
+    if (ep.codec === "json") {
+      jsonData = (ep.method === "GET") ? req : JsonCodec.encode(req);
+      if (ep.method !== "GET") headers["Content-Type"] = "application/json";
+    } else if (ep.codec === "proto") {
+      if (!ep.reqType || !ep.resType) {
+        return { code: ApiCode.UNKNOWN, msg: "proto types missing" };
+      }
+      rawBody = ProtoCodec.encode(ep.reqType, req);
+      headers["Content-Type"] = "application/x-protobuf";
+      headers["Accept"] = "application/x-protobuf";
+      responseType = "arraybuffer";
+    }
+
+    // 发送
+    const r = await this.http.request(url, jsonData, ep.method, { headers, responseType, rawBody });
+
+    // HTTP/网络错误 → 统一返回
+    if (!r.ok) {
+      if (r.status === 401) {
+        return { code: ApiCode.AUTH_EXPIRED, msg: "auth expired" };
+      }
+      if (r.error === "timeout") {
+        return { code: ApiCode.TIMEOUT, msg: "request timeout" };
+      }
+      if (r.error === "network") {
+        return { code: ApiCode.NETWORK_ERROR, msg: "network error" };
+      }
+      return { code: ApiCode.HTTP_ERROR, msg: `http error: ${r.status}` };
+    }
+
+    // 解码 + 统一化
+    try {
+      if (ep.codec === "json") {
+        const parsed = JsonCodec.decode<any>(r.body);
+        // 如果后端本来就返回 {code,msg,data}，直接透传（并确保有默认 msg）
+        if (parsed && typeof parsed === "object" && typeof parsed.code === "number") {
+          return {
+            code: parsed.code,
+            msg: parsed.msg ?? (parsed.code === 1 ? "ok" : "error"),
+            data: parsed.data as Res
+          };
+        }
+        // 否则我们包一层
+        return { code: ApiCode.OK, msg: "ok", data: parsed as Res };
+      } else if (ep.codec === "proto") {
+        const data = ProtoCodec.decode<Res>(ep.resType!, r.body);
+        // proto 场景一般没有 {code,msg} 包装，我们统一包一层
+        return { code: ApiCode.OK, msg: "ok", data };
+      }
+    } catch (e) {
+      return { code: ApiCode.DECODE_ERROR, msg: "decode error" };
+    }
+  }
+}
@@ -0,0 +1,9 @@
+{
+  "ver": "4.0.24",
+  "importer": "typescript",
+  "imported": true,
+  "uuid": "4e1d0cf6-8eff-4227-8fde-3233d639e798",
+  "files": [],
+  "subMetas": {},
+  "userData": {}
+}
@@ -0,0 +1,14 @@
+import type { Type } from "protobufjs";
+import type { HttpMethod } from "../transport/HttpManager";
+
+export type CodecKind = "json" | "proto";
+
+export interface Endpoint<Req, Res> {
+  path: string;
+  method: HttpMethod;
+  codec: CodecKind;
+  reqType?: Type;   // codec=proto 时必填
+  resType?: Type;   // codec=proto 时必填
+  needsAuth?: boolean;
+  lock?: boolean;
+}
@@ -0,0 +1,9 @@
+{
+  "ver": "4.0.24",
+  "importer": "typescript",
+  "imported": true,
+  "uuid": "02c8cc0b-86fa-486d-8b9e-8729aaa5ec19",
+  "files": [],
+  "subMetas": {},
+  "userData": {}
+}
@@ -0,0 +1,15 @@
+export interface ApiResponse<T = any> {
+    code: number;   // 1 表示成功；其他为错误
+    msg: string;
+    data?: T;
+  }
+  
+  export const ApiCode = {
+    OK: 1,
+    AUTH_EXPIRED: -401,
+    HTTP_ERROR: -400,
+    TIMEOUT: -408,
+    NETWORK_ERROR: -499,
+    DECODE_ERROR: -600,
+    UNKNOWN: -700,
+  } as const;
@@ -0,0 +1,9 @@
+{
+  "ver": "4.0.24",
+  "importer": "typescript",
+  "imported": true,
+  "uuid": "5027239d-2468-4562-bd01-87ffae8e96a1",
+  "files": [],
+  "subMetas": {},
+  "userData": {}
+}
@@ -0,0 +1,9 @@
+{
+  "ver": "1.2.0",
+  "importer": "directory",
+  "imported": true,
+  "uuid": "27ff0e59-c502-4120-8258-3981a4b1e51d",
+  "files": [],
+  "subMetas": {},
+  "userData": {}
+}
@@ -0,0 +1,14 @@
+export const JsonCodec = {
+    /** POST/PUT 的请求体直接用对象，让传输层序列化为 JSON */
+    encode<T = any>(obj: T): any {
+      return obj ?? {};
+    },
+  
+    /** 根据传输层返回的类型做解码：string → JSON.parse，其他直接返回 */
+    decode<T = any>(resp: any): T {
+      if (typeof resp === "string") {
+        try { return JSON.parse(resp) as T; } catch { /* 可能是纯文本 */ }
+      }
+      return resp as T;
+    }
+  };
@@ -0,0 +1,9 @@
+{
+  "ver": "4.0.24",
+  "importer": "typescript",
+  "imported": true,
+  "uuid": "4d188874-4871-46e7-bc80-a179ae1ed67a",
+  "files": [],
+  "subMetas": {},
+  "userData": {}
+}
@@ -0,0 +1,14 @@
+import type { Type } from "protobufjs";
+
+export const ProtoCodec = {
+  encode(reqType: Type, obj: any): Uint8Array {
+    const err = reqType.verify(obj);
+    if (err) throw Error(err);
+    return reqType.encode(reqType.create(obj)).finish();
+  },
+
+  decode<T = any>(resType: Type, buf: ArrayBuffer | Uint8Array): T {
+    const u8 = buf instanceof Uint8Array ? buf : new Uint8Array(buf);
+    return resType.decode(u8) as unknown as T;
+  }
+};
@@ -0,0 +1,9 @@
+{
+  "ver": "4.0.24",
+  "importer": "typescript",
+  "imported": true,
+  "uuid": "7e271138-d20e-4236-8355-ca4bcec0a23e",
+  "files": [],
+  "subMetas": {},
+  "userData": {}
+}
@@ -0,0 +1,9 @@
+{
+  "ver": "1.2.0",
+  "importer": "directory",
+  "imported": true,
+  "uuid": "b0d9acd9-4ee1-40ec-857b-f1fbc5def44e",
+  "files": [],
+  "subMetas": {},
+  "userData": {}
+}
@@ -0,0 +1,25 @@
+import { ApiClient } from "../client/ApiClient";
+import type { Endpoint } from "../client/endpoints";
+import type { ApiResponse } from "../client/types";
+import proto from 'db://assets/Scripts/proto/proto.pb.js';
+
+export class AuthService {
+  private static _I: AuthService | null = null;
+  public static get I(): AuthService {
+    if (!AuthService._I) AuthService._I = new AuthService();
+    return AuthService._I;
+  }
+  private constructor(private api = ApiClient.I) {}
+
+  private EP_LOGIN: Endpoint<proto.ProtoMsg.ILoginReq, proto.ProtoMsg.ILoginRsp> = {
+    path: "login",
+    method: "POST",
+    codec: "json",
+    needsAuth: false
+  };
+
+  // 登录
+  public async login(req: proto.ProtoMsg.ILoginReq): Promise<ApiResponse<proto.ProtoMsg.ILoginRsp>> {
+    return this.api.call(this.EP_LOGIN, req);
+  }
+}
@@ -0,0 +1,9 @@
+{
+  "ver": "4.0.24",
+  "importer": "typescript",
+  "imported": true,
+  "uuid": "e7586869-13fe-4207-960b-eb1be7081812",
+  "files": [],
+  "subMetas": {},
+  "userData": {}
+}
@@ -0,0 +1,9 @@
+{
+  "ver": "1.2.0",
+  "importer": "directory",
+  "imported": true,
+  "uuid": "426aac6d-7382-44fa-a017-3390f3412e96",
+  "files": [],
+  "subMetas": {},
+  "userData": {}
+}
@@ -0,0 +1,102 @@
+/**
+ * Http管理器
+ * 
+ */
+
+import { sys } from "cc";
+import SubManager from 'db://assets/Scripts/Sub/SubManager';
+
+// 请求类型
+export type HttpMethod = "GET" | "POST" | "PUT";
+// 请求参数结构
+export interface HttpSendOptions {
+  headers?: Record<string, string>;
+  responseType?: XMLHttpRequestResponseType;
+  rawBody?: Document | XMLHttpRequestBodyInit | null;
+}
+// 响应结构
+export interface HttpRawResponse {
+  ok: boolean;              // 是否 2xx
+  status: number;           // HTTP 状态码，网络错误/超时为 0
+  body?: any;               // xhr.response 或 xhr.responseText
+  error?: "timeout" | "network" | "http";
+}
+
+export class HttpManager {
+  private static _I: HttpManager | null = null;
+  public static get I(): HttpManager {
+    if (!HttpManager._I) HttpManager._I = new HttpManager();
+    return HttpManager._I;
+  }
+  private constructor() {}
+
+  /** 发起请求，供 ApiClient 使用 */
+  public async request(
+    url: string,
+    data: any,
+    method: HttpMethod = "GET",
+    opt: HttpSendOptions = {}
+  ): Promise<HttpRawResponse> {
+    const xhr = new XMLHttpRequest();
+    // 超时
+    xhr.timeout = 10000;
+    // 响应类型
+    if (opt.responseType) xhr.responseType = opt.responseType;
+
+    if (method === "GET") {
+      url = url + this.buildQuery(data);
+      xhr.open(method, url, true);
+      if (sys.isNative) {
+        xhr.setRequestHeader("Accept-Encoding", "gzip,deflate");
+        xhr.setRequestHeader("content-type", "text/html;charset=utf-8");
+      }
+    } else {
+      xhr.open(method, url, true);
+      if (!opt.rawBody) {
+        xhr.setRequestHeader("Content-Type", "application/json");
+      }
+    }
+    if (opt.headers) {
+      Object.keys(opt.headers).forEach(k => xhr.setRequestHeader(k, opt.headers![k]));
+    }
+
+    return new Promise<HttpRawResponse>((resolve) => {
+      xhr.onreadystatechange = () => {
+        if (xhr.readyState === 4) {
+          const ok = xhr.status >= 200 && xhr.status < 300;
+          const body = xhr.response ?? xhr.responseText ?? null;
+          if (!ok) {
+            SubManager.ShowPrompt(`网络错误(${xhr.status})，请稍后再试`);
+          }
+          resolve({ ok, status: xhr.status, body, error: ok ? undefined : "http" });
+        }
+      };
+      xhr.onerror = () => {
+        SubManager.ShowPrompt("网络错误，请检查网络连接");
+        resolve({ ok: false, status: 0, error: "network" });
+      };
+      xhr.ontimeout = () => {
+        SubManager.ShowPrompt("请求超时，请检查网络连接");
+        resolve({ ok: false, status: 0, error: "timeout" });
+      };
+
+      if (method === "GET") {
+        xhr.send();
+      } else {
+        if (opt.rawBody !== undefined) xhr.send(opt.rawBody ?? null);
+        else xhr.send(JSON.stringify(data ?? {}));
+      }
+    });
+  }
+
+  /**
+   * 把对象转 ?a=1&b=2 的查询串
+   */  
+  private buildQuery(json: any) {
+    if (!json || typeof json !== "object") return "";
+    const pairs = Object.keys(json).map(
+      k => encodeURIComponent(k) + "=" + encodeURIComponent(json[k])
+    );
+    return pairs.length ? "?" + pairs.join("&") : "";
+  }
+}
@@ -2,7 +2,7 @@
  "ver": "4.0.24",
  "importer": "typescript",
  "imported": true,
-  "uuid": "eb6b309f-5c22-4099-99e2-693408d2a959",
+  "uuid": "3be6cfe1-3205-4d3e-b00a-bdba016b2493",
  "files": [],
  "subMetas": {},
  "userData": {}