AWS-Mahjong

Description

https://c9katayama.hatenablog.com/entry/2014/12/15/002712

Test

count=1などで見かけ上はcacheされていないように見えるが正しくテストできていない。最も確実な方法が今のところcleanすること。

go clean -testcache && go test -v ./... -failfast

go clean -testcache && go test -v ./server -tags=integration

Api Document

api endpoint

http://localhost:8000/

[x] GET `/rooms`

現在開かれている部屋の一覧を取得する。

RESPONSE

status 200

[
  {
    "room_name": "provident",
    "room_capacity": 3,
    "room_member_count": 1
  },
  {
    "room_name": "fugiat",
    "room_capacity": 4,
    "room_member_count": 1
  }
]

default

NO CONTENT

WebSocket Document

websocket endpoint

http://localhost:8000/ws

Client Events

[x] create_room

部屋を作成して参加する。作成の際にプレイ人数を指定できる。指定した人数集まった場合には自動的にスタートする。

{
  "user_name": "Elwin Ebert",
  "room_name": "possimus",
  "room_capacity": 3
}

[x] join_room

部屋の名前を指定してユーザーを参加させる。しっかりと/roomsの結果で取得したroomにjoinすること。

{
  "user_name": "Ms. Lilliana Walker",
  "room_name": "porro"
}

[x] leave_room

現在joinしている部屋から退出する。ちなみにゲームが開始されてから退出した場合は開始中のゲームは強制終了する。

{
  "room_name": "laudantium"
}

[x] game_dahai

牌を手牌から捨てる際に使う。このイベントを送信するとnew_statusが走る。基本的にはnew_statusのturn_player_indexに対応するplayerがtsumoを持っている。これを捨てるために使用する。

{
  "room_name": "laudantium",
  "dahai": "chun"
}

[ ] game_naki

打牌に対して鳴きを行うか否かを選択する。鳴きを行わない場合に関してもcancelというイベントを送信する。 actionsの種類に関しては/naki/naki.goのNakiActionを参照。

{
  "room_name": "laudantium",
  "action": "cancel"
}

{
  "room_name": "laudantium",
  "action": "pon",
  "tiles": ["manzu1", "manzu1"]
}

Server Events

[x] room_error

エラーメッセージの文字列が帰ってくる。部屋の作成、参加、退出などのエラーを返す。

{
  "event_name": "create_room"
  "error_message": "room_already_taken"
}

[x] new_room_status

{
  "room_name": "modi",
  "room_member_count": 1,
  "room_capacity": 3
}

[x] game_start

ゲームの開始を通知するだけ。現状は空文字を返すのみ。

[ ] game_end

ゲームの終了を通知する。

[x] game_error

誰かが退出して強制終了した場合、nakiが遅くでnakiができなかった場合などに発火する。

{
  "event_name": "create_room"
  "error_message": "room_already_taken"
}

[x] new_game_status

他のプレイヤーの打牌、鳴きなど状況に変更があった際には更新がこのイベントで通知される。

{
  "bakaze": "east",
  "deck_count": 36, 
  "jicha": {
    "name": "",
    "zikaze": "east",
    "tsumo": "manzu3",
    "hand": ["hanzu3", "souzu3"],
    "kawa": [
      {"isSide": false, "name": "manzu3"},
      {"isSide": false, "name": "manzu3"}
    ],
    "naki_actions": {
      "pon": [["manzu1", "manzu1"], ["manzu2", "manzu2"]],
      "kan": [],
      "chii": [["manzu1", "manzu2"]]
    },
    "naki": [
      [
        {"isOpen": false, "isSide": false, "name": "hatu"},
        {"isOpen": false, "isSide": false, "name": "hatu"},
        {"isOpen": false, "isSide": true, "name": "hatu"}
      ],
      [
        {"isOpen": true, "isSide": false, "name": "manzu1"},
        {"isOpen": false, "isSide": false, "name": "manzu1"},
        {"isOpen": false, "isSide": false, "name": "manzu1"},
        {"isOpen": true, "isSide": false, "name": "manzu1"}
      ]
    ]
  },
  "shimocha": {
    "name": "",
    "zikaze": "east",
    "tsumo": "manzu3",
    "hand": ["hanzu3", "souzu3"],
    "kawa": [
      {"isSide": false, "name": "manzu3"},
      {"isSide": false, "name": "manzu3"}
    ],
    "naki_actions": {
      "pon": [["manzu1", "manzu1"], ["manzu2", "manzu2"]],
      "kan": [],
      "chii": [["manzu1", "manzu2"]]
    },
    "naki": [
      [
        {"isOpen": false, "isSide": false, "name": "hatu"},
        {"isOpen": false, "isSide": false, "name": "hatu"},
        {"isOpen": false, "isSide": true, "name": "hatu"}
      ],
      [
        {"isOpen": true, "isSide": false, "name": "manzu1"},
        {"isOpen": false, "isSide": false, "name": "manzu1"},
        {"isOpen": false, "isSide": false, "name": "manzu1"},
        {"isOpen": true, "isSide": false, "name": "manzu1"}
      ]
    ]
  },
  "toimen": {
    "name": "",
    "zikaze": "east",
    "tsumo": "manzu3",
    "hand": ["hanzu3", "souzu3"],
    "kawa": [
      {"isSide": false, "name": "manzu3"},
      {"isSide": false, "name": "manzu3"}
    ],
    "naki_actions": {
      "pon": [["manzu1", "manzu1"], ["manzu2", "manzu2"]],
      "kan": [],
      "chii": [["manzu1", "manzu2"]]
    },
    "naki": [
      [
        {"isOpen": false, "isSide": false, "name": "hatu"},
        {"isOpen": false, "isSide": false, "name": "hatu"},
        {"isOpen": false, "isSide": true, "name": "hatu"}
      ],
      [
        {"isOpen": true, "isSide": false, "name": "manzu1"},
        {"isOpen": false, "isSide": false, "name": "manzu1"},
        {"isOpen": false, "isSide": false, "name": "manzu1"},
        {"isOpen": true, "isSide": false, "name": "manzu1"}
      ]
    ]
  },
  "kamicha": {
    "name": "",
    "zikaze": "east",
    "tsumo": "manzu3",
    "hand": ["hanzu3", "souzu3"],
    "kawa": [
      {"isSide": false, "name": "manzu3"},
      {"isSide": false, "name": "manzu3"}
    ],
    "naki_actions": {
      "pon": [["manzu1", "manzu1"], ["manzu2", "manzu2"]],
      "kan": [],
      "chii": [["manzu1", "manzu2"]]
    },
    "naki": [
      [
        {"isOpen": false, "isSide": false, "name": "hatu"},
        {"isOpen": false, "isSide": false, "name": "hatu"},
        {"isOpen": false, "isSide": true, "name": "hatu"}
      ],
      [
        {"isOpen": true, "isSide": false, "name": "manzu1"},
        {"isOpen": false, "isSide": false, "name": "manzu1"},
        {"isOpen": false, "isSide": false, "name": "manzu1"},
        {"isOpen": true, "isSide": false, "name": "manzu1"}
      ]
    ]
  }
}

k-jun/aws-mahjong