技术规格

• 包含 Tuanjie 客户端与本地 ASP.NET Core 服务端完整示例
• 基于 Tuanjie 1.0.0 项目开发
• 服务端目标框架：net10.0
• 采用内存数据存储，便于本地快速开发与调试（无需数据库）
• 清晰的架构分层设计：ServiceApi：接口封装层（Endpoint Wrappers）
  BaseApi：请求构建与日志记录层
  NetworkClient：请求队列、工作线程与策略层
  UnityWebRequestGateway：网络传输层
  

包含的功能组件

身份认证接口

• POST /session/login
• GET /session/data
• POST /jwt/login
• GET /jwt/data
• GET /apikey/data

图书商店（Book Store）接口

• GET /bookstore/books（支持条件筛选）
• GET /bookstore/stores/{storeId}/books/{bookId}
• POST /bookstore/stores/{storeId}/books
• PUT /bookstore/stores/{storeId}/books/{bookId}
• DELETE /bookstore/stores/{storeId}/books/{bookId}

示例内容

身份认证示例场景

• SessionAuth.unity
• JwtAuth.unity
• ApiKeyAuth.unity

图书商店示例场景

• BookStore.unity

编辑器工具

• Tools/Simple JSON RESTful Client/Setup BookStore Scene Buttons

用于自动生成并绑定 BookStore 示例场景中的操作按钮。

测试覆盖

包含完整的 PlayMode 自动化测试：

身份认证测试

• Session 登录流程
• JWT 登录流程
• API Key 认证流程

Book Store 测试

• 接口认证要求验证
• 图书筛选查询
• CRUD 完整生命周期测试

主要特性

高可靠性网络架构

• 请求队列（Request Queue）机制
• Worker 工作线程架构
• 指数退避重试（Exponential Backoff Retry）
• 随机抖动（Jitter）策略
• 熔断器（Circuit Breaker）保护机制

安全稳定的网络通信

• 主线程安全的 Unity HTTP 请求执行
• Token 存储与管理辅助工具
• 多种认证方式支持

结构化响应模型

统一响应结构包含：

• status（状态码）
• body（响应内容）
• headers（响应头）
• network error（网络错误信息）

方便统一处理与调试。

开发与调试友好

• 基于 Inspector 的测试组件（TestApi）
• 响应日志输出与调试支持
• 无需编写额外测试代码即可验证接口

易于扩展

可轻松迁移至其他 Tuanjie 项目：

• 替换接口地址即可接入新服务
• 替换数据模型即可适配新业务
• 保留成熟稳定的网络通信架构

适用于游戏开发、工具软件、教育应用、企业系统以及任何需要 REST API 集成的 Tuanjie 项目。