You can not select more than 25 topics Topics must start with a chinese character,a letter or number, can include dashes ('-') and can be up to 35 characters long.

API.h 19 kB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486
  1. #pragma once
  2. #ifndef API_H
  3. #define API_H
  4. #ifdef _MSC_VER
  5. #pragma warning(disable : 4996)
  6. #endif
  7. #include "Message2Server.pb.h"
  8. #include "Message2Clients.pb.h"
  9. #include "MessageType.pb.h"
  10. #include "Services.grpc.pb.h"
  11. #include "Services.pb.h"
  12. #include <future>
  13. #include <iostream>
  14. #include <vector>
  15. #include <optional>
  16. #include <spdlog/spdlog.h>
  17. #include <spdlog/sinks/basic_file_sink.h>
  18. #include <spdlog/sinks/stdout_color_sinks.h>
  19. #include "structures.h"
  20. const constexpr int numOfGridPerCell = 1000;
  21. class IAI;
  22. class ILogic
  23. {
  24. // API中依赖Logic的部分
  25. public:
  26. // 获取服务器发来的消息
  27. [[nodiscard]] virtual std::vector<std::shared_ptr<const THUAI6::Tricker>> GetTrickers() const = 0;
  28. [[nodiscard]] virtual std::vector<std::shared_ptr<const THUAI6::Student>> GetStudents() const = 0;
  29. [[nodiscard]] virtual std::vector<std::shared_ptr<const THUAI6::Prop>> GetProps() const = 0;
  30. [[nodiscard]] virtual std::shared_ptr<const THUAI6::Student> StudentGetSelfInfo() const = 0;
  31. [[nodiscard]] virtual std::shared_ptr<const THUAI6::Tricker> TrickerGetSelfInfo() const = 0;
  32. [[nodiscard]] virtual std::vector<std::vector<THUAI6::PlaceType>> GetFullMap() const = 0;
  33. [[nodiscard]] virtual THUAI6::PlaceType GetPlaceType(int32_t cellX, int32_t cellY) const = 0;
  34. [[nodiscard]] virtual int32_t GetClassroomProgress(int32_t cellX, int32_t cellY) const = 0;
  35. [[nodiscard]] virtual int32_t GetChestProgress(int32_t cellX, int32_t cellY) const = 0;
  36. [[nodiscard]] virtual int32_t GetGateProgress(int32_t cellX, int32_t cellY) const = 0;
  37. [[nodiscard]] virtual bool IsDoorOpen(int32_t cellX, int32_t cellY) const = 0;
  38. [[nodiscard]] virtual std::shared_ptr<const THUAI6::GameInfo> GetGameInfo() const = 0;
  39. // 供IAPI使用的操作相关的部分
  40. virtual bool Move(int64_t time, double angle) = 0;
  41. virtual bool PickProp(THUAI6::PropType prop) = 0;
  42. virtual bool UseProp(THUAI6::PropType prop) = 0;
  43. virtual bool UseSkill(int32_t skillID) = 0;
  44. virtual bool SendMessage(int64_t toID, std::string message) = 0;
  45. virtual bool HaveMessage() = 0;
  46. virtual std::optional<std::pair<int64_t, std::string>> GetMessage() = 0;
  47. virtual bool WaitThread() = 0;
  48. virtual int GetCounter() const = 0;
  49. // IStudentAPI使用的部分
  50. virtual bool Graduate() = 0;
  51. virtual bool StartLearning() = 0;
  52. virtual bool StartTreatMate() = 0;
  53. virtual bool StartRescueMate() = 0;
  54. virtual bool OpenDoor() = 0;
  55. virtual bool CloseDoor() = 0;
  56. virtual bool SkipWindow() = 0;
  57. virtual bool StartOpenGate() = 0;
  58. virtual bool StartOpenChest() = 0;
  59. virtual bool EndAllAction() = 0;
  60. // ITrickerAPI使用的部分
  61. virtual bool Attack(double angle) = 0;
  62. virtual std::vector<int64_t> GetPlayerGUIDs() const = 0;
  63. };
  64. class IAPI
  65. {
  66. public:
  67. // 选手可执行的操作,应当保证所有函数的返回值都应当为std::future,例如下面的移动函数:
  68. // 指挥本角色进行移动,`timeInMilliseconds` 为移动时间,单位为毫秒;`angleInRadian` 表示移动的方向,单位是弧度,使用极坐标——竖直向下方向为 x 轴,水平向右方向为 y 轴
  69. virtual std::future<bool> Move(int64_t timeInMilliseconds, double angleInRadian) = 0;
  70. // 向特定方向移动
  71. virtual std::future<bool> MoveRight(int64_t timeInMilliseconds) = 0;
  72. virtual std::future<bool> MoveUp(int64_t timeInMilliseconds) = 0;
  73. virtual std::future<bool> MoveLeft(int64_t timeInMilliseconds) = 0;
  74. virtual std::future<bool> MoveDown(int64_t timeInMilliseconds) = 0;
  75. // 捡道具、使用技能
  76. virtual std::future<bool> PickProp(THUAI6::PropType prop) = 0;
  77. virtual std::future<bool> UseProp(THUAI6::PropType prop) = 0;
  78. virtual std::future<bool> UseSkill(int32_t skillID) = 0;
  79. virtual std::future<bool> Attack(double angleInRadian) = 0;
  80. virtual std::future<bool> OpenDoor() = 0;
  81. virtual std::future<bool> CloseDoor() = 0;
  82. virtual std::future<bool> SkipWindow() = 0;
  83. virtual std::future<bool> StartOpenGate() = 0;
  84. virtual std::future<bool> StartOpenChest() = 0;
  85. virtual std::future<bool> EndAllAction() = 0;
  86. // 发送信息、接受信息,注意收消息时无消息则返回nullopt
  87. virtual std::future<bool> SendMessage(int64_t, std::string) = 0;
  88. [[nodiscard]] virtual std::future<bool> HaveMessage() = 0;
  89. [[nodiscard]] virtual std::future<std::optional<std::pair<int64_t, std::string>>> GetMessage() = 0;
  90. // 等待下一帧
  91. virtual std::future<bool> Wait() = 0;
  92. // 获取视野内可见的学生/捣蛋鬼的信息
  93. [[nodiscard]] virtual std::vector<std::shared_ptr<const THUAI6::Student>> GetStudents() const = 0;
  94. [[nodiscard]] virtual std::vector<std::shared_ptr<const THUAI6::Tricker>> GetTrickers() const = 0;
  95. // 获取视野内可见的道具信息
  96. [[nodiscard]] virtual std::vector<std::shared_ptr<const THUAI6::Prop>> GetProps() const = 0;
  97. // 获取地图信息,视野外的地图统一为Land
  98. [[nodiscard]] virtual std::vector<std::vector<THUAI6::PlaceType>> GetFullMap() const = 0;
  99. [[nodiscard]] virtual THUAI6::PlaceType GetPlaceType(int32_t cellX, int32_t cellY) const = 0;
  100. [[nodiscard]] virtual bool IsDoorOpen(int32_t cellX, int32_t cellY) const = 0;
  101. [[nodiscard]] virtual int32_t GetChestProgress(int32_t cellX, int32_t cellY) const = 0;
  102. [[nodiscard]] virtual int32_t GetGateProgress(int32_t cellX, int32_t cellY) const = 0;
  103. [[nodiscard]] virtual int32_t GetClassroomProgress(int32_t cellX, int32_t cellY) const = 0;
  104. [[nodiscard]] virtual std::shared_ptr<const THUAI6::GameInfo> GetGameInfo() const = 0;
  105. // 获取所有玩家的GUID
  106. [[nodiscard]] virtual std::vector<int64_t> GetPlayerGUIDs() const = 0;
  107. // 获取游戏目前所进行的帧数
  108. [[nodiscard]] virtual int GetFrameCount() const = 0;
  109. /*****选手可能用的辅助函数*****/
  110. // 获取指定格子中心的坐标
  111. [[nodiscard]] static inline int CellToGrid(int cell) noexcept
  112. {
  113. return cell * numOfGridPerCell + numOfGridPerCell / 2;
  114. }
  115. // 获取指定坐标点所位于的格子的 X 序号
  116. [[nodiscard]] static inline int GridToCell(int grid) noexcept
  117. {
  118. return grid / numOfGridPerCell;
  119. }
  120. // 用于DEBUG的输出函数,选手仅在开启Debug模式的情况下可以使用
  121. virtual void PrintStudent() const = 0;
  122. virtual void PrintTricker() const = 0;
  123. virtual void PrintProp() const = 0;
  124. virtual void PrintSelfInfo() const = 0;
  125. };
  126. class IStudentAPI : public IAPI
  127. {
  128. public:
  129. /*****学生阵营的特定函数*****/
  130. virtual std::future<bool> StartLearning() = 0;
  131. virtual std::future<bool> StartTreatMate() = 0;
  132. virtual std::future<bool> StartRescueMate() = 0;
  133. virtual std::future<bool> Graduate() = 0;
  134. [[nodiscard]] virtual std::shared_ptr<const THUAI6::Student> GetSelfInfo() const = 0;
  135. };
  136. class ITrickerAPI : public IAPI
  137. {
  138. public:
  139. /*****捣蛋鬼阵营的特定函数*****/
  140. [[nodiscard]] virtual std::shared_ptr<const THUAI6::Tricker> GetSelfInfo() const = 0;
  141. };
  142. class IGameTimer
  143. {
  144. public:
  145. virtual ~IGameTimer() = default;
  146. virtual void StartTimer() = 0;
  147. virtual void EndTimer() = 0;
  148. virtual void Play(IAI& ai) = 0;
  149. };
  150. class StudentAPI : public IStudentAPI, public IGameTimer
  151. {
  152. public:
  153. StudentAPI(ILogic& logic) :
  154. logic(logic)
  155. {
  156. }
  157. void StartTimer() override
  158. {
  159. }
  160. void EndTimer() override
  161. {
  162. }
  163. void Play(IAI& ai) override;
  164. [[nodiscard]] int GetFrameCount() const override;
  165. std::future<bool> Move(int64_t timeInMilliseconds, double angleInRadian) override;
  166. std::future<bool> MoveRight(int64_t timeInMilliseconds) override;
  167. std::future<bool> MoveUp(int64_t timeInMilliseconds) override;
  168. std::future<bool> MoveLeft(int64_t timeInMilliseconds) override;
  169. std::future<bool> MoveDown(int64_t timeInMilliseconds) override;
  170. std::future<bool> PickProp(THUAI6::PropType prop) override;
  171. std::future<bool> UseProp(THUAI6::PropType prop) override;
  172. std::future<bool> UseSkill(int32_t skillID) override;
  173. std::future<bool> Attack(double angleInRadian) override;
  174. std::future<bool> OpenDoor() override;
  175. std::future<bool> CloseDoor() override;
  176. std::future<bool> SkipWindow() override;
  177. std::future<bool> StartOpenGate() override;
  178. std::future<bool> StartOpenChest() override;
  179. std::future<bool> EndAllAction() override;
  180. std::future<bool> SendMessage(int64_t, std::string) override;
  181. [[nodiscard]] std::future<bool> HaveMessage() override;
  182. [[nodiscard]] std::future<std::optional<std::pair<int64_t, std::string>>> GetMessage() override;
  183. std::future<bool> Wait() override;
  184. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Student>> GetStudents() const override;
  185. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Tricker>> GetTrickers() const override;
  186. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Prop>> GetProps() const override;
  187. [[nodiscard]] std::vector<std::vector<THUAI6::PlaceType>> GetFullMap() const override;
  188. [[nodiscard]] THUAI6::PlaceType GetPlaceType(int32_t cellX, int32_t cellY) const override;
  189. [[nodiscard]] bool IsDoorOpen(int32_t cellX, int32_t cellY) const override;
  190. [[nodiscard]] int32_t GetChestProgress(int32_t cellX, int32_t cellY) const override;
  191. [[nodiscard]] int32_t GetGateProgress(int32_t cellX, int32_t cellY) const override;
  192. [[nodiscard]] int32_t GetClassroomProgress(int32_t cellX, int32_t cellY) const override;
  193. [[nodiscard]] std::shared_ptr<const THUAI6::GameInfo> GetGameInfo() const override;
  194. [[nodiscard]] std::vector<int64_t> GetPlayerGUIDs() const override;
  195. std::future<bool> StartLearning() override;
  196. std::future<bool> StartTreatMate() override;
  197. std::future<bool> StartRescueMate() override;
  198. std::future<bool> Graduate() override;
  199. [[nodiscard]] std::shared_ptr<const THUAI6::Student> GetSelfInfo() const override;
  200. void PrintStudent() const override
  201. {
  202. }
  203. void PrintTricker() const override
  204. {
  205. }
  206. void PrintProp() const override
  207. {
  208. }
  209. void PrintSelfInfo() const override
  210. {
  211. }
  212. private:
  213. ILogic& logic;
  214. };
  215. class TrickerAPI : public ITrickerAPI, public IGameTimer
  216. {
  217. public:
  218. TrickerAPI(ILogic& logic) :
  219. logic(logic)
  220. {
  221. }
  222. void StartTimer() override
  223. {
  224. }
  225. void EndTimer() override
  226. {
  227. }
  228. void Play(IAI& ai) override;
  229. [[nodiscard]] int GetFrameCount() const override;
  230. std::future<bool> Move(int64_t timeInMilliseconds, double angleInRadian) override;
  231. std::future<bool> MoveRight(int64_t timeInMilliseconds) override;
  232. std::future<bool> MoveUp(int64_t timeInMilliseconds) override;
  233. std::future<bool> MoveLeft(int64_t timeInMilliseconds) override;
  234. std::future<bool> MoveDown(int64_t timeInMilliseconds) override;
  235. std::future<bool> PickProp(THUAI6::PropType prop) override;
  236. std::future<bool> UseProp(THUAI6::PropType prop) override;
  237. std::future<bool> UseSkill(int32_t skillID) override;
  238. std::future<bool> OpenDoor() override;
  239. std::future<bool> CloseDoor() override;
  240. std::future<bool> SkipWindow() override;
  241. std::future<bool> StartOpenGate() override;
  242. std::future<bool> StartOpenChest() override;
  243. std::future<bool> EndAllAction() override;
  244. std::future<bool> SendMessage(int64_t, std::string) override;
  245. [[nodiscard]] std::future<bool> HaveMessage() override;
  246. [[nodiscard]] std::future<std::optional<std::pair<int64_t, std::string>>> GetMessage() override;
  247. std::future<bool> Wait() override;
  248. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Student>> GetStudents() const override;
  249. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Tricker>> GetTrickers() const override;
  250. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Prop>> GetProps() const override;
  251. [[nodiscard]] std::vector<std::vector<THUAI6::PlaceType>> GetFullMap() const override;
  252. [[nodiscard]] THUAI6::PlaceType GetPlaceType(int32_t cellX, int32_t cellY) const override;
  253. [[nodiscard]] bool IsDoorOpen(int32_t cellX, int32_t cellY) const override;
  254. [[nodiscard]] int32_t GetChestProgress(int32_t cellX, int32_t cellY) const override;
  255. [[nodiscard]] int32_t GetGateProgress(int32_t cellX, int32_t cellY) const override;
  256. [[nodiscard]] int32_t GetClassroomProgress(int32_t cellX, int32_t cellY) const override;
  257. [[nodiscard]] std::shared_ptr<const THUAI6::GameInfo> GetGameInfo() const override;
  258. [[nodiscard]] std::vector<int64_t> GetPlayerGUIDs() const override;
  259. std::future<bool> Attack(double angleInRadian) override;
  260. [[nodiscard]] std::shared_ptr<const THUAI6::Tricker> GetSelfInfo() const override;
  261. void PrintStudent() const override
  262. {
  263. }
  264. void PrintTricker() const override
  265. {
  266. }
  267. void PrintProp() const override
  268. {
  269. }
  270. void PrintSelfInfo() const override
  271. {
  272. }
  273. private:
  274. ILogic& logic;
  275. };
  276. class StudentDebugAPI : public IStudentAPI, public IGameTimer
  277. {
  278. public:
  279. StudentDebugAPI(ILogic& logic, bool file, bool print, bool warnOnly, int64_t playerID);
  280. void StartTimer() override;
  281. void EndTimer() override;
  282. void Play(IAI& ai) override;
  283. [[nodiscard]] int GetFrameCount() const override;
  284. std::future<bool> Move(int64_t timeInMilliseconds, double angleInRadian) override;
  285. std::future<bool> MoveRight(int64_t timeInMilliseconds) override;
  286. std::future<bool> MoveUp(int64_t timeInMilliseconds) override;
  287. std::future<bool> MoveLeft(int64_t timeInMilliseconds) override;
  288. std::future<bool> MoveDown(int64_t timeInMilliseconds) override;
  289. std::future<bool> PickProp(THUAI6::PropType prop) override;
  290. std::future<bool> UseProp(THUAI6::PropType prop) override;
  291. std::future<bool> UseSkill(int32_t skillID) override;
  292. std::future<bool> Attack(double angleInRadian) override;
  293. std::future<bool> OpenDoor() override;
  294. std::future<bool> CloseDoor() override;
  295. std::future<bool> SkipWindow() override;
  296. std::future<bool> StartOpenGate() override;
  297. std::future<bool> StartOpenChest() override;
  298. std::future<bool> EndAllAction() override;
  299. std::future<bool> SendMessage(int64_t, std::string) override;
  300. [[nodiscard]] std::future<bool> HaveMessage() override;
  301. [[nodiscard]] std::future<std::optional<std::pair<int64_t, std::string>>> GetMessage() override;
  302. std::future<bool> Wait() override;
  303. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Student>> GetStudents() const override;
  304. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Tricker>> GetTrickers() const override;
  305. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Prop>> GetProps() const override;
  306. [[nodiscard]] std::vector<std::vector<THUAI6::PlaceType>> GetFullMap() const override;
  307. [[nodiscard]] THUAI6::PlaceType GetPlaceType(int32_t cellX, int32_t cellY) const override;
  308. [[nodiscard]] bool IsDoorOpen(int32_t cellX, int32_t cellY) const override;
  309. [[nodiscard]] int32_t GetChestProgress(int32_t cellX, int32_t cellY) const override;
  310. [[nodiscard]] int32_t GetGateProgress(int32_t cellX, int32_t cellY) const override;
  311. [[nodiscard]] int32_t GetClassroomProgress(int32_t cellX, int32_t cellY) const override;
  312. [[nodiscard]] std::shared_ptr<const THUAI6::GameInfo> GetGameInfo() const override;
  313. [[nodiscard]] std::vector<int64_t> GetPlayerGUIDs() const override;
  314. std::future<bool> StartLearning() override;
  315. std::future<bool> StartTreatMate() override;
  316. std::future<bool> StartRescueMate() override;
  317. std::future<bool> Graduate() override;
  318. [[nodiscard]] virtual std::shared_ptr<const THUAI6::Student> GetSelfInfo() const override;
  319. void PrintStudent() const override;
  320. void PrintTricker() const override;
  321. void PrintProp() const override;
  322. void PrintSelfInfo() const override;
  323. private:
  324. std::chrono::system_clock::time_point startPoint;
  325. std::unique_ptr<spdlog::logger> logger;
  326. ILogic& logic;
  327. };
  328. class TrickerDebugAPI : public ITrickerAPI, public IGameTimer
  329. {
  330. public:
  331. TrickerDebugAPI(ILogic& logic, bool file, bool print, bool warnOnly, int64_t playerID);
  332. void StartTimer() override;
  333. void EndTimer() override;
  334. void Play(IAI& ai) override;
  335. [[nodiscard]] int GetFrameCount() const override;
  336. std::future<bool> Move(int64_t timeInMilliseconds, double angleInRadian) override;
  337. std::future<bool> MoveRight(int64_t timeInMilliseconds) override;
  338. std::future<bool> MoveUp(int64_t timeInMilliseconds) override;
  339. std::future<bool> MoveLeft(int64_t timeInMilliseconds) override;
  340. std::future<bool> MoveDown(int64_t timeInMilliseconds) override;
  341. std::future<bool> PickProp(THUAI6::PropType prop) override;
  342. std::future<bool> UseProp(THUAI6::PropType prop) override;
  343. std::future<bool> UseSkill(int32_t skillID) override;
  344. std::future<bool> OpenDoor() override;
  345. std::future<bool> CloseDoor() override;
  346. std::future<bool> SkipWindow() override;
  347. std::future<bool> StartOpenGate() override;
  348. std::future<bool> StartOpenChest() override;
  349. std::future<bool> EndAllAction() override;
  350. std::future<bool> SendMessage(int64_t, std::string) override;
  351. [[nodiscard]] std::future<bool> HaveMessage() override;
  352. [[nodiscard]] std::future<std::optional<std::pair<int64_t, std::string>>> GetMessage() override;
  353. std::future<bool> Wait() override;
  354. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Student>> GetStudents() const override;
  355. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Tricker>> GetTrickers() const override;
  356. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Prop>> GetProps() const override;
  357. [[nodiscard]] std::vector<std::vector<THUAI6::PlaceType>> GetFullMap() const override;
  358. [[nodiscard]] THUAI6::PlaceType GetPlaceType(int32_t cellX, int32_t cellY) const override;
  359. [[nodiscard]] bool IsDoorOpen(int32_t cellX, int32_t cellY) const override;
  360. [[nodiscard]] int32_t GetChestProgress(int32_t cellX, int32_t cellY) const override;
  361. [[nodiscard]] int32_t GetGateProgress(int32_t cellX, int32_t cellY) const override;
  362. [[nodiscard]] int32_t GetClassroomProgress(int32_t cellX, int32_t cellY) const override;
  363. [[nodiscard]] std::shared_ptr<const THUAI6::GameInfo> GetGameInfo() const override;
  364. [[nodiscard]] std::vector<int64_t> GetPlayerGUIDs() const override;
  365. std::future<bool> Attack(double angleInRadian) override;
  366. [[nodiscard]] std::shared_ptr<const THUAI6::Tricker> GetSelfInfo() const override;
  367. void PrintStudent() const override;
  368. void PrintTricker() const override;
  369. void PrintProp() const override;
  370. void PrintSelfInfo() const override;
  371. private:
  372. std::chrono::system_clock::time_point startPoint;
  373. std::unique_ptr<spdlog::logger> logger;
  374. ILogic& logic;
  375. };
  376. #endif