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

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585
  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. // 供IAPI使用的操作相关的部分
  30. virtual bool Move(int64_t time, double angle) = 0;
  31. virtual bool PickProp(THUAI6::PropType prop) = 0;
  32. virtual bool UseProp() = 0;
  33. virtual bool UseSkill() = 0;
  34. virtual bool SendMessage(int64_t toID, std::string message) = 0;
  35. virtual bool HaveMessage() = 0;
  36. virtual std::pair<std::string, int64_t> GetMessage() = 0;
  37. virtual bool Escape() = 0;
  38. // 说明:双向stream由三个函数共同实现,两个记录开始和结束,结果由Logic里的私有的成员变量记录,获得返回值则另调函数
  39. virtual bool StartFixMachine() = 0;
  40. virtual bool EndFixMachine() = 0;
  41. virtual bool GetFixStatus() = 0;
  42. virtual bool StartSaveHuman() = 0;
  43. virtual bool EndSaveHuman() = 0;
  44. virtual bool GetSaveStatus() = 0;
  45. virtual bool Attack(double angle) = 0;
  46. virtual bool CarryHuman() = 0;
  47. virtual bool ReleaseHuman() = 0;
  48. virtual bool HangHuman() = 0;
  49. virtual bool WaitThread() = 0;
  50. virtual int GetCounter() = 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> GetFixStatus() = 0;
  104. virtual std::future<bool> StartSaveHuman() = 0;
  105. virtual std::future<bool> EndSaveHuman() = 0;
  106. virtual std::future<bool> GetSaveStatus() = 0;
  107. virtual std::future<bool> Escape() = 0;
  108. [[nodiscard]] virtual std::shared_ptr<const THUAI6::Human> GetSelfInfo() const = 0;
  109. };
  110. class IButcherAPI : public IAPI
  111. {
  112. public:
  113. /*****屠夫阵营的特定函数*****/
  114. virtual std::future<bool> Attack(double angleInRadian) = 0;
  115. virtual std::future<bool> CarryHuman() = 0;
  116. virtual std::future<bool> ReleaseHuman() = 0;
  117. virtual std::future<bool> HangHuman() = 0;
  118. [[nodiscard]] virtual std::shared_ptr<const THUAI6::Butcher> GetSelfInfo() const = 0;
  119. };
  120. class IGameTimer
  121. {
  122. public:
  123. virtual void StartTimer() = 0;
  124. virtual void EndTimer() = 0;
  125. virtual void Play(IAI& ai) = 0;
  126. };
  127. class HumanAPI : public IHumanAPI, public IGameTimer
  128. {
  129. public:
  130. HumanAPI(ILogic& logic) :
  131. logic(logic)
  132. {
  133. }
  134. void StartTimer() override
  135. {
  136. }
  137. void EndTimer() override
  138. {
  139. }
  140. void Play(IAI& ai) override;
  141. std::future<bool> Move(int64_t timeInMilliseconds, double angleInRadian) override;
  142. [[nodiscard]] int GetFrameCount() const override
  143. {
  144. }
  145. std::future<bool> MoveRight(int64_t timeInMilliseconds) override
  146. {
  147. }
  148. std::future<bool> MoveUp(int64_t timeInMilliseconds) override
  149. {
  150. }
  151. std::future<bool> MoveLeft(int64_t timeInMilliseconds) override
  152. {
  153. }
  154. std::future<bool> MoveDown(int64_t timeInMilliseconds) override
  155. {
  156. }
  157. std::future<bool> PickProp(THUAI6::PropType prop) override
  158. {
  159. }
  160. std::future<bool> UseProp() override
  161. {
  162. }
  163. std::future<bool> UseSkill() override
  164. {
  165. }
  166. std::future<bool> SendMessage(int64_t, std::string) override
  167. {
  168. }
  169. [[nodiscard]] std::future<bool> HaveMessage() override
  170. {
  171. }
  172. [[nodiscard]] std::future<std::pair<int64_t, std::string>> GetMessage() override
  173. {
  174. }
  175. std::future<bool> Wait() override
  176. {
  177. }
  178. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Human>> GetHuman() const override
  179. {
  180. }
  181. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Butcher>> GetButcher() const override
  182. {
  183. }
  184. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Prop>> GetProps() const override
  185. {
  186. }
  187. [[nodiscard]] std::vector<std::vector<THUAI6::PlaceType>> GetFullMap() const override
  188. {
  189. }
  190. [[nodiscard]] THUAI6::PlaceType GetPlaceType(int32_t CellX, int32_t CellY) const override
  191. {
  192. }
  193. [[nodiscard]] const std::vector<int64_t> GetPlayerGUIDs() const override
  194. {
  195. }
  196. std::future<bool> StartFixMachine() override
  197. {
  198. }
  199. std::future<bool> EndFixMachine() override
  200. {
  201. }
  202. std::future<bool> GetFixStatus() override
  203. {
  204. }
  205. std::future<bool> StartSaveHuman() override
  206. {
  207. }
  208. std::future<bool> EndSaveHuman() override
  209. {
  210. }
  211. std::future<bool> GetSaveStatus() override
  212. {
  213. }
  214. std::future<bool> Escape() override
  215. {
  216. }
  217. [[nodiscard]] virtual std::shared_ptr<const THUAI6::Human> GetSelfInfo() const override
  218. {
  219. }
  220. private:
  221. ILogic& logic;
  222. };
  223. class ButcherAPI : public IButcherAPI, public IGameTimer
  224. {
  225. public:
  226. ButcherAPI(ILogic& logic) :
  227. logic(logic)
  228. {
  229. }
  230. void StartTimer() override
  231. {
  232. }
  233. void EndTimer() override
  234. {
  235. }
  236. void Play(IAI& ai) override;
  237. std::future<bool> Move(int64_t timeInMilliseconds, double angleInRadian) override
  238. {
  239. }
  240. [[nodiscard]] int GetFrameCount() const override
  241. {
  242. }
  243. std::future<bool> MoveRight(int64_t timeInMilliseconds) override
  244. {
  245. }
  246. std::future<bool> MoveUp(int64_t timeInMilliseconds) override
  247. {
  248. }
  249. std::future<bool> MoveLeft(int64_t timeInMilliseconds) override
  250. {
  251. }
  252. std::future<bool> MoveDown(int64_t timeInMilliseconds) override
  253. {
  254. }
  255. std::future<bool> PickProp(THUAI6::PropType prop) override
  256. {
  257. }
  258. std::future<bool> UseProp() override
  259. {
  260. }
  261. std::future<bool> UseSkill() override
  262. {
  263. }
  264. std::future<bool> SendMessage(int64_t, std::string) override
  265. {
  266. }
  267. [[nodiscard]] std::future<bool> HaveMessage() override
  268. {
  269. }
  270. [[nodiscard]] std::future<std::pair<int64_t, std::string>> GetMessage() override
  271. {
  272. }
  273. std::future<bool> Wait() override
  274. {
  275. }
  276. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Human>> GetHuman() const override
  277. {
  278. }
  279. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Butcher>> GetButcher() const override
  280. {
  281. }
  282. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Prop>> GetProps() const override
  283. {
  284. }
  285. [[nodiscard]] std::vector<std::vector<THUAI6::PlaceType>> GetFullMap() const override
  286. {
  287. }
  288. [[nodiscard]] THUAI6::PlaceType GetPlaceType(int32_t CellX, int32_t CellY) const override
  289. {
  290. }
  291. [[nodiscard]] const std::vector<int64_t> GetPlayerGUIDs() const override
  292. {
  293. }
  294. std::future<bool> Attack(double angleInRadian) override
  295. {
  296. }
  297. std::future<bool> CarryHuman() override
  298. {
  299. }
  300. std::future<bool> ReleaseHuman() override
  301. {
  302. }
  303. std::future<bool> HangHuman() override
  304. {
  305. }
  306. [[nodiscard]] std::shared_ptr<const THUAI6::Butcher> GetSelfInfo() const override
  307. {
  308. }
  309. private:
  310. ILogic& logic;
  311. };
  312. class HumanDebugAPI : public IHumanAPI, public IGameTimer
  313. {
  314. public:
  315. HumanDebugAPI(ILogic& logic) :
  316. logic(logic)
  317. {
  318. }
  319. void StartTimer() override
  320. {
  321. }
  322. void EndTimer() override
  323. {
  324. }
  325. void Play(IAI& ai) override;
  326. std::future<bool> Move(int64_t timeInMilliseconds, double angleInRadian) override
  327. {
  328. }
  329. [[nodiscard]] int GetFrameCount() const override
  330. {
  331. }
  332. std::future<bool> MoveRight(int64_t timeInMilliseconds) override
  333. {
  334. }
  335. std::future<bool> MoveUp(int64_t timeInMilliseconds) override
  336. {
  337. }
  338. std::future<bool> MoveLeft(int64_t timeInMilliseconds) override
  339. {
  340. }
  341. std::future<bool> MoveDown(int64_t timeInMilliseconds) override
  342. {
  343. }
  344. std::future<bool> PickProp(THUAI6::PropType prop) override
  345. {
  346. }
  347. std::future<bool> UseProp() override
  348. {
  349. }
  350. std::future<bool> UseSkill() override
  351. {
  352. }
  353. std::future<bool> SendMessage(int64_t, std::string) override
  354. {
  355. }
  356. [[nodiscard]] std::future<bool> HaveMessage() override
  357. {
  358. }
  359. [[nodiscard]] std::future<std::pair<int64_t, std::string>> GetMessage() override
  360. {
  361. }
  362. std::future<bool> Wait() override
  363. {
  364. }
  365. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Human>> GetHuman() const override
  366. {
  367. }
  368. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Butcher>> GetButcher() const override
  369. {
  370. }
  371. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Prop>> GetProps() const override
  372. {
  373. }
  374. [[nodiscard]] std::vector<std::vector<THUAI6::PlaceType>> GetFullMap() const override
  375. {
  376. }
  377. [[nodiscard]] THUAI6::PlaceType GetPlaceType(int32_t CellX, int32_t CellY) const override
  378. {
  379. }
  380. [[nodiscard]] const std::vector<int64_t> GetPlayerGUIDs() const override
  381. {
  382. }
  383. std::future<bool> StartFixMachine() override
  384. {
  385. }
  386. std::future<bool> EndFixMachine() override
  387. {
  388. }
  389. std::future<bool> GetFixStatus() override
  390. {
  391. }
  392. std::future<bool> StartSaveHuman() override
  393. {
  394. }
  395. std::future<bool> EndSaveHuman() override
  396. {
  397. }
  398. std::future<bool> GetSaveStatus() override
  399. {
  400. }
  401. std::future<bool> Escape() override
  402. {
  403. }
  404. [[nodiscard]] virtual std::shared_ptr<const THUAI6::Human> GetSelfInfo() const override
  405. {
  406. }
  407. private:
  408. ILogic& logic;
  409. };
  410. class ButcherDebugAPI : public IButcherAPI, public IGameTimer
  411. {
  412. public:
  413. ButcherDebugAPI(ILogic& logic) :
  414. logic(logic)
  415. {
  416. }
  417. void StartTimer() override
  418. {
  419. }
  420. void EndTimer() override
  421. {
  422. }
  423. void Play(IAI& ai) override;
  424. std::future<bool> Move(int64_t timeInMilliseconds, double angleInRadian) override
  425. {
  426. }
  427. [[nodiscard]] int GetFrameCount() const override
  428. {
  429. }
  430. std::future<bool> MoveRight(int64_t timeInMilliseconds) override
  431. {
  432. }
  433. std::future<bool> MoveUp(int64_t timeInMilliseconds) override
  434. {
  435. }
  436. std::future<bool> MoveLeft(int64_t timeInMilliseconds) override
  437. {
  438. }
  439. std::future<bool> MoveDown(int64_t timeInMilliseconds) override
  440. {
  441. }
  442. std::future<bool> PickProp(THUAI6::PropType prop) override
  443. {
  444. }
  445. std::future<bool> UseProp() override
  446. {
  447. }
  448. std::future<bool> UseSkill() override
  449. {
  450. }
  451. std::future<bool> SendMessage(int64_t, std::string) override
  452. {
  453. }
  454. [[nodiscard]] std::future<bool> HaveMessage() override
  455. {
  456. }
  457. [[nodiscard]] std::future<std::pair<int64_t, std::string>> GetMessage() override
  458. {
  459. }
  460. std::future<bool> Wait() override
  461. {
  462. }
  463. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Human>> GetHuman() const override
  464. {
  465. }
  466. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Butcher>> GetButcher() const override
  467. {
  468. }
  469. [[nodiscard]] std::vector<std::shared_ptr<const THUAI6::Prop>> GetProps() const override
  470. {
  471. }
  472. [[nodiscard]] std::vector<std::vector<THUAI6::PlaceType>> GetFullMap() const override
  473. {
  474. }
  475. [[nodiscard]] THUAI6::PlaceType GetPlaceType(int32_t CellX, int32_t CellY) const override
  476. {
  477. }
  478. [[nodiscard]] const std::vector<int64_t> GetPlayerGUIDs() const override
  479. {
  480. }
  481. std::future<bool> Attack(double angleInRadian) override
  482. {
  483. }
  484. std::future<bool> CarryHuman() override
  485. {
  486. }
  487. std::future<bool> ReleaseHuman() override
  488. {
  489. }
  490. std::future<bool> HangHuman() override
  491. {
  492. }
  493. [[nodiscard]] std::shared_ptr<const THUAI6::Butcher> GetSelfInfo() const override
  494. {
  495. }
  496. private:
  497. ILogic& logic;
  498. };
  499. #endif