Software-Challenge Dokumentation

Spiel betreten

Wenn begonnen wird mit dem Server zu kommunizieren, muss zuallererst

<protocol>

gesendet werden, um die Kommunikation zu beginnen.

Ohne Reservierungscode

Betritt ein beliebiges offenes Spiel:

<join gameType="swc_2019_piranhas" />

Sollte kein Spiel offen sein, wird so ein neues erstellt. Je nachdem ob paused in server.properties true oder false ist, wird das Spiel pausiert gestartet oder nicht. Der Server antwortet darauf mit:

  • ROOM_ID Id des GameRooms
<joined roomId="ROOM_ID" />

Alle administrativen Clients werden ebenfalls darüber benachrichtigt und erhalten folgende Nachricht:

  • ROOM_ID Id des GameRooms
<joinedGameRoom roomId="ROOM_ID" existing="false" />

Falls bereits ein GameRoom offen war, ist dementsprechend existing true.

Mit Reservierungscode

Ist ein Reservierungscode gegeben, so kann man den durch den Code gegebenen Platz betreten.

Join mit RC

  • RC Reservierungscode
<joinPrepared reservationCode="RC" />

Welcome Message

Der Server antwortet darauf nur, wenn der zweite Computerspieler ebenfalls verbunden ist:

  • ROOM_ID Id des GameRooms

  • COLOR Spielerfarbe also red oder blue

  • STATUS GameState wie in ???

<joined roomId="ROOM_ID" />
<room roomId="ROOM_ID">
  <data class="welcomeMessage" color="COLOR"></data>
</room>
<room roomId="ROOM_ID">
  <data class="memento">
    STATUS
  </data>
</room>
spiel-betreten