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 13 kB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393
  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 "structures.h"
  16. const constexpr int num_of_grid_per_cell = 1000;
  17. class IAI;
  18. class ILogic
  19. {
  20. // API中依赖Logic的部分
  21. public:
  22. // 获取服务器发来的消息
  23. virtual std::vector<std::shared_ptr<const THUAI6::Butcher>> GetButchers() const = 0;
  24. virtual std::vector<std::shared_ptr<const THUAI6::Human>> GetHumans() const = 0;
  25. virtual std::vector<std::shared_ptr<const THUAI6::Prop>> GetProps() const = 0;
  26. virtual std::shared_ptr<const THUAI6::Human> HumanGetSelfInfo() const = 0;
  27. virtual std::shared_ptr<const THUAI6::Butcher> ButcherGetSelfInfo() const = 0;
  28. virtual std::vector<std::vector<THUAI6::PlaceType>> GetFullMap() const = 0;
  29. virtual THUAI6::PlaceType GetPlaceType(int32_t CellX, int32_t CellY) const = 0;
  30. // 供IAPI使用的操作相关的部分
  31. virtual bool Move(int64_t time, double angle) = 0;
  32. virtual bool PickProp(THUAI6::PropType prop) = 0;
  33. virtual bool UseProp() = 0;
  34. virtual bool UseSkill() = 0;
  35. virtual bool SendMessage(int64_t toID, std::string message) = 0;
  36. virtual bool HaveMessage() = 0;
  37. virtual std::pair<int64_t, std::string> GetMessage() = 0;
  38. virtual bool WaitThread() = 0;
  39. virtual int GetCounter() const = 0;
  40. // IHumanAPI使用的部分
  41. virtual bool Escape() = 0;
  42. virtual bool StartFixMachine() = 0;
  43. virtual bool EndFixMachine() = 0;
  44. virtual bool StartSaveHuman() = 0;
  45. virtual bool EndSaveHuman() = 0;
  46. // IButcherAPI使用的部分
  47. virtual bool Attack(double angle) = 0;
  48. virtual bool CarryHuman() = 0;
  49. virtual bool ReleaseHuman() = 0;
  50. virtual bool HangHuman() = 0;
  51. };
  52. class IAPI
  53. {
  54. public:
  55. // 选手可执行的操作,应当保证所有函数的返回值都应当为std::future,例如下面的移动函数:
  56. // 指挥本角色进行移动,`timeInMilliseconds` 为移动时间,单位为毫秒;`angleInRadian` 表示移动的方向,单位是弧度,使用极坐标——竖直向下方向为 x 轴,水平向右方向为 y 轴
  57. virtual std::future<bool> Move(int64_t timeInMilliseconds, double angleInRadian) = 0;
  58. // 向特定方向移动
  59. virtual std::future<bool> MoveRight(int64_t timeInMilliseconds) = 0;
  60. virtual std::future<bool> MoveUp(int64_t timeInMilliseconds) = 0;
  61. virtual std::future<bool> MoveLeft(int64_t timeInMilliseconds) = 0;
  62. virtual std::future<bool> MoveDown(int64_t timeInMilliseconds) = 0;
  63. // 捡道具、使用技能
  64. virtual std::future<bool> PickProp(THUAI6::PropType prop) = 0;
  65. virtual std::future<bool> UseProp() = 0;
  66. virtual std::future<bool> UseSkill() = 0;
  67. // 发送信息、接受信息
  68. virtual std::future<bool> SendMessage(int64_t, std::string) = 0;
  69. [[nodiscard]] virtual std::future<bool> HaveMessage() = 0;
  70. [[nodiscard]] virtual std::future<std::pair<int64_t, std::string>> GetMessage() = 0;
  71. // 等待下一帧
  72. virtual std::future<bool> Wait() = 0;
  73. // 获取视野内可见的人类/屠夫的信息
  74. [[nodiscard]] virtual std::vector<std::shared_ptr<const THUAI6::Human>> GetHuman() const = 0;
  75. [[nodiscard]] virtual std::vector<std::shared_ptr<const THUAI6::Butcher>> GetButcher() const = 0;
  76. // 获取视野内可见的道具信息
  77. [[nodiscard]] virtual std::vector<std::shared_ptr<const THUAI6::Prop>> GetProps() const = 0;
  78. // 获取地图信息,视野外的地图统一为Land
  79. [[nodiscard]] virtual std::vector<std::vector<THUAI6::PlaceType>> GetFullMap() const = 0;
  80. [[nodiscard]] virtual THUAI6::PlaceType GetPlaceType(int32_t CellX, int32_t CellY) const = 0;
  81. // 获取所有玩家的GUID
  82. [[nodiscard]] virtual const std::vector<int64_t> GetPlayerGUIDs() const = 0;
  83. // 获取游戏目前所进行的帧数
  84. [[nodiscard]] virtual int GetFrameCount() const = 0;
  85. /*****选手可能用的辅助函数*****/
  86. // 获取指定格子中心的坐标
  87. [[nodiscard]] static inline int CellToGrid(int cell) noexcept
  88. {
  89. return cell * num_of_grid_per_cell + num_of_grid_per_cell / 2;
  90. }
  91. // 获取指定坐标点所位于的格子的 X 序号
  92. [[nodiscard]] static inline int GridToCell(int grid) noexcept
  93. {
  94. return grid / num_of_grid_per_cell;
  95. }
  96. };
  97. class IHumanAPI : public IAPI
  98. {
  99. public:
  100. /*****人类阵营的特定函数*****/
  101. virtual std::future<bool> StartFixMachine() = 0;
  102. virtual std::future<bool> EndFixMachine() = 0;
  103. virtual std::future<bool> StartSaveHuman() = 0;
  104. virtual std::future<bool> EndSaveHuman() = 0;
  105. virtual std::future<bool> Escape() = 0;
  106. [[nodiscard]] virtual std::shared_ptr<const THUAI6::Human> GetSelfInfo() const = 0;
  107. };
  108. class IButcherAPI : public IAPI
  109. {
  110. public:
  111. /*****屠夫阵营的特定函数*****/
  112. virtual std::future<bool> Attack(double angleInRadian) = 0;
  113. virtual std::future<bool> CarryHuman() = 0;
  114. virtual std::future<bool> ReleaseHuman() = 0;
  115. virtual std::future<bool> HangHuman() = 0;
  116. [[nodiscard]] virtual std::shared_ptr<const THUAI6::Butcher> GetSelfInfo() const = 0;
  117. };
  118. class IGameTimer
  119. {
  120. public:
  121. virtual void StartTimer() = 0;
  122. virtual void EndTimer() = 0;
  123. virtual void Play(IAI& ai) = 0;
  124. };
  125. class HumanAPI : public IHumanAPI, public IGameTimer
  126. {
  127. public:
  128. HumanAPI(ILogic& logic) :
  129. logic(logic)
  130. {
  131. }
  132. void StartTimer() override
  133. {
  134. }
  135. void EndTimer() override
  136. {
  137. }
  138. void Play(IAI& ai) override;
  139. std::future<bool> Move(int64_t timeInMilliseconds, double angleInRadian) override;
  140. [[nodiscard]] int GetFrameCount() const override
  141. {
  142. }
  143. std::future<bool> MoveRight(int64_t timeInMilliseconds) override;
  144. std::future<bool> MoveUp(int64_t timeInMilliseconds) override;
  145. std::future<bool> MoveLeft(int64_t timeInMilliseconds) override;
  146. std::future<bool> MoveDown(int64_t timeInMilliseconds) override;
  147. std::future<bool> PickProp(THUAI6::PropType prop) override;
  148. std::future<bool> UseProp() override;
  149. std::future<bool> UseSkill() override;
  150. std::future<bool> SendMessage(int64_t, std::string) override;
  151. [[nodiscard]] std::future<bool> HaveMessage() override;
  152. [[nodiscard]] std::future<std::pair<int64_t, std::string>> GetMessage() override;
  153. std::future<bool> Wait() override
  154. {
  155. }
  156. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Human>> GetHuman() const override;
  157. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Butcher>> GetButcher() const override;
  158. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Prop>> GetProps() const override;
  159. [[nodiscard]] std::vector<std::vector<THUAI6::PlaceType>> GetFullMap() const override;
  160. [[nodiscard]] THUAI6::PlaceType GetPlaceType(int32_t CellX, int32_t CellY) const override;
  161. [[nodiscard]] const std::vector<int64_t> GetPlayerGUIDs() const override;
  162. std::future<bool> StartFixMachine() override;
  163. std::future<bool> EndFixMachine() override;
  164. std::future<bool> StartSaveHuman() override;
  165. std::future<bool> EndSaveHuman() override;
  166. std::future<bool> Escape() override;
  167. [[nodiscard]] std::shared_ptr<const THUAI6::Human> GetSelfInfo() const override;
  168. private:
  169. ILogic& logic;
  170. };
  171. class ButcherAPI : public IButcherAPI, public IGameTimer
  172. {
  173. public:
  174. ButcherAPI(ILogic& logic) :
  175. logic(logic)
  176. {
  177. }
  178. void StartTimer() override
  179. {
  180. }
  181. void EndTimer() override
  182. {
  183. }
  184. void Play(IAI& ai) override;
  185. std::future<bool> Move(int64_t timeInMilliseconds, double angleInRadian) override;
  186. [[nodiscard]] int GetFrameCount() const override
  187. {
  188. }
  189. std::future<bool> MoveRight(int64_t timeInMilliseconds) override;
  190. std::future<bool> MoveUp(int64_t timeInMilliseconds) override;
  191. std::future<bool> MoveLeft(int64_t timeInMilliseconds) override;
  192. std::future<bool> MoveDown(int64_t timeInMilliseconds) override;
  193. std::future<bool> PickProp(THUAI6::PropType prop) override;
  194. std::future<bool> UseProp() override;
  195. std::future<bool> UseSkill() override;
  196. std::future<bool> SendMessage(int64_t, std::string) override;
  197. [[nodiscard]] std::future<bool> HaveMessage() override;
  198. [[nodiscard]] std::future<std::pair<int64_t, std::string>> GetMessage() override;
  199. std::future<bool> Wait() override
  200. {
  201. }
  202. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Human>> GetHuman() const override;
  203. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Butcher>> GetButcher() const override;
  204. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Prop>> GetProps() const override;
  205. [[nodiscard]] std::vector<std::vector<THUAI6::PlaceType>> GetFullMap() const override;
  206. [[nodiscard]] THUAI6::PlaceType GetPlaceType(int32_t CellX, int32_t CellY) const override;
  207. [[nodiscard]] const std::vector<int64_t> GetPlayerGUIDs() const override;
  208. std::future<bool> Attack(double angleInRadian) override;
  209. std::future<bool> CarryHuman() override;
  210. std::future<bool> ReleaseHuman() override;
  211. std::future<bool> HangHuman() override;
  212. [[nodiscard]] std::shared_ptr<const THUAI6::Butcher> GetSelfInfo() const override;
  213. private:
  214. ILogic& logic;
  215. };
  216. class HumanDebugAPI : public IHumanAPI, public IGameTimer
  217. {
  218. public:
  219. HumanDebugAPI(ILogic& logic) :
  220. logic(logic)
  221. {
  222. }
  223. void StartTimer() override
  224. {
  225. }
  226. void EndTimer() override
  227. {
  228. }
  229. void Play(IAI& ai) override;
  230. std::future<bool> Move(int64_t timeInMilliseconds, double angleInRadian) override;
  231. [[nodiscard]] int GetFrameCount() const override
  232. {
  233. }
  234. std::future<bool> MoveRight(int64_t timeInMilliseconds) override;
  235. std::future<bool> MoveUp(int64_t timeInMilliseconds) override;
  236. std::future<bool> MoveLeft(int64_t timeInMilliseconds) override;
  237. std::future<bool> MoveDown(int64_t timeInMilliseconds) override;
  238. std::future<bool> PickProp(THUAI6::PropType prop) override;
  239. std::future<bool> UseProp() override;
  240. std::future<bool> UseSkill() override;
  241. std::future<bool> SendMessage(int64_t, std::string) override;
  242. [[nodiscard]] std::future<bool> HaveMessage() override;
  243. [[nodiscard]] std::future<std::pair<int64_t, std::string>> GetMessage() override;
  244. std::future<bool> Wait() override
  245. {
  246. }
  247. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Human>> GetHuman() const override;
  248. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Butcher>> GetButcher() const override;
  249. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Prop>> GetProps() const override;
  250. [[nodiscard]] std::vector<std::vector<THUAI6::PlaceType>> GetFullMap() const override;
  251. [[nodiscard]] THUAI6::PlaceType GetPlaceType(int32_t CellX, int32_t CellY) const override;
  252. [[nodiscard]] const std::vector<int64_t> GetPlayerGUIDs() const override;
  253. std::future<bool> StartFixMachine() override;
  254. std::future<bool> EndFixMachine() override;
  255. std::future<bool> StartSaveHuman() override;
  256. std::future<bool> EndSaveHuman() override;
  257. std::future<bool> Escape() override;
  258. [[nodiscard]] virtual std::shared_ptr<const THUAI6::Human> GetSelfInfo() const override;
  259. private:
  260. ILogic& logic;
  261. };
  262. class ButcherDebugAPI : public IButcherAPI, public IGameTimer
  263. {
  264. public:
  265. ButcherDebugAPI(ILogic& logic) :
  266. logic(logic)
  267. {
  268. }
  269. void StartTimer() override
  270. {
  271. }
  272. void EndTimer() override
  273. {
  274. }
  275. void Play(IAI& ai) override;
  276. std::future<bool> Move(int64_t timeInMilliseconds, double angleInRadian) override;
  277. [[nodiscard]] int GetFrameCount() const override
  278. {
  279. }
  280. std::future<bool> MoveRight(int64_t timeInMilliseconds) override;
  281. std::future<bool> MoveUp(int64_t timeInMilliseconds) override;
  282. std::future<bool> MoveLeft(int64_t timeInMilliseconds) override;
  283. std::future<bool> MoveDown(int64_t timeInMilliseconds) override;
  284. std::future<bool> PickProp(THUAI6::PropType prop) override;
  285. std::future<bool> UseProp() override;
  286. std::future<bool> UseSkill() override;
  287. std::future<bool> SendMessage(int64_t, std::string) override;
  288. [[nodiscard]] std::future<bool> HaveMessage() override;
  289. [[nodiscard]] std::future<std::pair<int64_t, std::string>> GetMessage() override;
  290. std::future<bool> Wait() override
  291. {
  292. }
  293. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Human>> GetHuman() const override;
  294. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Butcher>> GetButcher() const override;
  295. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Prop>> GetProps() const override;
  296. [[nodiscard]] std::vector<std::vector<THUAI6::PlaceType>> GetFullMap() const override;
  297. [[nodiscard]] THUAI6::PlaceType GetPlaceType(int32_t CellX, int32_t CellY) const override;
  298. [[nodiscard]] const std::vector<int64_t> GetPlayerGUIDs() const override;
  299. std::future<bool> Attack(double angleInRadian) override;
  300. std::future<bool> CarryHuman() override;
  301. std::future<bool> ReleaseHuman() override;
  302. std::future<bool> HangHuman() override;
  303. [[nodiscard]] std::shared_ptr<const THUAI6::Butcher> GetSelfInfo() const override;
  304. private:
  305. ILogic& logic;
  306. };
  307. #endif