Simulator za projekt FuzbAI
Paket je namenjen testiranju algoritmov za agente (igralce) namiznega nogometa v simuliranem okolju.
Paket FuzbAISim je sestavljen iz simulatorja, REST serverja ter agentov.
Simulator FuzbAISim se požene kot Windows .exe aplikacija (FuzbAISimWrapper.exe). Izvajati se mora na istem sistemu kot REST server.
S simulatorjem se upravlja preko tipkovnice in miške.
Ob zagonu simulatorja sta aktivna demo igralca za rdeče in modre igralce. Za preklop na podatke iz REST API serverja, uporabi tipki '1' ali '2' (preklop prikaza iz 'Demo' v 'External').
Bližnjice na tipkah:
- 1: Vklop/izklop vgrajenega demo igralca za rdeče igralce
- 2: Vklop/izklop vgrajenega demo igralca za modre igralce
- Esc: Zaustavitev simulatorja
- Enter: Ponoven met igralne žogice
Igralno žogico se lahko po potrebi premika tudi z miško ('drag&drop').
Repozitorij vsebuje tudi HTTP REST API server za FuzbAI v obliki Python datoteke. Za zagon je potrebno namestiti pakete fastapi
, uvicorn
ter requests
.
Server se požene iz terminala kot
py .\FuzbAISimServer.py
Za dokumentacijo REST API vmesnika, odpri vgrajeno spletno stran https://127.0.0.1:23336/docs
Primer delujočega agenta za FuzbAI je v datoteki FuzbAIAgent_Example.py
. Privzeto se agent uporabi za rdeče igralce, za modre igralce je potrebno spremeniti URL naslov v vrstici 15 - blue
je potrebno postaviti na True
.
Primer prikazuje sinusno premikanje palice 0 (golman) ter brco vsakih 5 sekund. Primer se ne odziva na položaj žoge ali ostalih igralcev, prav tako ne premika ostalih palic. Za premikanje vseh 4 palic igralca je potrebno v polje
commands
dodati ukaze za vse 4 palice (t.j. vsaka palica ima svoj zapis v tem polju, kjer driveID
nakazuje za katero palico dejansko gre - vrednosti 1, 2, 3 ali 4).