]> git.cworth.org Git - empires-api/commitdiff
Add a new game-info event
authorCarl Worth <cworth@cworth.org>
Fri, 5 Jun 2020 01:16:41 +0000 (18:16 -0700)
committerCarl Worth <cworth@cworth.org>
Fri, 5 Jun 2020 01:16:41 +0000 (18:16 -0700)
Which gives the game ID and the URL for connecting to the game.

This allows the client to display this information so that the player
can easily share it with friends, etc.

tictactoe.txt

index 2211a05984ca32d1d30d51eee934f5f7f1d5ec6f..361caf79cd59e27cd4cfead92c83f83bb14b628b 100644 (file)
@@ -26,14 +26,27 @@ For a specific game the following API endpoints are defined.
 
     The following event types will be returned by the server:
 
-        TYPE: game-state
+       TYPE: game-info
 
-        WHEN: When a client first connections
+       WHEN: When a client first connects
+
+       WHAT: Static information about the game (will not change)
 
         EXAMPLE:
 
+               event: game-info
+                data: {"id":"WXYZ","url":"https://lmno.games/WXYZ"}
+
+       TYPE: game-state
+
+       WHEN: When a client first connects
+
+       WHAT: Snapshot of the current dynamic game state
+
+       EXAMPLE:
+
                event: game-state
-                data: {"moves":[0,8],"board":["X","","","","","","","","O"],"next_player":"X"}
+               data: {"moves":[0,8],"board":["X","","","","","","","","O"],"next_player":"X"}
 
        TYPE: move