67 lines
1.6 KiB
Markdown
67 lines
1.6 KiB
Markdown
# 🌐 Net 网络模块
|
||
|
||
适用于 Unity 的网络模块，包含网络检测、接口请求、Token 鉴权、服务器时间同步等功能。模块职责清晰、易扩展，使用前需引入通用模块。
|
||
|
||
------
|
||
|
||
## 📦 模块概览
|
||
|
||
| 模块 | 功能描述 |
|
||
| ---------------- | --------------------------------------------------- |
|
||
| `NetChecker` | 📶 检测网络是否可用，支持 Ping / HTTP 检查 |
|
||
| `NetCore<T>` | 📡 网络请求基类，支持加密和 Token 自动处理（需继承） |
|
||
| `TokenManager` | 🔐 Token 缓存 / 自动刷新 / 登录回退处理 |
|
||
| `ServerClock` | 🕒 同步服务器时间，避免设备本地误差 |
|
||
| `WebSocket 模块` | 依赖 nativewebsocket 插件 |
|
||
|
||
------
|
||
|
||
## ✅ 使用示例
|
||
|
||
### 1. 网络检测
|
||
|
||
```c#
|
||
StartCoroutine(NetChecker.Instance.WaitUntilNetworkConnected(10, 1f, success => {
|
||
if (success) Debug.Log("✅ 网络可用");
|
||
}));
|
||
```
|
||
|
||
------
|
||
|
||
### 2. 实现你的请求类（必须继承 NetCore）
|
||
|
||
```c#
|
||
public class NetKit : NetCore<NetKit> {
|
||
// 详情参考此类
|
||
}
|
||
```
|
||
|
||
------
|
||
|
||
### 3. 发起接口请求（在子类中）
|
||
|
||
```c#
|
||
NetKit.Instance.Post<TrackData>("/event/incrN", trackData,
|
||
response => {
|
||
callback?.Invoke(response.IsSuccess, response.Data);
|
||
});
|
||
```
|
||
|
||
------
|
||
|
||
### 4. Token 获取（自动缓存）
|
||
|
||
```c#
|
||
yield return TokenManager.Instance.GetToken(token => {
|
||
Debug.Log("当前 Token：" + token);
|
||
});
|
||
```
|
||
|
||
------
|
||
|
||
### 5. 服务器时间同步
|
||
|
||
```c#
|
||
ServerClock.Init(serverUnixTime);
|
||
var now = ServerClock.GetCurrentServerTime();
|
||
``` |