Construirea unui joc de cărți multiplayer precum “Cruce” vine cu provocări arhitecturale specifice: latență scăzută, sincronizarea stării și, mai presus de toate, securitatea. În acest articol, voi detalia cum am pus la punct infrastructura pentru lobby-uri, folosind Keycloak pentru identitate și WebSockets pentru o comunicare bidirecțională eficientă.
Autenticarea cu Keycloak în Expo
Pentru a gestiona utilizatorii, am ales Keycloak. Pe partea de client (React Native/Expo), integrarea se face fluid folosind expo-auth-session și expo-web-browser. Nu reinventăm roata; folosim fluxul standard OIDC pentru a obține un JWT pe care îl vom trimite ulterior în header-ul de handshake al WebSocket-ului.
import * as AuthSession from 'expo-auth-session';
const discovery = await AuthSession.fetchDiscoveryAsync(KEYCLOAK_URL);
const request = AuthSession.useAuthRequest({ clientId, redirectUri }, discovery);
// După login, salvăm accessToken-ul în SecureStore
Singleton WebSocket: Stabilitate prin Ping-Pong
Un WebSocket nu este întotdeauna stabil, mai ales pe rețele mobile. Am implementat un singleton care gestionează reconectarea exponențială și un mecanism de heartbeat (ping-pong) pentru a detecta conexiunile “zombie”.
class SocketManager {
private socket: WebSocket | null = null;
private reconnectDelay = 1000;
connect(token: string) {
this.socket = new WebSocket(`wss://api.cruce.app?token=${token}`);
this.socket.onopen = () => { this.reconnectDelay = 1000; this.startHeartbeat(); };
this.socket.onclose = () => this.attemptReconnect();
}
private startHeartbeat() {
setInterval(() => this.socket?.send('ping'), 30000);
}
}
Server Autoritar și Starea Jocului
În “Cruce”, regula de aur este: clientul nu decide niciodată rezultatul unei mâini. Serverul rulează logica de joc și transmite doar starea necesară vizualizării. Clientul primește un obiect JSON care mapează cărțile și acțiunile permise.
interface GameState {
lobbyId: string;
players: Player[];
turnId: string;
table: Card[];
canPlay: boolean;
}
// Maparea stării primite de la server
const handleGameState = (payload: GameState) => {
setGameState(payload);
// Dacă serverul zice că e rândul meu, activez UI-ul de joc
};
Lobby-uri cu PIN și Boți
Pentru a permite jocul cu prietenii, am implementat un sistem de lobby-uri protejate prin PIN. Fiecare lobby are o capacitate fixă de 4 jucători. Dacă un utilizator părăsește masa sau timpul de așteptare expiră, serverul injectează automat un bot (un simplu serviciu care rulează un algoritm de tip greedy pentru alegerea cărții).
Link-urile de partajare folosesc expo-linking. Când un utilizator dă click pe cruce://join/LOBBY_ID, aplicația se deschide automat, preia PIN-ul din deep link și trimite cererea de join prin WebSocket.
Concluzie
Arhitectura bazată pe un server autoritar este singura cale de a preveni trișatul în jocurile de cărți. Deși implementarea necesită un efort suplimentar în gestionarea stării, stabilitatea oferită de WebSocket-ul cu reconectare și securitatea oferită de Keycloak transformă aplicația dintr-un simplu prototip într-un produs robust.
Data viitoare, vom discuta despre optimizarea consumului de baterie în timpul sesiunilor lungi de joc prin utilizarea AppState și suspendarea socket-ului în background.

