SDK 사용법

npm install connectbase-client

import { ConnectBase, GameRoom } from 'connectbase-client'

// SDK 초기화
const cb = new ConnectBase({
    appId: 'YOUR_APP_ID',
    publicKey: 'cb_pk_...'
})

// 게임 룸 클라이언트 생성
const game = cb.game.createClient({
    clientId: 'unique-player-id'  // 고유 클라이언트 ID
})

interface GameRoomOptions {
    clientId: string           // 필수: 고유 클라이언트 ID
    publicKey: string          // 필수: Public Key (cb_pk_*)
    userId?: string            // 선택: 인증된 사용자 ID
    serverUrl?: string         // 선택: 커스텀 서버 URL
    reconnect?: boolean        // 선택: 자동 재연결 (기본 true)
    reconnectDelay?: number    // 선택: 재연결 딜레이 (기본 1000ms)
    maxReconnectAttempts?: number  // 선택: 최대 재연결 시도 (기본 5)
}

// 서버에 연결
await game.connect()

// 룸 생성
const state = await game.createRoom({
    roomId: 'my-room-123',
    maxPlayers: 10,
    tickRate: 64,
    metadata: {
        gameMode: 'deathmatch',
        map: 'arena'
    }
})

// 룸 참가
const state = await game.joinRoom('room-id', {
    nickname: 'Player1',
    team: 'red'
})

// 룸 퇴장
await game.leaveRoom()

// 룸 목록 조회
const rooms = await game.listRooms()

// 연결 이벤트
game.on('onConnect', () => console.log('연결됨'))
game.on('onDisconnect', (reason) => console.log('연결 해제:', reason))
game.on('onReconnecting', (attempt) => console.log('재연결 중...'))

// 플레이어 이벤트
game.on('onPlayerJoined', (player) => console.log('입장:', player.clientId))
game.on('onPlayerLeft', (player) => console.log('퇴장:', player.clientId))

// 상태 업데이트
game.on('onStateUpdate', (gameState) => {
    updateGameWorld(gameState.state)
})

// 델타 업데이트
game.on('onDelta', (delta) => {
    for (const change of delta.changes) {
        applyChange(change)
    }
})

// 채팅
game.on('onChat', (msg) => console.log(msg.clientId + ': ' + msg.message))

// 커스텀 이벤트
game.on('onEvent', (event) => {
    if (event.type === 'player_died') {
        showDeathScreen(event.data)
    }
})

// 기본 액션
game.sendAction({
    type: 'move',
    data: { x: 100, y: 200, direction: 'right' }
})

// 신뢰성 있는 액션 (중요한 이벤트)
game.sendAction({
    type: 'use_skill',
    data: { skillId: 'fireball', targetId: 'enemy_123' }
}, true)  // reliable = true

// 채팅 전송
game.sendChat('Hello!')

interface GameState {
    roomId: string
    state: Record<string, unknown>
    version: number
    serverTime: number
    tickRate: number
    players: GamePlayer[]
}

interface GamePlayer {
    clientId: string
    userId?: string
    joinedAt: number
    metadata?: Record<string, string>
}

interface GameRoomInfo {
    id: string
    appId: string
    playerCount: number
    maxPlayers: number
    tickRate: number
    isRunning: boolean
    metadata?: Record<string, string>
}