remote-snake/doc/api.org

Remote Snake API

General Description

• All transmissions will be based on UDP since latency is important
• All UDP datagrams between client and server will contain plain json data
• All data should be sent in one datagram
• All utf-8 characters in UDP datagram are in lower case

Communications

Initialisation

1. Client sent:

     {
         "type": "new-game"
     }

2. 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 the server to change snake direction:

     {
         "type": "update",
         "game-id": 1,
         "direction": "left",
     }

2. Then, 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 pressed (the snake is simply going forward). So, client can send:

     {
         "type": "update",
         "game-id": 1,
         "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.