remote-snake/doc/api.org

Remote Snake API

General Description

• All transmissions will be based on UDP
• All UDP packet will contain plain json data

Communications

Initialisation

1. Server wait for a client

2. Client can send:

     {
         "type": "new-game"
     }

3. Server can reply:

     {
         "type": "state",
         "game-id": 1,
         "game-over": false,
         "snake": [(1,2),(1,3)],
         "food": [(6,7)]
     }

Gameplay

Change Direction

1. When client is playing a game it can ask to the server to change snake direction:

     {
         "type": "update",
         "direction": "left",
     }

2. Server can reply

     {
         "type": "state",
         "game-id": 1,
         "game-over": false,
         "snake": [(0,2),(1,2)],
         "food": [(6,7)]
     }

Refresh Screen

1. When no key are press (the snake is simply going straigth forward). So, client can send:

     {
         "type": "update",
         "direction": null
     }

2. Server can reply:

     {
         "type": "state",
         "game-id": 1,
         "game-over": false,
         "snake": [(1,2),(0,2)],
         "food": [(6,7)]
     }

End Game

• When game is over server will send the following state message (switch game-over to true):

    {
        "type": "state",
        "game-id": 1,
        "game-over": true,
        "snake": [(0,2),(1,2)],
        "food": [(6,7)]
    }

• No reply is expected from the client and server will be in charge to free local memory