connectbase-client 5.12.5 → 5.12.6

package/CHANGELOG.md

@@ -3,6 +3,30 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [5.12.6] - 2026-08-09
+
+### Fixed — `VoiceChannel` 타입에 실재하지 않는 `webrtc_room_id` 필드가 있어 `cb.webrtc.connect()` 체이닝이 항상 실패하던 문제
+
+문서와 SDK 타입이 `cb.game.joinVoiceChannel()`의 응답에 `id`/`name`/`type`/`members`/
+`webrtc_room_id` 등의 필드가 있는 것처럼 기술하고 있었지만, game-server의 실제 라이브
+핸들러(Push-To-Talk 기반 `Handler.JoinRoom`)는 `{ room_id, player_id, status }` 만
+반환합니다. 예전에 이 필드들을 채워주던 `VoiceChatManager`/`CreateWebRTCRoom` 코드는
+실제로는 어떤 라우트에도 연결돼 있지 않은 죽은 코드였습니다.
+
+문서를 그대로 따라 `cb.webrtc.connect({ roomId: voiceChannel.webrtc_room_id, ... })`처럼
+체이닝하면 `webrtc_room_id`가 항상 `undefined`라 시그널링 `join` 메시지의 `room_id`가
+누락되고, 서버가 매번 `"room_id is required"`로 거부해 음성/화상 연결이 끝까지 완료되지
+못했습니다.
+
+`VoiceChannel` 타입을 실제 서버 응답(`{ room_id, player_id, status }`)에 맞게 수정했습니다.
+근본적으로, game-server의 음성 채널(Push-To-Talk)과 `cb.webrtc.connect()`(webrtc-server
+SDP/ICE 시그널링)는 애초에 서로 무관한 별개 기능입니다 — 실시간 음성 채널 오디오는
+`cb.webrtc.connect()`가 아니라 전용 WebSocket(`GET /v1/game/:appID/voice/ws?player_id=&
+room_id=`)으로 전송됩니다. 문서(`14-sdk-game.md`, `docs/game-server/QUICKSTART.md`)도
+이 경계를 명확히 하도록 갱신했습니다.
+
+플랫폼 이슈 `019fe5bb` 제보.
+
 ## [5.12.5] - 2026-08-09
 
 ### Fixed — `cb.webrtc`의 REST 메서드 4개가 전부 core 서버로 가서 404였던 문제

package/dist/index.d.mts

@@ -4146,16 +4146,19 @@ interface MatchResult {
     rating_change: number;
     played_at: string;
 }
+/**
+ * `joinVoiceChannel()` 응답 — game-server 의 PTT(Push-To-Talk) 방 참가 확인.
+ *
+ * 실시간 오디오는 이 응답이 아니라 별도 WebSocket
+ * (`GET /v1/game/:appID/voice/ws?player_id=&room_id=`)으로 전송된다. `cb.webrtc.connect()`
+ * (webrtc-server 의 SDP/ICE 시그널링)와는 무관한 별개 경로다 — 과거 문서/타입이 `id`/`name`/
+ * `type`/`members`/`webrtc_room_id` 등을 포함하는 것처럼 기술했으나, 실제 서버 응답에는
+ * 존재하지 않아 항상 `undefined`였다(platform-issue 019fe5bb).
+ */
 interface VoiceChannel {
-    id: string;
     room_id: string;
-    name: string;
-    type: "global" | "team" | "proximity" | "private" | "spectator";
-    team_id?: string;
-    max_members: number;
-    members: Record<string, VoiceMember>;
-    webrtc_room_id: string;
-    created_at: string;
+    player_id: string;
+    status: string;
 }
 interface VoiceMember {
     player_id: string;

package/dist/index.d.ts

@@ -4146,16 +4146,19 @@ interface MatchResult {
     rating_change: number;
     played_at: string;
 }
+/**
+ * `joinVoiceChannel()` 응답 — game-server 의 PTT(Push-To-Talk) 방 참가 확인.
+ *
+ * 실시간 오디오는 이 응답이 아니라 별도 WebSocket
+ * (`GET /v1/game/:appID/voice/ws?player_id=&room_id=`)으로 전송된다. `cb.webrtc.connect()`
+ * (webrtc-server 의 SDP/ICE 시그널링)와는 무관한 별개 경로다 — 과거 문서/타입이 `id`/`name`/
+ * `type`/`members`/`webrtc_room_id` 등을 포함하는 것처럼 기술했으나, 실제 서버 응답에는
+ * 존재하지 않아 항상 `undefined`였다(platform-issue 019fe5bb).
+ */
 interface VoiceChannel {
-    id: string;
     room_id: string;
-    name: string;
-    type: "global" | "team" | "proximity" | "private" | "spectator";
-    team_id?: string;
-    max_members: number;
-    members: Record<string, VoiceMember>;
-    webrtc_room_id: string;
-    created_at: string;
+    player_id: string;
+    status: string;
 }
 interface VoiceMember {
     player_id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "connectbase-client",
-	"version": "5.12.5",
+	"version": "5.12.6",
 	"description": "Connect Base JavaScript/TypeScript SDK for browser and Node.js",
 	"repository": {
 		"type": "git",