PCSDK 릴리즈 노트

Unity · Unreal · Native 판을 한 문서에 모았어요. 버전 표기는 배포 파일의 버전과 같아요.

PCSDK 3.5.2 (2026-09-18)

핫픽스 배포본이에요. 3.4.x API 로 연동한 게임은 DLL 교체만으로 적용할 수 있어요.

개선 사항

• 초기화 시점의 대기 시간을 줄였어요. IP 주소 조회를 비동기로 처리하도록 바꿨어요.

PCSDK 3.5.1 (2026-09-10)

추가

• 게임 실행 시간을 기록할 때, 스토브 런처로 실행한 경우와 스팀 런처로 실행한 경우를 구분해요.

수정

• 윈도우 로그인 사용자 이름이 영문이 아닐경우 (한글, 베트남어 등등) 플레이타임이 기록되지 않던 문제를 수정했어요.

PCSDK 3.5.0 (2026-08-14)

기존 API 로 연동한 게임은 그대로 동작해요. 3.4.x API 는 계속 제공되며, 아래 신규 API 세트는 새로 연동하거나 연동을 다시 쓸 때 선택해요.

단일 바이너리 통합

기존 3.4.x 구 API를 사용하는 게임의 경우는 바이너리 통합과 상관없이 각각의 모듈 DLL을 그대로 사용하여야해요. 단일 DLL 통합은 신규 API를 사용할 경우에만 해당돼요.

• 모듈별로 나뉘어 있던 SDK 바이너리가 하나로 합쳐졌어요. Base · IAP · Log · PCBang · View 다섯 모듈이 한 바이너리에 들어가요.
• 모듈별 초기화 함수가 없어졌어요. Stove_Initialize 한 번으로 모든 기능을 쓸 수 있고, 종료는 Stove_Uninitialize 하나예요.
• 모듈별로 나뉘어 있던 버전 조회 함수도 Stove_GetVersion 하나로 합쳐졌어요.

신규 API 세트

• 함수 이름에서 모듈 토큰이 제거되었어요. Base_ · IAP_ · View_ · PCBang_ · Log_ · GameSupport_ · Ownership_ 접두사 대신 Stove_ 하나를 사용해요. (예: IAP_StartPurchase → Stove_StartPurchase)
• 파라미터 객체는 Stove_CreateParam(kind) 팩토리 하나로 생성해요.
• SDK 객체는 모두 IStove* 불투명 포인터로 다루고, 값은 접근자 함수로 읽어요. 객체 해제는 ShouldDestroy 가 true 인 경우에만 Destroy 를 호출하는 한 가지 규칙으로 통일되었어요.
• 확장 함수(Ex · Ex2)를 따로 두지 않아요. 기존 Ex 계열의 기능은 기본 함수 하나에 들어갔어요. (예: View_AutoPopup · View_AutoPopupEx → Stove_AutoPopup)

C 인터페이스 제공

• C++ 메서드와 C flat 함수 두 가지 형태를 함께 제공해요. C++ 문법을 쓸 수 없는 환경(순수 C, 다른 언어의 플러그인 개발 등)에서도 SDK 를 쓸 수 있어요.
• 헤더는 모듈마다 <module>_api.h · <module>_types.h · <module>_misc.h · <module>_flat_api.h 네 종류로 나뉘어요.
• 모든 모듈의 헤더를 한 줄로 포함하는 통합 헤더 stove_api.h 를 함께 제공해요.

팝업 정리

• IAP_CloseAllPopups 와 View_CloseAllPopups 로 나뉘어 있던 팝업 닫기가 Stove_CloseAllPopups 하나로 합쳐졌어요.
• 팝업 함수는 모두 팝업이 닫힐 때 콜백을 받아요. 종료 알림을 위해 Ex 함수를 따로 쓸 필요가 없어요.

신규 API 세트에 대응 항목이 없는 함수

아래 함수는 신규 API 세트에 대응하는 항목이 없어요. 3.4.x API 로 연동한 게임은 그대로 동작하므로 연동을 옮길 때만 확인하면 돼요.

특정 게임 전용으로 분리된 기능

• 캐릭터 조회(GamingServices_FetchCharacter)는 특정 타이틀 전용 기능으로 분리되었어요. 신규 API 세트에서는 제공하지 않아요.
• 게임 탈퇴(Stove_WithdrawGame)도 특정 타이틀 전용이에요.

함께 배포하는 모듈: APIModule 1.0.0

• 스팀 런처로 실행한 게임이 스토브 플랫폼 기능을 쓸 수 있게 하는 외부플랫폼연동모듈이 처음 배포되었어요.
• 게임 진입 체크 · 약관 조회 · 약관 동의 세 가지 API 를 제공해요.
• 지원 플랫폼은 스팀뿐이에요. Steamworks SDK 는 포함되어 있지 않으며, 게임이 이미 Steamworks SDK 를 연동하고 초기화한 상태를 전제로 동작해요.
• 사용자에게 보여 주는 화면은 모두 개발사가 구현해요. 모듈은 화면에 쓸 값과 결과 코드만 전달해요.

버전 업그레이드시 확인할 사항

• 3.4.x API 로 연동한 게임은 배포 패키지의 Partners 판을 받아 파일만 교체하면 돼요.
• 신규 API 로 연동하려면 Full 판을 받아요.
• 배포 파일은 windows 64bit(x64) 로 제공해요.

PCSDK 3.4.2 (2026-04-15)

긴급 안정성 패치예요. 3.4.0 이상을 연동한 게임은 DLL 교체만으로 적용할 수 있어요.

버그 수정

공통 (전체 모듈)

• 모든 SDK 모듈의 HTTP 호출이 드물게 실패하던 원인을 고치고 안정성을 강화했어요.

PCSDK 3.4.1 (2026-03-30)

기능 추가

BaseSDK

• Base_RestartAppIfNecessaryAsyncEx2: 다른 플랫폼(스팀 등) 연동을 위한 확장 함수예요. StovePCInitializeParamEx2 구조체로 platformName 필드를 지정해요.
• Base_InitializeEx: Base_RestartAppIfNecessaryAsync 계열 함수를 호출할 때 캐싱된 파라미터를 다시 써서 초기화해요.
• Base_GetCloudSavingPath: 클라우드 세이브 경로를 조회해요.
• Base_VietnamAgeRatingNotification: 베트남 연령등급 표시 기능이에요. 콜백으로 연령등급 오버레이 정보를 받아 게임에서 표시해요. 베트남 전용이에요.
• Base_VietnamOverimmersionNotification: 베트남 과몰입 알림 기능이에요. 게임 플레이 시작 이후 법령에 따른 주기마다 과몰입 경고 정보를 콜백으로 받아요. 베트남 전용이에요.
• Base_SetLanguage 지원 언어에 베트남어(vi)가 추가되었어요.
• 지원하지 않는 국가에서 호출할 때 반환되는 에러코드 NOT_SUPPORTED_COUNTRY(31)가 추가되었어요.

IAPSDK

• IAP_FetchProductsEx: 기존 IAP_FetchProducts 에 구매 가능 여부 코드(purchaseAvailabilityCode) 응답 필드를 더한 API 예요.
• IAP_FetchVoidedPurchasesEx: 기존 IAP_FetchVoidedPurchases 에 마켓 타입 매개변수(StovePCVoidedPurchasesMarketType)를 더한 API 예요.
• 스팀 환경 결제를 지원해요. 스팀 로그인을 지원하는 게임에서 IAP_StartPurchase 를 호출하면 스팀 오버레이로 결제할 수 있어요. Steamworks SDK 의 MicroTxnAuthorizationResponse_t 콜백을 받은 뒤 IAP_ConfirmPurchase 를 호출해 구매 검증을 마쳐요.

LogSDK

• LogSDK 가 새로 개발되었어요.
  • Log_Initialize · Log_UnInitialize: LogSDK 초기화와 정리
  • Log_Send: 게임에서 로그 서버로 로그를 전송해요. 전송된 로그는 BISKIT 에서 조회할 수 있으며, 자체 재시도 로직이 들어 있어요
  • Log_GetVersion: LogSDK 버전 조회

각 모듈 버전 조회 함수

• IAP_GetVersion · View_GetVersion · PCBang_GetVersion · GamingServices_GetVersion · Log_GetVersion 이 추가되었어요.

기능 변경

BaseSDK

• Base_SetLanguage · Base_SetLanguageEx 동작이 바뀌었어요.
  • GDS 정보를 기반으로 언어를 설정하는 기능이 제거되었어요.
  • "system" 값을 쓰면 OS 지역(region)이 아니라 OS UI 언어를 기준으로 설정돼요.
  • 입력값이 PCSDK 가 지원하지 않는 언어면 언어 코드를 설정하지 않고 실패를 반환해요.
  • "system" 을 쓸 때 OS 언어가 지원하지 않는 언어면 기본값 "en" 으로 설정돼요.
• 런처와 PCSDK3 의 환경 정보(빌드 환경 등)가 다르면 초기화가 실패하도록 바뀌었어요.

ViewSDK

• View_VerifyIdentificationPopup 이 한국(KR) 전용으로 바뀌었어요. 한국 외 국가에서 호출하면 오류가 반환돼요.

버그 수정

BaseSDK

• 글로벌 라이트 모드에서 ShutdownNotification 시간이 됐을 때 문구가 나오지 않던 현상을 고쳤어요.
• Refresh Token 로직을 개선했어요.
• 베트남 런처 · 라이트 모드에서 언어를 초기화할 때 베트남어로 설정되지 않던 현상을 고쳤어요.

ViewSDK

• SetPopupDisallowed 콜백이 두 번 호출되던 현상을 고쳤어요.

IAPSDK

• 라이트 모드 런처에서 SSO 연동 시 로그인 상태로 페이지가 이동하던 현상을 고쳤어요.
• 라이트 모드에서 게임 탈퇴 페이지가 노출되던 현상을 고쳤어요.

개선 사항

공통

• 시스템 로케일에 따라 내부 파싱이 동작하지 않던 현상을 고쳤어요.
• 로그 관련 예외 처리를 강화했어요.

PCSDK 3.4.0 (2025-10-17)

제한 사항

BaseSDK

• Base_OpenExternalUrl: 스토브 공식 홈페이지 연동을 쓸 때 일부 페이지에 접근 제한이 있어, 정상화될 때까지 새로 쓰는 것을 금지해요. 이미 연동 중이라면 개발사에서 따로 처리할 내용은 없어요.

기능 추가

BaseSDK

• Base_SetLanguageEx: 문자열로 언어를 설정하는 함수예요. 기존 함수보다 유연하게 언어를 설정할 수 있어요.
• Base_RestartAppIfNecessaryAsyncEx: 기존 Base_RestartAppIfNecessaryAsync 는 런처로 실행하지 않았으면 자동으로 런처를 실행하지만, 이 함수는 launchLauncher 파라미터로 런처 실행 여부를 고를 수 있어요. 보통은 기존 함수로 충분하며, 스팀 로그인 같은 특수한 경우에 쓰려고 추가했어요.

개선 사항

구조

• C# SDK 가 .NET 8.0 을 지원해요.
• REST API 호출이 네트워크 오류나 일시적인 서버 문제로 실패하면 자동으로 다시 시도해요.
• C++ 헤더 파일 이름을 모듈별로 명확하게 구분했어요.
• PCSDK 배포 zip 파일 구성을 바꿔 설치와 배포를 간단하게 했어요.

ViewSDK · IAPSDK 웹뷰

• 타이틀 바가 표시되는 스타일의 윈도우에서 STOVE 아이콘을 개선했어요.
• 아이콘이 흐리게 표시되던 부분을 고쳤어요.
• 아이콘 디자인을 최신화했어요.
• External 스타일 팝업의 Win32 윈도우 스타일을 수정했어요.
• WS_EX_TOPMOST 스타일을 적용해 결제창과 팝업이 항상 최상위에 표시돼요.

PCSDK 3.3.4 (2025-06-20)

기능 추가

BaseSDK

• Base_OpenExternalUrl: 온스토브 계열 홈페이지를 SSO 처리된 상태로 외부 브라우저(Chrome, Edge 등)에서 열어요.

ViewSDK

• View_VerifyIdentificationPopup: 본인 인증 팝업을 웹뷰로 열어요. SimKey 로 플랫폼 API 인증을 검증하는 방식과, 게임 서버로 SDI 값을 직접 받는 방식으로 나뉘어요.
• View_AutoPopupEx · View_ManualPopupEx · View_NewsPopupEx · View_CouponPopupEx: 기존 팝업 함수에 팝업을 닫을 때 이벤트가 오는 콜백을 더한 함수예요.
• View_AutoPopup · View_ManualPopup · View_NewsPopup 에 공통 NO_POPUP_DATA(87) 에러코드가 추가되었어요. 이전 버전에서 3.3.4 로 올릴 때는 ViewSDK 연동 가이드의 87 코드 처리 예제를 확인하세요. Ex 함수에도 똑같이 적용돼요.

IAPSDK

• IAP_WithdrawGame: 게임 탈퇴(약관 해지) 팝업을 웹뷰로 열어요.
• IAP_StartPurchaseEx · IAP_FetchTermsAgreementEx · IAP_StartPaymentEx: 기존 팝업 함수에 팝업을 닫을 때 이벤트가 오는 콜백을 더한 함수예요.

버그 수정

BaseSDK

• Base_RestartAppIfNecessary: 해상도를 바꾸고 재시작할 때 실패를 반환해야 하는 경우에도 정상으로 반환되던 오류를 고쳤어요.

기능 삭제

ViewSDK

• View_PopupDestroyNotification 이 3.3.4 부터 삭제되었어요. 대신 API 별로 종료 팝업 이벤트가 추가된 Ex 함수를 쓰세요.

IAPSDK

• IAP_PopupDestroyNotification 이 3.3.4 부터 삭제되었어요. 대신 API 별로 종료 팝업 이벤트가 추가된 Ex 함수를 쓰세요.

PCSDK 3.3.3 (2025-03-24)

안정성 개선

BaseSDK

• Base_GetOverImmersion · Base_GetShutdown · Base_GetRenewToken: (Unity) 3.3.3 이전 버전에서 빠져 있던 C# 함수를 하위 호환을 위해 복구했어요.

기능 개선

IAPSDK

• IAP_InitializeWithWndInfo: 초기화할 때 WebView2 의 부모 윈도우를 직접 지정할 수 있어요. 기존 초기화 함수는 메인 윈도우가 하나일 때는 정상 동작하지만, 숨겨진 윈도우가 있는 환경에서는 SDK 가 메인 윈도우를 찾지 못할 수 있어요.
• IAP_PopupDestroyNotification: 웹뷰 팝업이 닫힐 때 알림을 받는 콜백이에요. 메인 윈도우의 dimmed 처리를 비롯해 팝업 상태에 따른 게임 로직을 조정할 수 있어요.

ViewSDK

• View_InitializeWithWndInfo: 초기화할 때 WebView2 의 부모 윈도우를 직접 지정할 수 있어요.
• View_PopupDestroyNotification: 웹뷰 팝업이 닫힐 때 알림을 받는 콜백이에요.
• View_AutoPopup · View_ManualPopup: STOVE 파트너스에서 설정한 팝업 타입 중 외부 브라우저를 띄울 수 있게 개선했어요. 전달받은 URL 의 프로토콜이 stovewebs:// 이면 외부 브라우저에서 열어요.
• Internal 팝업 창을 드래그해 부모 게임 윈도우 밖으로 완전히 벗어나면 다시 드래그할 수 없던 현상이 있어, 창이 밖으로 나가지 않도록 이동을 제한했어요.

버그 수정

공통

• Windows 제어판의 프록시 설정과 내부 REST API 가 쓰는 프록시 설정이 달라 네트워크 통신이 되지 않던 문제가 있어, IE 의 프록시 설정을 가져와 쓰도록 바꿨어요.
• 팝업을 닫을 때(CloseAllPopups 호출) 드물게 크래시가 나던 것을 고쳤어요.

IAPSDK

• 게스트 계정을 정회원으로 전환한 뒤 결제할 때 IAP 오류가 나던 문제를 고쳤어요. SDK 내부의 MemberNo 기반과 GUID 기반 구분 로직에 오류가 있었어요.

BaseSDK

• SDK 내부에서 setlocale() 로 UTF-8 을 설정하던 코드를 제거했어요. 개발사가 setlocale() 을 직접 설정하는 경우 SDK 설정이 덮어쓰는 문제가 있었어요.

문서 보완

IAPSDK

• IAP_StartPurchase 매개변수 구조체의 serviceTxnNo · extraData 멤버 설명을 보완했어요.

PCSDK 3.3.2.19 (2024-11-27)

BaseSDK · IAPSDK · ViewSDK · PCBangSDK · GamingServicesSDK

• Sentry 로그를 강화했어요.
• API 명세서 영문판(주석)을 작성했어요.
• (Unity · Unreal · Native) 하위 호환을 위해 Base_GetOverImmersion() · Base_GetShutdown() 을 추가했어요.
• (Unreal · Native) 언리얼 엔진 로그 구현 방법 예제를 추가했어요.

PCSDK 3.3.2.1 (2024-11-08)

BaseSDK · IAPSDK · ViewSDK · PCBangSDK · GamingServicesSDK

• 프록시 때문에 네트워크 통신이 실패하던 이슈를 고쳤어요.
• 팝업을 닫을 때(CloseAllPopups 호출) 나던 크래시를 고쳤어요.

PCSDK 3.3.2 (2024-11-01)

(Unreal · Native)

문서 보완

• IAPSDK API 명세서의 빌링 구조체 항목 설명을 보완했어요.

기능 수정

• 프록시 설정 때문에 네트워크 통신이 실패하던 이슈를 고쳤어요. WinHttpSendRequest: 2148074245 가 나면서 REST API 통신이 실패하던 문제예요.
• 과몰입 방지 메시지가 접속 시간과 무관하게 매시 정각마다 나오던 이슈를 고쳤어요.
• Base_GetRenewToken · Base_GetOverImmersion · Base_GetShutdown 을 쓸 때 오류가 나던 현상을 고쳤어요.
• 파트너스에서 웹뷰 닫기 버튼을 다른 이미지로 설정해도 적용되지 않던 현상을 고쳤어요.
• member_no 게임에서 정회원으로 전환된 게스트 계정으로 로그인할 때 11237 에러가 내려오던 현상을 고쳤어요.
• PC 가 절전 · 잠금 모드로 들어가도 토큰을 갱신하도록 바꿨어요.

PCSDK 3.2.3.1 (2024-10-22)

(Unity) BaseSDK · IAPSDK · ViewSDK · PCBangSDK · GamingServicesSDK

• 화면 보호 · 컴퓨터 잠금 상태에서도 토큰을 갱신하도록 바꿨어요.

PCSDK 3.2.3 (2024-08-08)

IAPSDK

• 할인을 설정하지 않은 상품을 조회할 때 discountType 이 FIXED_RATE 로 응답되던 현상을 고쳤어요.

PCSDK 3.2.2 (2024-07-30)

BaseSDK

• 게임시간 선택제 대상자가 셧다운 상태에 들어갔을 때 콜백 함수가 호출되지 않던 문제를 고쳤어요.

PCSDK 3.2.1 (2024-07-26)

BaseSDK

• (Unity) 유니티에서 지표(동시접속자 수)를 전송하지 못하던 현상을 고쳤어요.

IAPSDK

• CPU 점유율이 높던 현상을 고쳤어요.

ViewSDK

• CPU 점유율이 높던 현상을 고쳤어요.

GamingServicesSDK

• FetchCharacter 의 콜백 형상을 변경했어요.

PCSDK 3.1.5 · 3.1.4 (Unity) (2024-07-12 · 2024-07-14)

Unity 판만 모듈별로 배포한 버전이에요.

BaseSDK 3.1.5 (2024-07-12)

• BaseSDK.dll 의 Instance Handle 로 경로를 얻어 버전 정보를 설정하도록 바꿨어요.
• 5분마다 HeartBeat 를 전송하도록 바꿨어요.

IAPSDK 3.1.4 · ViewSDK 3.1.4 (2024-07-14)

• 결제와 팝업이 뜨지 않은 상황에서도 CPU 를 10~15% 점유하던 문제를 고쳤어요.

PCSDK 3.1.4 (2024-07-05)

BaseSDK

• 런처와 PCSDK3 의 IPC 통신 장애에 대한 방어 코드를 적용했어요.

PCSDK 3.1.3 (2024-07-02)

BaseSDK

• 프로토콜 핸들러로 런처를 실행할 때 cmd 창이 뜨던 현상을 고쳤어요.
• 토큰 만료에 대한 예외 처리를 추가했어요.

IAPSDK

• IAP_CloseAllPopups 를 추가했어요.
• IAP_StartPurchase: GUID 게임이 아닌 게임에 GUID 필드로 member no. 가 내려오는 경우의 예외 처리를 추가했어요.
• 결제창 WebView2 가 실행될 때 이전 결제창 WebView2 를 닫는 동선을 추가했어요.
• IAP_FetchProducts 결과에 필드를 추가했어요.
  • CategoryName: 카테고리 이름
  • SaleBeginDate: 판매 시작 일자(epoch time milliseconds)
  • SaleEndDate: 판매 종료 일자(epoch time milliseconds)

ViewSDK

• View_CloseAllPopups 를 추가했어요.

PCSDK 3.1.2 (2024-06-10)

ViewSDK

• 윈도우 7 및 8.1 대응 코드를 업데이트했어요.

PCSDK 3.1.1 (2024-06-05)

ViewSDK

• Internal 결제창을 띄울 때 간헐적으로 나던 팝업 이슈를 고쳤어요.

PCSDK 3.1.0 (2024-05-31)

BaseSDK

• RestartAppIfNecessary: 런처에서 게임이 실행되었는지 검증한 결과를 제공해요.
• GetSignin: 사용자의 가입 정보(부모 동의 여부, 이메일 인증 정보, 가입 국가)를 제공해요.
• GetGds: 사용자의 접속 국가 정보(지역 코드, 타임존, 언어, UTC 정보 등)를 제공해요.
• SetLanguage: API 에서 쓸 언어에 중국어 번체(zh-tw)가 추가되었어요.
• WebViewMode 열거형 값이 바뀌었어요.
  • 이전: EXTERNAL(0) · INTERNAL_NORMAL(1) · INTERNAL_PRETTY(2)
  • 이후: EXTERNAL(0) · INTERNAL(1)

IAPSDK

• StovePCChargeInfo 구조체를 추가했어요.
• StovePCPurchaseResult 의 일부 메서드 이름을 바꾸고 StovePCChargeInfo 관련 메서드를 추가했어요.
• StovePCPurchaseProduct 를 StovePCPurchasedProduct 로 바꿨어요.

ViewSDK

• WebView2 레이아웃을 변경했어요. 팝업창 WebView2 의 기본 창 디자인을 작업했어요.

PCSDK 3.0.3 (2024-04-19)

• PCBangSDK 모듈을 추가했어요.

PCSDK 3.0.2 (2024-04-09)

• IAP 결제 동선에 테스트 모드를 추가했어요.
• IAP_StartPurchase 에 개발사가 원하는 임의 정보(Extra Data)를 넣을 수 있는 필드를 추가했어요.
• WebView2 기능을 개선했어요.
  • Window Event 가 입력될 때 게임이 멈추던 현상을 고쳤어요.
  • External 로 띄웠을 때 STOVE 아이콘을 표시해요.

PCSDK 3.0.1.58 (2024-02-26)

빌드 환경 지원

• Unity 빌드에서 스크립팅 백엔드(Scripting Backend) IL2CPP 모드를 지원해요.

내부 로직 변경

• 인게임용 웹토큰 발급 내부 로직을 변경했어요.
• Unity x64 에서 IAP_FetchProducts 를 호출하는 내부 로직을 변경했어요.
• 1회용 결제 URL 내부 로직을 변경했어요.
• PCSDK 3.0 로그 지표를 수정했어요.

PCSDK 3.0.0.4 (2024-02-01)

PCSDK3 최초 배포예요.

• 단일 어셈블리였던 StovePCSDK 를 여러 SDK 모듈로 나눴어요.
• 모바일 SDK 와 API 사용 방법을 맞췄어요.
• Microsoft WebView2 로 웹뷰를 쓸 수 있어요.
• 비동기 API 를 쓸 때 콜백을 등록할 수 있어요.