Baccarat — tài liệu ghép client

Cược Player / Banker / Tie + side bet. Envelope lobby game_event; payload bàn là bytes proto baccarat_event. Frame WS là binary, không JSON.

1. Tổng quan

Side enum

State enum

Pending=0 · Countdown=1 · DealTime=2 · ShowdownTime=3 · BetTime=4 · PreShowdownTime=5. Chỉ cược khi BetTime (sau start_bet).

2. Demo felt

Viền vàng = cửa win (win_sides). Side bet (Pair/Big/Small) vẽ chip quanh felt; tỷ lệ lấy room_state.side_list.

3. WS envelope (đầy đủ)

Mọi frame là binary protobuf, không JSON. Handshake close code: 0 closed · 1 other device playing · 2 too many conn · 4 token expired · 5 banned.

GET /ws?access_token=<JWT>     // domain game, ví dụ wss://baccarat.example/ws

Gameplay bytes: client marshal baccarat_event.Request → nhét vào lobby:

game_event.Request.data_send {
  room_id: 42
  data: <bytes baccarat_event.Request>
}

Server đẩy bàn qua:

game_event.Response.game_message {
  room_id: 42
  data: <bytes baccarat_event.Response>
}

4. Lobby C→S / S→C

5. Gameplay proto baccarat_event

C→S Request (oneof) — gửi trong data_send.data

// C→S bet Player 1000
Request { bet { side: Player  bet_amount: 1000  count { bet: 1000  count: 1 } } }

// C→S multiple_bet
Request { multiple_bet { bets { side: Banker bet_amount: 500 } bets { side: Tie bet_amount: 100 } } }

S→C Response (oneof) — nhận từ game_message.data

// S→C start_bet
Response { start_bet { delay_millis: 20000 } }

// S→C finish (Banker thắng)
Response { finish {
  player_cards: [4, 20]
  banker_cards: [8, 16, 1]
  win_sides: [Banker]
  player_score: 8
  banker_score: 6
  sides_win_amount { side: Banker  win_amount: 95000 }
  players_sides_win_amount {
    user_id: 1001  total_amount: 950  user_money: 500950
    sides_win_amount { side: Banker win_amount: 950 }
  }
} }

room_state — restore khi join giữa ván

// C→S echo bet (S→C)
Response { bet {
  user_id: 1001  side: Player  bet_amount: 1000
  side_total_bet: 48000  seat: 2  player_total_bet: 1000
  count { bet: 1000 count: 1 }
} }
// pre_showdown — trừ cược, ghi đè chip nếu UI lệch
Response { pre_showdown {
  result { user_id: 1001  amount: -1000  user_money: 499000 }
  bet_sides { side: Player  bet_amount: 48000 }
} }

6. Luồng ghép

1. WS connect JWT. Nhận close 1/2/4/5 thì dừng, hiện lý do.
2. Gửi room_config rồi join_any_room / create_room / join_room.
3. Nhận room_state — restore felt, chip, cửa đang mở.
4. Khi start_bet: đếm delay_millis, enable chip.
5. Gửi bet (Tag=1). Echo cập nhật total cửa.
6. deal khóa cược. pre_showdown sync money. finish lật bài, highlight win_sides, cộng chip.

7. Error codes

8. Checklist client

• Connect domain game, binary protobuf, một user một socket.
• Mọi action bàn đi qua data_send.data = bytes baccarat_event.Request.
• Cược chỉ khi BetTime; tin side_list / bets từ room_state.
• Animate chip theo count[]; money cuối từ pre_showdown + finish.
• Card id = rank×4+suit. Highlight win_sides.
• Cheat chỉ non-prod.