- 마지막 업데이트
외부플랫폼연동모듈 릴리즈 노트
Native · Unity 판을 한 문서에 모았어요. 버전 표기는 배포 파일의 버전과 같아요.
| 버전 | 배포일 | 요약 |
|---|---|---|
| 1.0.0 | 2026-08-14 | 최초 배포 |
APIModule 1.0.0 (2026-08-14)
2026-08-14 에는 Native 판이 먼저 배포되었어요. 나머지 판은 2026년 8월 말에 배포될 예정이에요.
외부플랫폼연동모듈의 최초 배포예요.
이 모듈이 하는 일
- 스팀 런처로 실행된 게임이 스토브 런처로 실행한 것과 똑같이 스토브 플랫폼 기능을 쓸 수 있도록 이어 줘요.
- 스팀에서 인증된 사용자 정보로 스토브 플랫폼 인증을 처리하고, 게임 진입에 필요한 토큰과 회원 정보를 확보하는 데까지가 이 모듈의 역할이에요.
- 게임 진입 체크에 성공하면 이어서 PCSDK3 를 기동해요.
제공 기능
| 기능 | 함수 |
|---|---|
| 초기화 · 종료 | Stove_APIModule_Initialize · Stove_APIModule_UnInitialize |
| 게임 진입 체크 | Stove_APIModule_GameCheckerForSteam |
| 약관 조회 | Stove_APIModule_FetchGameTermsForSteam |
| 약관 동의 | Stove_APIModule_AgreeToGameTermsForSteam |
| 지역 정보 조회 | Stove_APIModule_GetGdsInfo |
| 언어 설정 | Stove_APIModule_SetLanguage |
| 버전 조회 | Stove_APIModule_GetVersion |
| 콜백 실행 | Stove_APIModule_RunCallback |
- 비동기 함수의 결과는 콜백으로 전달되며, 콜백은
Stove_APIModule_RunCallback을 호출한 스레드에서 실행돼요. - 파라미터 객체는
Stove_APIModule_CreateParam팩토리로 만들어요. (Native 전용)
제공 형태
- Native 판과 Unity(.NET) 판을 제공해요.
- Native 배포 바이너리는
APIModule.dll이며, 공개 헤더는api_module.h·api_module_types.h·api_module_flat.h·api_module_misc.h네 종류예요. - 인터페이스 멤버는 C++ 가상 함수와 C flat 접근자 두 형태로 제공되며 동작은 같아요. C++ 문법을 쓸 수 없는 환경에서도 연동할 수 있어요.
결과 코드
- 통신 · 응답 처리 단계에서 모듈이 판정하는 공통 코드
EStoveModuleCommonResultCode를 제공해요. - 서버가 내려주는 코드는 API 별로 나뉘어요.
EStoveGameCheckerForSteamResultCode·EStoveFetchGameTermsForSteamResultCode·EStoveAgreeToGameTermsForSteamResultCode예요. - 두 값은 얻는 곳이 달라요. 공통 코드는 결과 객체에서 조회하고, API 별 코드는 콜백 결과의 외부 오류 값에서 조회해요. 실패 원인을 정확히 알려면 두 값을 함께 확인해야 해요.
연동할 때 알아 둘 것
- 지원 플랫폼은 스팀(Steam) 하나예요. 다른 외부 플랫폼은 제공하지 않아요.
- 이 모듈은 Steamworks SDK 를 포함하지 않아요. 게임이 Steamworks SDK 를 이미 연동하고 초기화해 두었다는 것을 전제로 동작해요.
- 사용자에게 보여 줄 화면(약관 동의 · 접속 불가 안내 · 제재 안내 · 점검 안내 · 오류 팝업)은 모두 개발사가 구현해요. 모듈은 화면에 넣을 값과 결과 코드만 전달해요.
- 제재 · 점검 · 약관 미동의 세 가지는 API 가 사용자에게 보여 줄 문구를 함께 내려줘요. 받은 값을 그대로 표시하면 돼요.