Skip to content
스토어 연동
마지막 업데이트

PC SDK native 레퍼런스

SDK 버전 3.5.3 기준이에요. 항목 106개를 이름순으로 모은 통합 문서예요.

Contents

NameKindModule
기본 연동 안내연동 안내Base
EStoveBaseMethodCode열거형Base
EStoveBaseTypeKind열거형Base
EStoveCommonResultCode결과코드Base
EStoveDiscountType열거형IAP
EStoveGameSupportMethodCode열거형GameSupport
EStoveGameSupportTypeKind열거형GameSupport
EStoveIAPMethodCode열거형IAP
EStoveIAPTypeKind열거형IAP
EStoveLogMethodCode열거형Log
EStoveLogTypeKind열거형Log
EStoveOverlayMode열거형Base
EStoveOwnershipCode열거형Ownership
EStoveOwnershipGameCode열거형Ownership
EStoveOwnershipMethodCode열거형Ownership
EStoveOwnershipTypeKind열거형Ownership
EStoveProductTypeCode열거형IAP
EStovePurchaseLimitTypeCode열거형IAP
EStovePurchaseOperation열거형IAP
EStovePurchaseProgress열거형IAP
EStoveResultCode결과코드Base
EStoveTermsOperation열거형IAP
EStoveWebViewMode열거형Base
IStoveAccessToken구조체Base
IStoveAchievement구조체GameSupport
IStoveAchievementCondition구조체GameSupport
IStoveAchievementList구조체GameSupport
IStoveCallbackResult구조체Base
IStoveChargeInfo구조체IAP
IStoveConfirmPurchaseOutcome구조체IAP
IStoveConfirmPurchaseParam구조체IAP
IStoveFetchAchievementParam구조체GameSupport
IStoveFetchAchievementsParam구조체GameSupport
IStoveFetchProductsParam구조체IAP
IStoveFetchRankingParam구조체GameSupport
IStoveFetchStatParam구조체GameSupport
IStoveFetchTermsAgreementParam구조체IAP
IStoveGds구조체Base
IStoveInitializeParam구조체Base
IStoveInventoryItem구조체IAP
IStoveInventoryList구조체IAP
IStoveOrderProductParam구조체IAP
IStoveOverImmersionInfo구조체Base
IStoveOwnership구조체Ownership
IStoveOwnershipList구조체Ownership
IStoveProduct구조체IAP
IStoveProductList구조체IAP
IStovePurchasedProduct구조체IAP
IStovePurchaseParam구조체IAP
IStoveRank구조체GameSupport
IStoveRanking구조체GameSupport
IStoveRestartAppIfNecessaryOutcome구조체Base
IStoveRestartAppIfNecessaryParam구조체Base
IStoveResult구조체Base
IStoveSendLogParam구조체Log
IStoveSetGameProfileParam구조체Base
IStoveSetStatOutcome구조체GameSupport
IStoveSetStatParam구조체GameSupport
IStoveShopCategory구조체IAP
IStoveShopCategoryList구조체IAP
IStoveShutdownInfo구조체Base
IStoveSignin구조체Base
IStoveStartPurchaseOutcome구조체IAP
IStoveStartPurchaseParam구조체IAP
IStoveStat구조체GameSupport
IStoveStatFullId구조체GameSupport
IStoveTermsAgreementOutcome구조체IAP
IStoveTypeBase구조체Base
IStoveUser구조체Base
IStoveVietnamAgeRatingInfo구조체Base
IStoveVietnamOverimmersionInfo구조체Base
IStoveWebViewLayoutParam구조체IAP
Stove_AccessTokenRenewed함수Base
Stove_CloseAllPopups함수Base
Stove_ConfirmPurchase함수IAP
Stove_CreateParam함수Base
Stove_FetchAchievement함수GameSupport
Stove_FetchAchievements함수GameSupport
Stove_FetchInventory함수IAP
Stove_FetchOwnerships함수Ownership
Stove_FetchProducts함수IAP
Stove_FetchRanking함수GameSupport
Stove_FetchShopCategories함수IAP
Stove_FetchStat함수GameSupport
Stove_FetchTermsAgreement함수IAP
Stove_GetAccessToken함수Base
Stove_GetCloudSavingPath함수Base
Stove_GetGds함수Base
Stove_GetSignin함수Base
Stove_GetUser함수Base
Stove_GetVersion함수Base
Stove_Initialize함수Base
Stove_OpenExternalUrl함수Base
Stove_OverImmersionNotification함수Base
Stove_RestartAppIfNecessary함수Base
Stove_RunCallback함수Base
Stove_RunCallbackWithTimeout함수Base
Stove_SendLog함수Log
Stove_SetGameProfile함수Base
Stove_SetLanguage함수Base
Stove_SetStat함수GameSupport
Stove_ShutdownNotification함수Base
Stove_StartPurchase함수IAP
Stove_Uninitialize함수Base
Stove_VietnamAgeRatingNotification함수Base
Stove_VietnamOverimmersionNotification함수Base

기본 연동 안내

종류 연동 안내 · 모듈 Base · 버전 3.5.0

Description

구 API와 신규 API를 한 게임에서 섞어 쓸 수 없어요. 이 문서가 다루는 신규 API 로 연동하기로 했다면 연동 코드 전체를 신규 API 로 작성해야 해요. 두 방식을 함께 쓰면 초기화 경로와 배포 파일 구성이 서로 어긋나서 동작을 보장할 수 없어요. 기존 3.4.x API 연동을 그대로 두는 경우에는 그 벌의 레퍼런스를 보세요.

Stove PCSDK Native API 는 크게 C++ 메서드 형태와 C flat 함수 형태의 2가지 선언을 각각 제공하며, 환경에 따라 편의에 맞게 선택해 사용할 수 있어요.

  • 일반적인 C/C++ 개발환경에서는 C++ 메서드 형태를 간편하게 사용할 수 있어요.
  • C flat 함수는 C++ 문법을 사용할 수 없는 환경에서 사용이 가능해요. (golang, js 기반 게임엔진 플러그인 개발 등)

C++ 을 쓸 수 있는 개발 환경이라면 C++ 메서드 형태를 쓰는 편이 편리해요. 코드가 짧고 형 변환도 줄어들어요. C flat 함수는 C++ 문법을 쓸 수 없는 개발 환경에서 연동하려고 마련한 것이며, Steamworks SDK 가 C++ 인터페이스와 별도로 C 헤더를 제공하는 것과 같은 목적이에요.

모든 SDK 오브젝트는 IStove* 불투명 포인터로 표현되며, Stove_<Interface>_<Method>(self, ...) 형식의 접근자 함수를 통해 속성에 접근해요.

헤더 파일은 단일 바이너리(BaseSDK) 통합에 따라 모듈별 4종 형태로 제공돼요.

FileRole
<module>_api.hSDK 자유함수 (Stove_Initialize 등) 선언
<module>_types.hC++ 환경: IStove* 인터페이스 정의 (순수 가상 함수). C 환경: 불투명 typedef struct
<module>_misc.h열거형 정의 (EStove<Module>TypeKind, EStove<Module>MethodCode, EStove<Module>ResultCode)
<module>_flat_api.h인터페이스 멤버에 대한 C flat 접근자 (Stove_<Interface>_<Method>)

통합 헤더 stove_api.h: 모듈별 위 4종 헤더를 모두 묶은 우산(umbrella) 헤더예요. 이 가운데 스토어인디 게임에서 쓸 수 있는 것은 Base · GameSupport · IAP · Log · Ownership 5개 모듈이에요. PC방은 스토어인디에서 공식 지원하지 않아요. #include "stove_api.h" 한 줄로 모든 모듈의 공개 C API 를 한 번에 포함할 수 있으므로, 개별 모듈 헤더를 따로 include 할 필요가 없어요. (필요한 모듈만 골라 개별 헤더를 include 하는 방식도 그대로 사용할 수 있어요.)

배포 파일: 신규 API 만 사용하면 게임과 함께 배포하는 파일은 BaseSDK.dll 하나예요. 모듈별로 배포하던 IAPSDK.dll · OwnershipSDK.dll · GameSupportSDK.dll 은 포함하지 않아요.

배포 패키지에는 스토어인디 게임에서 쓸 수 없는 모듈의 헤더도 함께 들어 있어요. 팝업(view_*)은 파트너스 게임 전용이에요. stove_api.h 로 한 번에 포함하면 이 헤더도 따라 들어오지만, 선언만 보일 뿐 호출하면 안 돼요.

Declaration Forms

본 문서는 대상에 따라 아래 형태로 구분해 표기해요.

TargetNotation
SDK API 함수 (Stove_Initialize 등)C flat 함수 (자유 함수, C/C++ 동일 시그니처)
인터페이스 멤버 (GetNickName, SetGameId 등)C++ 메서드 + C flat 함수
콜백콜백 typedef
  • C++ 메서드: *_types.h 안의 IStove* 인터페이스 구조체에 정의된 멤버 함수예요. 대부분의 컴파일러는 C++ 을 지원하므로 이 형태를 그대로 사용해 self->Method() 처럼 직접 호출할 수 있어요.
  • C flat 함수: *_api.h / *_flat_api.h 에서 extern "C" + __cdecl 로 공개되는 진입점이에요. 순수 C 또는 C# 등 C++ vtable 호출이 불가능한 환경을 위해 제공되며, C++ 환경에서도 동일하게 호출할 수 있어요.
  • 두 형태는 동일한 동작을 수행해요. C flat 함수는 내부적으로 해당 객체의 C++ 메서드를 호출해요.

SDK API 함수(Stove_<Method>)는 인터페이스 멤버가 아닌 자유 함수예요. *_api.h 에서 extern "C" 로 선언되어, C++ 메서드와 C flat 함수(C/C# 환경) 모두 동일한 시그니처로 호출돼요. (예: IStoveResult* Stove_Initialize(const IStoveInitializeParam* initParam);: C 에서도 C++ 에서도 동일 호출)

헤더에는 각 C flat 함수의 함수 포인터 typedef (<함수명>_t) 도 함께 선언되어 있지만 본 문서에서는 별도 표기하지 않아요. 동적 로딩(GetProcAddress) 용도가 필요할 때만 참고하세요.

각 함수 문서의 ## Example 은 두 형태를 C · C++ 탭으로 나란히 싣어요. 같은 API 를 어느 쪽으로 호출해도 결과가 같으므로 프로젝트 환경에 맞는 탭 하나만 보면 돼요.

Tab쓰는 곳인터페이스 멤버 접근객체 해제
CC 프로젝트, 또는 vtable 호출을 쓸 수 없는 환경Stove_IStoveResult_IsSuccessful(result)Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result)
C++*_types.h 의 인터페이스를 그대로 쓰는 C++ 프로젝트result->IsSuccessful()result->Destroy()

SDK API 함수(Stove_<Method>)는 두 탭에서 같아요. 달라지는 것은 인터페이스 멤버 접근과 해제 표기뿐이에요. 여기서 말하는 C++ 는 신규 인터페이스를 C++ 문법으로 호출하는 것이며, 구 C++ 인터페이스(Stove::PCSDK::<Module>, old_native/)와는 달라요.

Naming Rules

CategoryPatternExample
SDK 함수Stove_<Method> (모듈 토큰 없는 자유 함수)Stove_Initialize, Stove_StartPurchase, Stove_FetchProducts
파라미터 객체 통합 팩토리Stove_CreateParam(int kind)Stove_CreateParam(k_EStoveBaseTypeKind_InitializeParam)
인터페이스 접근자Stove_<Interface>_<Method>Stove_IStoveUser_GetNickName(user)
콜백 타입On<Action>CallbackOnRestartAppIfNecessaryCallback
열거형 값k_E<Enum><Value>k_EStoveCommonResultCode_Success

Memory Lifetime

SDK 오브젝트는 IStoveTypeBase 가 가진 ShouldDestroy 플래그에 따라 해제 책임이 결정돼요.

일반 규칙: 어떤 SDK 오브젝트든 다음 한 줄로 해제 여부를 판단할 수 있어요.

c
if (Stove_IStoveTypeBase_ShouldDestroy(obj))   // C++ 에서는 obj->ShouldDestroy()
    Stove_IStoveTypeBase_Destroy(obj);         // C++ 에서는 obj->Destroy()

객체의 출처(Factory 생성·동기 반환·out 파라미터·콜백 동반·Getter 반환)를 일일이 외울 필요 없이 ShouldDestroy() 의 반환값에 따라 Destroy 하면 누수도 이중 해제도 발생하지 않아요. 아래 표는 각 경로에서 ShouldDestroy 가 어떤 값을 반환하는지 참고용으로 정리한 것이에요.

Factory 로 생성한 객체는 반드시 호출자가 해제: 통합 팩토리 Stove_CreateParam(<TypeKind>) 으로 반환된 모든 구조체 포인터는 ShouldDestroy == true 이며, 사용이 끝난 뒤 Stove_IStoveTypeBase_Destroy(obj) (C++ 에서는 obj->Destroy()) 를 호출해 반드시 해제해야 해요. 해제하지 않으면 메모리 누수가 발생해요.

c
// 예: Stove_CreateParam 으로 IStoveRestartAppIfNecessaryParam 생성
IStoveRestartAppIfNecessaryParam* restartParam = (IStoveRestartAppIfNecessaryParam*)
    Stove_CreateParam(k_EStoveBaseTypeKind_RestartAppIfNecessaryParam);

Stove_IStoveRestartAppIfNecessaryParam_SetGameId(restartParam, L"my_game_id");
Stove_IStoveRestartAppIfNecessaryParam_SetAppKey(restartParam, L"my_app_key");
// ... 다른 setter 호출 ...

Stove_RestartAppIfNecessary(restartParam, OnRestartAppCallback, NULL);

// API 호출 반환 후 반드시 해제
Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)restartParam);
Creation PathShouldDestroyRelease
Factory(Stove_CreateParam) 로 생성한 파라미터 객체true호출자가 반드시 해제: API 호출이 끝난 뒤 Stove_IStoveTypeBase_Destroy(self) (C++ 에서는 self->Destroy())
동기 API 반환값 IStoveResult*true호출자가 반드시 해제: Stove_IStoveTypeBase_Destroy(result)
out 파라미터로 받은 객체 (IStoveUser**, IStoveGds**, IStoveSignin**)true호출자가 반드시 해제: Stove_IStoveTypeBase_Destroy(*outXxx)
비동기 콜백으로 전달되는 IStoveCallbackResult* 및 동반 객체(IStoveAccessToken*, IStoveStat*, IStoveAchievement*, ...)falseSDK 소유, 콜백 종료 후 SDK 가 자동 해제. 호출자는 Destroy 하지 않음
상위 객체의 Getter 로 반환된 하위 객체 (예: IStoveStat::GetStatsFullId() 의 IStoveStatFullId*)false부모 객체가 소유, 별도 해제 불필요

파라미터로 넘긴 구조체는 반드시 직접 해제해야 해요. Factory 로 생성한 IStoveTypeBase* 파생 객체를 API 호출의 매개변수로 전달한 후에도, 객체의 소유권은 호출자에게 남아 있어요. API 호출 반환 시점(동기 API) 또는 콜백 호출 완료 시점(비동기 API) 이후에 Stove_IStoveTypeBase_Destroy(obj) (C++ 에서는 obj->Destroy()) 를 호출해 해제하세요.

C 호출 예시: Stove_StartPurchase() 에 주문 파라미터 전달 후 해제:

c
// 1) Factory 로 파라미터 객체들 생성
IStoveOrderProductParam* order = (IStoveOrderProductParam*)Stove_CreateParam(k_EStoveIAPTypeKind_OrderProductParam);
Stove_IStoveOrderProductParam_SetProductId(order, 12345);
Stove_IStoveOrderProductParam_SetQuantity(order, 1);

IStovePurchaseParam* option = (IStovePurchaseParam*)Stove_CreateParam(k_EStoveIAPTypeKind_PurchaseParam);
Stove_IStovePurchaseParam_SetOperation(option, k_EStovePurchaseOperation_WithWebViewAndConfirmResult);

IStoveStartPurchaseParam* params = (IStoveStartPurchaseParam*)Stove_CreateParam(k_EStoveIAPTypeKind_StartPurchaseParam);
IStoveOrderProductParam* products[] = { order };
Stove_IStoveStartPurchaseParam_SetProducts(params, products, 1);
Stove_IStoveStartPurchaseParam_SetPurchaseParam(params, option);

// 2) API 호출
//    OnPopupDestroyed 는 결제 웹뷰가 닫힐 때 호출되는 IAP 콜백이에요.
Stove_StartPurchase(params, OnPurchaseFinished, OnPopupDestroyed, NULL, NULL);

// 3) API 호출 반환 이후, 전달한 파라미터 객체들을 모두 Destroy
//    (호출자가 Factory 로 생성했으므로 ShouldDestroy == true)
Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)params);
Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)option);
Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)order);

C++ 호출 예시: 동일 시나리오, C++ 메서드 직접 호출:

cpp
auto* order = static_cast<IStoveOrderProductParam*>(
    Stove_CreateParam(k_EStoveIAPTypeKind_OrderProductParam));
order->SetProductId(12345);
order->SetQuantity(1);

// ... (생략)

Stove_StartPurchase(params, OnPurchaseFinished, OnPopupDestroyed, nullptr, nullptr);

params->Destroy();
option->Destroy();
order->Destroy();

Initialization Order

초기화 파라미터는 두 종류의 객체로 나뉘어 있어요, 런처 재실행 확인용 IStoveRestartAppIfNecessaryParam 과, 실제 초기화용 IStoveInitializeParam 이에요. 각각 따로 생성해 해당 함수에 넘겨요.

  1. Stove_CreateParam(k_EStoveBaseTypeKind_RestartAppIfNecessaryParam) 로 IStoveRestartAppIfNecessaryParam 생성
  2. Stove_IStoveRestartAppIfNecessaryParam_Set*() (또는 C++ 에서 restartParam->SetXxx()) 로 환경/게임 ID/앱 키 등 설정
  3. Stove_RestartAppIfNecessary(restartParam, callback, userData) 호출, 비동기. SDK 가 별도 스레드에서 런처 실행 여부를 확인하며, 결과는 콜백으로 전달돼요.
  4. 게임 메인 루프에서 매 프레임 Stove_RunCallback() 을 호출하기 시작해요. Stove_RestartAppIfNecessary() 의 콜백은 Stove_RunCallback() 이 호출되는 시점에 디스패치되므로, 호출 직후부터 Stove_RunCallback() 루프가 돌아야 콜백을 받을 수 있어요.
  5. 콜백에서 IsRestartRequired() == false 면 아래 순서로 Stove_Initialize() 를 호출해요, (IsRestartRequired() == true 면 SDK 가 런처로 재실행하므로 현재 프로세스를 종료)
    1. Stove_CreateParam(k_EStoveBaseTypeKind_InitializeParam) 로 IStoveInitializeParam 생성
    2. IAP 를 함께 사용하려면 SetShopKey() 와 함께 결제 웹뷰의 부모 윈도우가 될 SetMainWndHandle() 을 설정
    3. Stove_Initialize(initParam) 호출, 동기, IStoveResult* 즉시 반환. 설정된 값에 따라 IAP 모듈도 함께 초기화됨
  6. 반환된 IStoveResult* 결과코드가 0(성공) 이면 사용 가능. 사용 후 Destroy
  7. 게임이 실행되는 동안 Stove_RunCallback() 루프를 계속 유지 (메인 스레드)
  8. 종료 시 Stove_Uninitialize() 호출 (반환 IStoveResult* Destroy 필수)
  9. restartParam, initParam 은 각각 사용이 끝난 뒤(콜백 완료 후 / Stove_Initialize() 반환 후) Stove_IStoveTypeBase_Destroy() 로 해제

Stove_RestartAppIfNecessary() 는 비동기 함수예요. 콜백은 SDK 내부 스레드가 아니라 Stove_RunCallback() 을 호출한 스레드에서 디스패치돼요. 따라서 Stove_RestartAppIfNecessary() 호출 후 게임 루프에서 Stove_RunCallback() 을 돌리지 않으면 콜백이 호출되지 않아 초기화가 진행되지 않아요.

Stove_Initialize(initParam) 은 동기 함수예요. 콜백을 받지 않으며 IStoveResult* 를 즉시 반환해요. 반드시 Stove_RestartAppIfNecessary() 콜백의 IsRestartRequired() == false 분기 안에서 호출하세요. 호출자는 결과코드를 확인한 뒤 Stove_IStoveTypeBase_Destroy(result) 로 해제하세요.

신규 인터페이스는 모듈별 초기화·종료가 없어요. Stove_Initialize() 한 번으로 결제·PC방·로그·소유권·게임지원 등 모든 기능이 함께 동작해요.

Callback Execution Rules

  • 모든 비동기 API 의 콜백은 __cdecl 호출 규약을 사용해요.
  • 콜백은 Stove_RunCallback() 을 호출한 스레드(메인/UI 스레드)에서 실행돼요. SDK 내부 스레드가 아니에요.
  • 콜백 파라미터로 전달된 IStoveCallbackResult* 및 동반 객체 포인터는 콜백 호출 동안에만 유효 해요. Destroy() 하지 않아요.
  • 1회성 콜백(VietnamAgeRating, VietnamOverimmersion 등)은 렌더링이 가능한 시점 이후에 호출되어야 해요.
  • 비동기 API 의 onFinished 콜백은 필수 매개변수예요. 지정하지 않으면 k_EStoveCommonResultCode_InvalidParam(5) 이 발생해요.

userData Parameter Rules

비동기 API 들은 콜백 함수와 함께 void* userData 매개변수를 받아요. 이 값은 SDK 가 해석하지 않고 콜백 호출 시점에 그대로 다시 전달돼요. 게임(개발사) 측에서 콜백 안으로 임의의 컨텍스트 데이터를 운반하기 위한 통로예요.

사용 패턴: 게임 코드의 객체 포인터, 요청 ID, 진행 중인 작업 식별자 등 콜백 안에서 활용할 정보를 전달해요. 콜백 안에서는 IStoveCallbackResult::GetUserData() (C 에서는 Stove_IStoveCallbackResult_GetUserData(callbackResult)) 로 다시 꺼내요.

메모리 수명 :

  • void* 포인터 타입이므로 SDK 는 해당 메모리에 대해 어떤 관리도 수행하지 않아요. 할당·해제·수명·스레드 안전성 모두 개발사에서 개발시 주의를 기울여야 해요.
  • 일회성 콜백(StartPurchase, FetchProducts 등)에서는 콜백이 정확히 1회 호출된 뒤 안전하게 해제할 수 있어요.
  • 반복 호출 콜백(Stove_AccessTokenRenewed, Stove_OverImmersionNotification 등)에서는 SDK 가 종료되거나 등록이 해제될 때까지 userData 가 살아 있어야 해요.
  • userData 가 스택 변수나 임시 객체를 가리키지 않도록 주의하세요. 콜백 시점에는 이미 그 스코프가 종료되어 댕글링 포인터가 되어서 크래시의 원인이 될 수 있어요.
  • 두 개의 콜백(onFinished, onDestroy 등)을 받는 함수는 userData1, userData2 가 독립적으로 동작해요. 각 콜백 수명에 맞춰 별도로 해제하세요.

SDK 는 userData 의 내용·크기·소유권에 대해 어떤 가정도 하지 않아요. NULL 전달도 허용돼요. 사용하지 않으면 NULL 을 전달하세요.

C 예시: 게임 측에서 컨텍스트 구조체를 동적 할당해 전달하고, 콜백에서 사용 후 해제:

c
typedef struct GamePurchaseCtx
{
    int     requestId;
    void*   uiHandle;
} GamePurchaseCtx;

void __cdecl OnPurchaseFinished(const IStoveCallbackResult* result, const IStoveStartPurchaseOutcome* purchase)
{
    GamePurchaseCtx* ctx = (GamePurchaseCtx*)Stove_IStoveCallbackResult_GetUserData(result);
    // ctx->requestId, ctx->uiHandle 사용해 게임 측 후처리

    free(ctx);  // 호출자가 직접 해제 — SDK 는 관여하지 않음
}

// 호출부
GamePurchaseCtx* ctx = (GamePurchaseCtx*)malloc(sizeof(GamePurchaseCtx));
ctx->requestId = 12345;
ctx->uiHandle  = myUiHandle;

Stove_StartPurchase(params, OnPurchaseFinished, OnPopupDestroyed, ctx, NULL);
//                                                                  ^^^  ^^^^
//                                                                  userData1 (onFinished)
//                                                                       userData2 (onDestroy) — 사용 안 함

위 예시에서 ctx 가 OnPurchaseFinished 콜백 호출 전에 해제되면 댕글링 포인터로 인해 크래시가 발생해요. 콜백이 호출되기 전까지 ctx 의 수명을 반드시 유지하세요.

Common Interface

모든 모듈이 공유하는 타입은 각 문서로 링크만 해요. 내용은 각 문서에서 확인하세요.

  • IStoveTypeBase: 모든 SDK 오브젝트의 최상위 인터페이스예요. 런타임 타입 식별과 해제 수명(ShouldDestroy / Destroy)을 담당해요.
  • IStoveResult: 동기 API 호출 결과예요. 메서드 코드와 결과 코드를 담아요.
  • IStoveCallbackResult: 비동기 콜백으로 전달되는 결과예요. 콜백 호출 동안에만 유효해요.
TypeDocument
IStoveTypeBaseIStoveTypeBase
IStoveResultIStoveResult
IStoveCallbackResultIStoveCallbackResult

Notes

  • Stove_RestartAppIfNecessary() 는 반드시 Stove_Initialize() 보다 먼저 호출해야 하며, 그 콜백을 받으려면 호출 직후부터 Stove_RunCallback() 을 게임 루프에서 돌리고 있어야 해요.
  • Stove_Initialize() 는 동기 함수라 콜백을 받지 않지만, Stove_RestartAppIfNecessary() 의 콜백 안(IsRestartRequired() == false 분기)에서 호출해야 해요.
  • userData 는 SDK 가 관리하지 않는 void* 이므로, 스택 변수나 임시 객체를 가리키게 두면 콜백 시점에 댕글링 포인터가 되어서 크래시의 원인이 될 수 있어요.

See Also

DocumentContent
Stove_CreateParam파라미터 객체 통합 팩토리
IStoveRestartAppIfNecessaryOutcomeStove_RestartAppIfNecessary() 콜백으로 전달되는 결과 (IsRestartRequired())

EStoveBaseMethodCode

종류 열거형 · 모듈 Base · 버전 3.5.0

Description

IStoveResult::GetMethodCode() 로 조회하는 값으로, 어떤 SDK 메서드가 이 결과를 생성했는지 식별해요. 로깅과 오류 라우팅에 사용해요.

Declaration

c
typedef enum EStoveBaseMethodCode
{
    k_EStoveBaseMethodCode_Invalid = -1,
    k_EStoveBaseMethodCode_BaseInitialize = 1,
    // ... 이하 열거값 표 참조
    k_EStoveBaseMethodCode_GetTranslateLanguage = 119U,

    k_EStoveBaseMethodCode_Max = 0x7fffffff
} EStoveBaseMethodCode;

Enum Values

Lifecycle / Versioning

CodeNameDescription
-1k_EStoveBaseMethodCode_Invalid사용하지 않아요
1k_EStoveBaseMethodCode_BaseInitializeStove_Initialize
2k_EStoveBaseMethodCode_BaseUninitializeStove_Uninitialize
5k_EStoveBaseMethodCode_BaseGetVersionStove_GetVersion
-6 ~ 63사용하지 않아요 (예약 구간)

Public APIs

CodeNameDescription
64k_EStoveBaseMethodCode_GetAccessTokenStove_GetAccessToken
65k_EStoveBaseMethodCode_AccessTokenRenewedStove_AccessTokenRenewed
66k_EStoveBaseMethodCode_GetUserStove_GetUser
67k_EStoveBaseMethodCode_SetLanguageStove_SetLanguage
68k_EStoveBaseMethodCode_OverImmersionNotificationStove_OverImmersionNotification
69k_EStoveBaseMethodCode_ShutdownNotificationStove_ShutdownNotification
-70, 71사용하지 않아요 (내부 전용으로 폐기된 예약 번호)
72k_EStoveBaseMethodCode_SetGameProfileStove_SetGameProfile
73k_EStoveBaseMethodCode_GetGdsStove_GetGds
74k_EStoveBaseMethodCode_GetSigninStove_GetSignin
75k_EStoveBaseMethodCode_RestartAppIfNecessaryStove_RestartAppIfNecessary
76k_EStoveBaseMethodCode_RestartAppIfNecessaryAsyncStove_RestartAppIfNecessary 의 비동기 처리 경로
77k_EStoveBaseMethodCode_OpenExternalUrlStove_OpenExternalUrl
78k_EStoveBaseMethodCode_GetCloudSavingPathStove_GetCloudSavingPath: 스토어인디 전용
79k_EStoveBaseMethodCode_VietnamAgeRatingNotificationStove_VietnamAgeRatingNotification
80k_EStoveBaseMethodCode_VietnamOverimmersionNotificationStove_VietnamOverimmersionNotification
81k_EStoveBaseMethodCode_CloseAllPopupsStove_CloseAllPopups(단일 바이너리 통합, IAP+View 팝업을 함께 닫아요)
-82 ~ 95사용하지 않아요 (예약 구간)

Private getters (다른 SDK 모듈에 노출되는 비공개 게터, 게임에는 노출되지 않음)

CodeNameDescription
115k_EStoveBaseMethodCode_GetEnvPrivate비공개 게터, 다른 SDK 모듈 전용, 게임에는 노출되지 않아요
116k_EStoveBaseMethodCode_GetGameIdPrivate비공개 게터, 다른 SDK 모듈 전용, 게임에는 노출되지 않아요
117k_EStoveBaseMethodCode_GetMemberNoPrivate비공개 게터, 다른 SDK 모듈 전용, 게임에는 노출되지 않아요
118k_EStoveBaseMethodCode_GetPublicIp비공개 게터, 다른 SDK 모듈 전용, 게임에는 노출되지 않아요
119k_EStoveBaseMethodCode_GetTranslateLanguage비공개 게터, 다른 SDK 모듈 전용, 게임에는 노출되지 않아요

기타

CodeNameDescription
-120 ~ 0x7ffffffe사용하지 않아요 (예약 구간)
0x7fffffffk_EStoveBaseMethodCode_Max사용하지 않아요

이름에 Internal 이 들어간 값(3, 4, 96 ~ 108, 110 ~ 114)은 SDK 내부 전용이며 표에서 제외했어요. 109 는 소스에 이름 없이 "Deprecated" 주석만 있는 예약 번호예요.

Example

c
IStoveResult* result = Stove_Initialize(initParam);

if (Stove_IStoveResult_GetMethodCode(result) == k_EStoveBaseMethodCode_BaseInitialize)
{
    // 이 결과가 Stove_Initialize() 호출로 생성되었음을 확인하는 로직을 구현해 주세요.
}

Notes

  • 96번대 이후의 Internal 메서드 코드는 재생시간 보고, 서버 설정, 토큰 처리 등 SDK 내부 동작에 사용되며 게임에서 직접 호출하는 API 와 대응하지 않아요.
  • 115~119번의 Private 게터는 이름에 Internal 이 없어 표에 포함했지만, 다른 SDK 모듈에만 노출되는 비공개 API 이며 게임에는 제공되지 않아요.
  • 3, 4 번(InternalSend81Plug, InternalUpdate81Plug)도 이름에 Internal 이 들어가 있어 표에서 제외했어요.
  • 옛 인터페이스에서는 값 이름에 밑줄이 없었어요(예: k_EStoveBaseMethodCodeInvalid). 현재 인터페이스는 k_EStoveBaseMethodCode_Invalid 처럼 타입명과 값명 사이에 밑줄이 들어가요.

Changelog

VersionChange
3.5.0최초 제공

See Also


EStoveBaseTypeKind

종류 열거형 · 모듈 Base · 버전 3.5.0

Description

IStoveTypeBase 인스턴스의 구체적인 타입을 식별하는 값이에요. Stove_CreateParam() 에 특정 파라미터 객체를 요청할 때, 그리고 IStoveTypeBase::GetTypeKind() 로 런타임 타입을 식별할 때 사용해요.

값 범위는 0 ~ 999 예요. SDK 가 반환/전달하는 결과·데이터 타입과, 호출자가 Stove_CreateParam() 으로 생성하는 파라미터 타입으로 나뉘어요. 이 범위는 다른 SDK 모듈의 TypeKind 열거형과 겹치지 않도록 설계되어 있어, Stove_CreateParam() 하나로 모든 모듈의 파라미터를 생성할 수 있어요.

Declaration

c
typedef enum EStoveBaseTypeKind
{
    k_EStoveBaseTypeKind_Invalid = -1,
    k_EStoveBaseTypeKind_Base = 0,
    // ... 이하 열거값 표 참조
    k_EStoveBaseTypeKind_SetGameProfileParam = 502,
    k_EStoveBaseTypeKind_Max = 0x7fffffff,
} EStoveBaseTypeKind;

Enum Values

Result / Data types (SDK 가 반환하거나 콜백으로 전달)

CodeNameDescription
-1k_EStoveBaseTypeKind_Invalid사용하지 않아요
0k_EStoveBaseTypeKind_BaseIStoveTypeBase
1k_EStoveBaseTypeKind_StoveResultIStoveResult
2k_EStoveBaseTypeKind_StoveCallbackResultIStoveCallbackResult
3k_EStoveBaseTypeKind_StoveUserIStoveUser
4k_EStoveBaseTypeKind_StoveAccessTokenIStoveAccessToken
5k_EStoveBaseTypeKind_StoveGdsIStoveGds
6k_EStoveBaseTypeKind_StoveSigninIStoveSignin
7k_EStoveBaseTypeKind_StoveOverImmersionInfoIStoveOverImmersionInfo
8k_EStoveBaseTypeKind_StoveVietnamAgeRatingInfoIStoveVietnamAgeRatingInfo
9k_EStoveBaseTypeKind_StoveVietnamOverimmersionInfoIStoveVietnamOverimmersionInfo
10k_EStoveBaseTypeKind_StoveShutdownInfoIStoveShutdownInfo
11k_EStoveBaseTypeKind_StoveRestartAppIfNecessaryOutcomeIStoveRestartAppIfNecessaryOutcome
-12 ~ 499사용하지 않아요 (결과/데이터 타입과 파라미터 타입 구간 사이의 예약 구간)

Parameter types (호출자가 Stove_CreateParam() 으로 생성)

CodeNameDescription
500k_EStoveBaseTypeKind_RestartAppIfNecessaryParamIStoveRestartAppIfNecessaryParam
501k_EStoveBaseTypeKind_InitializeParamIStoveInitializeParam
502k_EStoveBaseTypeKind_SetGameProfileParamIStoveSetGameProfileParam
-503 ~ 0x7ffffffe사용하지 않아요 (예약 구간)
0x7fffffffk_EStoveBaseTypeKind_Max사용하지 않아요

Example

c
IStoveSetGameProfileParam* profileParam =
    (IStoveSetGameProfileParam*)Stove_CreateParam(k_EStoveBaseTypeKind_SetGameProfileParam);

Notes

  • 파라미터 타입(500번대)은 Stove_CreateParam() 인자로 사용돼요. 결과/데이터 타입(0~11번)은 SDK 가 반환하거나 콜백으로 전달하므로 직접 생성하지 않아요.
  • 옛 인터페이스에서는 값 이름에 밑줄이 없었어요(예: k_EStoveBaseTypeKindInvalid). 현재 인터페이스는 k_EStoveBaseTypeKind_Invalid 처럼 타입명과 값명 사이에 밑줄이 들어가요.
  • 옛 인터페이스에는 IStoveInitializeParam 이 Environment/GameId/AppKey 를 포함한 더 큰 구조체였으나, 현재는 그 필드들이 500번(RestartAppIfNecessaryParam)으로 분리되었고 501번(InitializeParam)은 ShopKey/MainWndHandle 만 담아요.

Changelog

VersionChange
3.5.0최초 제공

See Also


EStoveCommonResultCode

종류 결과코드 · 모듈 Base · 버전 3.5.0

Description

모든 Stove SDK 모듈이 공통으로 사용하는 결과 코드예요. IStoveResult::GetResultCode() 로 조회하며, 0(Success)이면 성공이에요.

모듈별 전용 결과 코드(300~)는 EStoveResultCode 를 참조하세요.

Declaration

c
typedef enum EStoveCommonResultCode
{
    k_EStoveCommonResultCode_Success = 0,
    k_EStoveCommonResultCode_Fail = 1,
    // ... 이하 열거값 표 참조
    k_EStoveCommonResultCode_UnknownError = 255,

    k_EStoveCommonResultCode_Max = 0x7fffffff
} EStoveCommonResultCode;

Enum Values

일반 결과

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
1k_EStoveCommonResultCode_Fail일반 실패x

설정/파라미터 검증 실패

CodeNameDescriptionShow to UserIn-Game Message
2k_EStoveCommonResultCode_InvalidConfig설정값이 유효하지 않아요x
3k_EStoveCommonResultCode_InvalidLogLevel로그 레벨 값이 유효하지 않아요x
4k_EStoveCommonResultCode_InvalidLogPath로그 경로가 유효하지 않아요x
5k_EStoveCommonResultCode_InvalidParam파라미터가 유효하지 않아요x
-6 ~ 15사용하지 않아요 (예약 구간)--

초기화 상태 오류

CodeNameDescriptionShow to UserIn-Game Message
16k_EStoveCommonResultCode_BaseNotInitializedSDK 가 초기화되지 않았어요x
17k_EStoveCommonResultCode_NotInitialized해당 모듈이 초기화되지 않았어요x
18k_EStoveCommonResultCode_AlreadyInitialized이미 초기화되어 있어요x

토큰/엔티티 오류

CodeNameDescriptionShow to UserIn-Game Message
19k_EStoveCommonResultCode_InvalidAccessTokenAccessToken 이 유효하지 않아요O로그인 세션이 만료되었습니다. 게임 종료 후 다시 실행해 주세요. [확인]
20k_EStoveCommonResultCode_NullTokenEntity토큰 엔티티가 null 이에요x
21k_EStoveCommonResultCode_NullEntity엔티티가 null 이에요x

아래 코드를 받으면 반드시 게임을 종료해야 해요. 정상 진행이 불가능한 상태예요.

  • 19 k_EStoveCommonResultCode_InvalidAccessToken: 로그인 세션이 만료되어 재실행이 필요해요

HTTP/응답 오류

CodeNameDescriptionShow to UserIn-Game Message
22k_EStoveCommonResultCode_HttpErrorHTTP 오류가 발생했어요O네트워크 연결이 원활하지 않습니다. 네트워크 상태를 확인하고 다시 실행해 주세요. [확인]
23k_EStoveCommonResultCode_ResponseError서버 응답 오류예요O네트워크 연결이 원활하지 않습니다. 네트워크 상태를 확인하고 다시 실행해 주세요. [확인]
24k_EStoveCommonResultCode_ResponseInvalidCode서버 응답 코드가 유효하지 않아요O네트워크 연결이 원활하지 않습니다. 네트워크 상태를 확인하고 다시 실행해 주세요. [확인]
25k_EStoveCommonResultCode_ResponseValueIsNull서버 응답 값이 null 이에요O네트워크 연결이 원활하지 않습니다. 네트워크 상태를 확인하고 다시 실행해 주세요. [확인]
26k_EStoveCommonResultCode_ResponseInvalidValueFormat서버 응답 값의 형식이 유효하지 않아요O네트워크 연결이 원활하지 않습니다. 네트워크 상태를 확인하고 다시 실행해 주세요. [확인]

기타 상태

CodeNameDescriptionShow to UserIn-Game Message
-27, 28사용하지 않아요 (폐기된 번호)--
29k_EStoveCommonResultCode_AsyncOperationInProgress비동기 작업이 이미 진행 중이에요x
30k_EStoveCommonResultCode_BaseUninitializedSDK 가 이미 해제(Stove_Uninitialize)되었어요x
31k_EStoveCommonResultCode_NotSupportedCountry지원하지 않는 국가/지역이에요x
33k_EStoveCommonResultCode_PopupNotCreated팝업이 생성되지 않고 작업이 종료되었어요. 내부 정리 전용 코드이며 게임 콜백으로 전달되지 않아요(모든 인터페이스가 가로채요)x
34k_EStoveCommonResultCode_WebviewClosedBeforeComplete작업이 끝나기 전에 웹뷰가 닫혔어요O구매가 정상적으로 완료되지 않았습니다. 다시 시도해 주세요. [확인]

Local DB 실패 (모든 모듈 공용)

CodeNameDescriptionShow to UserIn-Game Message
40k_EStoveCommonResultCode_LocalDbCreateWorkingDirectoryFailed로컬 DB 작업 디렉터리 생성에 실패했어요x
41k_EStoveCommonResultCode_LocalDbConnectFailed로컬 DB 연결에 실패했어요x
42k_EStoveCommonResultCode_LocalDbCreateTableFailed로컬 DB 테이블 생성에 실패했어요x
43k_EStoveCommonResultCode_LocalDbDisconnectFailed로컬 DB 연결 해제에 실패했어요x
44k_EStoveCommonResultCode_LocalDbWriteFailed로컬 DB 쓰기에 실패했어요x
-45 ~ 59사용하지 않아요 (향후 Local DB/페이로드/스토리지 코드를 위한 예약 구간)--

웹뷰/팝업 UI 실패 (모듈 공용)

CodeNameDescriptionShow to UserIn-Game Message
60k_EStoveCommonResultCode_ViewUiNotInitialized팝업/웹뷰 UI 서브시스템이 초기화되지 않았어요x
61k_EStoveCommonResultCode_ViewUiUninitFailed팝업/웹뷰 UI 서브시스템 종료에 실패했어요x
62k_EStoveCommonResultCode_WebviewCreateFail웹뷰 생성에 실패했어요x
63k_EStoveCommonResultCode_WebviewLoadUrlFail웹뷰에서 URL 로드에 실패했어요x
64k_EStoveCommonResultCode_WebviewCreateCookieFail웹뷰 쿠키 설정에 실패했어요O페이지를 불러올 수 없습니다. 다시 시도해 주세요. [확인]
65k_EStoveCommonResultCode_WebviewCloseAllFail모든 웹뷰/팝업 닫기에 실패했어요x
66k_EStoveCommonResultCode_WebviewCloseFail웹뷰/팝업 닫기에 실패했어요x
67k_EStoveCommonResultCode_NoPopupData표시할 팝업 데이터가 없어요O팝업 설정 정보가 존재하지 않아 표시할 창이 없습니다. [확인]
68k_EStoveCommonResultCode_CloseAllPopupsFailedStove_CloseAllPopups 호출에서 하나 이상의 팝업을 닫지 못했어요(IAP+View 통합 호출)x
-69 ~ 79사용하지 않아요 (향후 웹뷰/팝업 UI 코드를 위한 예약 구간)--

파라미터/페이로드 검증 (모듈 공용)

CodeNameDescriptionShow to UserIn-Game Message
80k_EStoveCommonResultCode_ParameterLengthExceeded요청 파라미터가 최대 길이를 초과했어요O결제 정보가 유효하지 않아 결제를 진행할 수 없습니다. 다시 시도해 주세요. [확인]
81k_EStoveCommonResultCode_InvalidJsonStringJSON 문자열 형식이 유효하지 않아요O결제 정보가 유효하지 않아 결제를 진행할 수 없습니다. 다시 시도해 주세요. [확인]
82k_EStoveCommonResultCode_PayloadSizeExceeded페이로드가 허용된 최대 크기를 초과했어요x
-83 ~ 248사용하지 않아요 (예약 구간)--

네트워크 전송 실패

CodeNameDescriptionShow to UserIn-Game Message
249k_EStoveCommonResultCode_NetworkTransportError네트워크 전송 오류예요. IStoveCallbackResult::GetExternalError() 로 HTTP 백엔드의 네이티브 오류 코드가 전달돼요(예: WinHTTP 12002/12007/12029)x
-250사용하지 않아요 (예약 구간)--

시스템/런타임 실패

CodeNameDescriptionShow to UserIn-Game Message
251k_EStoveCommonResultCode_PcsdkDllNotFoundPCSDK DLL 을 찾을 수 없어요x
252k_EStoveCommonResultCode_NotImplemented구현되지 않은 기능이에요x
253k_EStoveCommonResultCode_UnmanagedException관리되지 않는(unmanaged) 예외가 발생했어요O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException관리되는(managed) 예외가 발생했어요O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
255k_EStoveCommonResultCode_UnknownError알 수 없는 오류예요x
-256 ~ 0x7ffffffe사용하지 않아요 (예약 구간)--
0x7fffffffk_EStoveCommonResultCode_Max사용하지 않아요--

Example

c
IStoveResult* result = Stove_Uninitialize();

if (Stove_IStoveResult_GetResultCode(result) == k_EStoveCommonResultCode_Success)
{
    // 성공 시 로직을 구현해 주세요.
}
else
{
    // 실패 시 로직을 구현해 주세요.
}

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result);

Notes

  • 모든 API 및 다른 SDK 모듈이 공통으로 사용하는 결과 코드예요.
  • 모듈별 전용 코드는 EStoveResultCode(300~)로 정의되며, 번호가 이 열거형과 겹치지 않도록 구간을 나눠 사용해요. 옛 인터페이스의 모듈별 EStoveBaseResultCode, EStoveIAPResultCode 등은 더 이상 존재하지 않아요.
  • 옛 인터페이스에서는 값 이름에 밑줄이 없었어요(예: k_EStoveCommonResultCodeSuccess). 현재 인터페이스는 k_EStoveCommonResultCode_Success 처럼 타입명과 값명 사이에 밑줄이 들어가요.

Changelog

VersionChange
3.5.0최초 제공 (단일 바이너리 통합으로 모듈별 중복 코드를 이 열거형으로 통합)

See Also


EStoveDiscountType

종류 열거형 · 모듈 IAP · 버전 3.5.0

Description

IStoveProduct 의 DiscountType 으로 반환되며, DiscountTypeValue 를 어떻게 해석할지를 결정해요.

Declaration

c
typedef enum EStoveDiscountType
{
    k_EStoveDiscountType_None = 0,
    k_EStoveDiscountType_FixedRate = 1,
    k_EStoveDiscountType_FlatRate = 2,
    k_EStoveDiscountType_Max = 0x7fffffff
} EStoveDiscountType;

Enum Values

CodeNameDescription
0k_EStoveDiscountType_None할인 없음
1k_EStoveDiscountType_FixedRate비율 할인(예: 10% 할인): DiscountTypeValue 는 퍼센트 값이에요.
2k_EStoveDiscountType_FlatRate정액 할인(예: $2 할인): DiscountTypeValue 는 상품 통화 기준 할인액이에요.
0x7fffffffk_EStoveDiscountType_Max사용하지 않아요

Example

c
int32_t discountType = Stove_IStoveProduct_GetDiscountType(product);
int32_t discountValue = Stove_IStoveProduct_GetDiscountTypeValue(product);

if (discountType == k_EStoveDiscountType_FixedRate)
{
    // discountValue 를 퍼센트로 해석해 주세요.
}
else if (discountType == k_EStoveDiscountType_FlatRate)
{
    // discountValue 를 상품 통화 기준 정액으로 해석해 주세요.
}

Notes

See Also


EStoveGameSupportMethodCode

종류 열거형 · 모듈 GameSupport · 버전 3.5.0

Description

EStoveGameSupportMethodCode 는 IStoveResult 를 만든 통계·업적 API 가 무엇인지 식별하는 값이에요. IStoveResult::GetMethodCode()(Stove_IStoveResult_GetMethodCode()) 로 조회할 수 있으며, 로그 기록이나 오류 처리 분기에 사용해요.

이 열거형의 값 범위는 5000 ~ 5999 (모듈 블록) 이며, 공개 API 순서대로 연속해서 번호가 붙어 있어요.

Declaration

c
typedef enum EStoveGameSupportMethodCode
{
    k_EStoveGameSupportMethodCode_Invalid = -1,
    k_EStoveGameSupportMethodCode_FetchStat = 5000,
    // ... 이하 열거값 표 참조
    k_EStoveGameSupportMethodCode_FetchRanking = 5004,
    k_EStoveGameSupportMethodCode_Max = 0x7fffffff
} EStoveGameSupportMethodCode;

Enum Values

CodeNameDescription
-1k_EStoveGameSupportMethodCode_Invalid사용하지 않아요
5000k_EStoveGameSupportMethodCode_FetchStatStove_FetchStat
5001k_EStoveGameSupportMethodCode_SetStatStove_SetStat
5002k_EStoveGameSupportMethodCode_FetchAchievementStove_FetchAchievement
5003k_EStoveGameSupportMethodCode_FetchAchievementsStove_FetchAchievements
5004k_EStoveGameSupportMethodCode_FetchRankingStove_FetchRanking
0x7fffffffk_EStoveGameSupportMethodCode_Max사용하지 않아요

Example

c
void OnGetStatFinished(const IStoveCallbackResult* callbackResult, const IStoveStat* stat)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);
    uint32_t methodCode = Stove_IStoveResult_GetMethodCode(result); // k_EStoveGameSupportMethodCode_FetchStat
}

Notes

  • 값 범위(5000~5999)는 다른 모듈의 MethodCode 값과 겹치지 않아요.

Changelog

VersionChange
3.5.0최초 제공

See Also


EStoveGameSupportTypeKind

종류 열거형 · 모듈 GameSupport · 버전 3.5.0

Description

EStoveGameSupportTypeKind 는 통계·업적 기능이 다루는 IStoveTypeBase 계열 객체의 구체적인 타입을 식별하는 값이에요. Stove_CreateParam() 으로 특정 파라미터 객체를 요청할 때 넘기는 값이며, IStoveTypeBase::GetTypeKind()(Stove_IStoveTypeBase_GetTypeKind()) 로 런타임에 객체의 실제 타입을 확인할 때도 이 값을 써요.

이 열거형의 값 범위는 5000 ~ 5999 예요. SDK 가 반환·전달하는 결과/데이터 타입은 5000대, 호출자가 Stove_CreateParam() 으로 생성하는 파라미터 타입은 5500대로 나뉘며, 값이 연속하지 않아요. 값 범위가 다른 모듈의 TypeKind 열거형과 겹치지 않으므로 Stove_CreateParam() 하나로 모든 모듈의 파라미터를 생성할 수 있어요.

Declaration

c
typedef enum EStoveGameSupportTypeKind
{
    k_EStoveGameSupportTypeKind_Invalid = -1,
    k_EStoveGameSupportTypeKind_StatFullId = 5000,
    // ... 이하 열거값 표 참조
    k_EStoveGameSupportTypeKind_FetchRankingParam = 5504,
    k_EStoveGameSupportTypeKind_Max = 0x7fffffff
} EStoveGameSupportTypeKind;

Enum Values

Result / Data types (SDK 가 반환하거나 콜백으로 전달)

CodeNameDescription
-1k_EStoveGameSupportTypeKind_Invalid사용하지 않아요
5000k_EStoveGameSupportTypeKind_StatFullIdIStoveStatFullId
5001k_EStoveGameSupportTypeKind_StatIStoveStat
5002k_EStoveGameSupportTypeKind_SetStatOutcomeIStoveSetStatOutcome
5003k_EStoveGameSupportTypeKind_AchievementConditionIStoveAchievementCondition
5004k_EStoveGameSupportTypeKind_AchievementIStoveAchievement
5005k_EStoveGameSupportTypeKind_RankIStoveRank
5006k_EStoveGameSupportTypeKind_AchievementListIStoveAchievementList
5007k_EStoveGameSupportTypeKind_RankingIStoveRanking
-5008 ~ 5499사용하지 않아요 (결과/데이터 타입과 파라미터 타입 구간 사이의 예약 구간)

Parameter types (호출자가 Stove_CreateParam() 으로 생성)

CodeNameDescription
5500k_EStoveGameSupportTypeKind_FetchStatParamIStoveFetchStatParam
5501k_EStoveGameSupportTypeKind_SetStatParamIStoveSetStatParam
5502k_EStoveGameSupportTypeKind_FetchAchievementParamIStoveFetchAchievementParam
5503k_EStoveGameSupportTypeKind_FetchAchievementsParamIStoveFetchAchievementsParam
5504k_EStoveGameSupportTypeKind_FetchRankingParamIStoveFetchRankingParam
-5505 ~ 0x7ffffffe사용하지 않아요 (예약 구간)
0x7fffffffk_EStoveGameSupportTypeKind_Max사용하지 않아요

Example

c
IStoveFetchStatParam* param =
    (IStoveFetchStatParam*)Stove_CreateParam(k_EStoveGameSupportTypeKind_FetchStatParam);

Notes

  • 데이터/결과 타입(5000대)은 SDK 가 콜백으로 돌려주는 타입이며, Stove_CreateParam() 으로 만들 수 없어요.
  • 파라미터 타입(5500대)은 호출자가 Stove_CreateParam() 으로 생성해야 하는 타입이에요.

Changelog

VersionChange
3.5.0최초 제공

See Also


EStoveIAPMethodCode

종류 열거형 · 모듈 IAP · 버전 3.5.0

Description

IStoveResult::GetMethodCode() 로 조회하며, 어느 결제 API 호출이 이 결과를 만들었는지 식별해요. 로그 기록이나 오류 처리를 API 별로 분기할 때 사용해요.

값의 범위는 2000~2999 로, 결제 기능의 공개 API 순서대로 순차 배정되어 있어요.

Declaration

c
typedef enum EStoveIAPMethodCode
{
    k_EStoveIAPMethodCode_Invalid = -1,
    k_EStoveIAPMethodCode_FetchShopCategories = 2000,
    // ... 이하 열거값 표 참조
    k_EStoveIAPMethodCode_Max = 0x7fffffff
} EStoveIAPMethodCode;

Enum Values

CodeNameDescription
-1k_EStoveIAPMethodCode_Invalid사용하지 않아요
2000k_EStoveIAPMethodCode_FetchShopCategoriesStove_FetchShopCategories
2001k_EStoveIAPMethodCode_FetchProductsStove_FetchProducts
2002k_EStoveIAPMethodCode_StartPurchaseStove_StartPurchase
2003k_EStoveIAPMethodCode_ConfirmPurchaseStove_ConfirmPurchase
2004k_EStoveIAPMethodCode_FetchInventoryStove_FetchInventory
2005k_EStoveIAPMethodCode_FetchTermsAgreementStove_FetchTermsAgreement
2006k_EStoveIAPMethodCode_WithdrawGameStove_WithdrawGame: 로스트아크모바일 전용
0x7fffffffk_EStoveIAPMethodCode_Max사용하지 않아요

Example

c
IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);
uint32_t methodCode = Stove_IStoveResult_GetMethodCode(result);

if (methodCode == k_EStoveIAPMethodCode_StartPurchase)
{
    // Stove_StartPurchase() 호출에서 발생한 결과예요.
}

Notes

  • 값의 범위(2000 ~ 2006)가 EStoveIAPTypeKind 의 데이터 타입 값 범위(2000 ~ 2005)와 숫자가 겹치는 것처럼 보이지만, 서로 다른 열거형이므로 혼동하지 않도록 주의해요.
  • 이전 인터페이스에 있던 모듈별 EStoveIAPResultCode 는 삭제되었어요. 실패 원인은 이 메서드 코드와 함께 EStoveResultCode 또는 EStoveCommonResultCode 의 GetResultCode() 값으로 확인해요.

See Also


EStoveIAPTypeKind

종류 열거형 · 모듈 IAP · 버전 3.5.0

Description

Stove_CreateParam() 에 전달해 원하는 결제 파라미터 객체를 생성할 때 사용하며, IStoveTypeBase::GetTypeKind() 로 객체의 실제 타입을 런타임에 확인할 때도 사용해요.

값의 범위는 2000~2999 예요. 이 중 2000번대는 SDK 가 콜백으로 전달하는 결과/데이터 타입이고, 2500번대는 호출자가 Stove_CreateParam() 으로 생성하는 파라미터 타입이에요.

Declaration

c
typedef enum EStoveIAPTypeKind
{
    k_EStoveIAPTypeKind_Invalid = -1,
    k_EStoveIAPTypeKind_ShopCategory = 2000,
    // ... 이하 열거값 표 참조
    k_EStoveIAPTypeKind_Max = 0x7fffffff
} EStoveIAPTypeKind;

Enum Values

CodeNameDescription
-1k_EStoveIAPTypeKind_Invalid사용하지 않아요
2000k_EStoveIAPTypeKind_ShopCategoryIStoveShopCategory: 상점 카테고리 항목
2001k_EStoveIAPTypeKind_ProductIStoveProduct: 상품 항목
2002k_EStoveIAPTypeKind_StartPurchaseOutcomeIStoveStartPurchaseOutcome: 구매 시작 결과 (옛 이름: PurchaseResult)
2003k_EStoveIAPTypeKind_PurchasedProductIStovePurchasedProduct: 구매 확정된 상품 항목
2004k_EStoveIAPTypeKind_ChargeInfoIStoveChargeInfo: 결제 화폐(차지) 정보
2005k_EStoveIAPTypeKind_InventoryItemIStoveInventoryItem: 인벤토리(구매 내역) 항목
-2006사용하지 않아요 (예약 번호)
-2007사용하지 않아요 (예약 번호)
2008k_EStoveIAPTypeKind_ConfirmPurchaseOutcomeIStoveConfirmPurchaseOutcome: 구매 확정 결과
2009k_EStoveIAPTypeKind_WithdrawGameOutcomeIStoveWithdrawGameOutcome: 게임 탈퇴 결과 (로스트아크모바일 전용)
2010k_EStoveIAPTypeKind_TermsAgreementOutcomeIStoveTermsAgreementOutcome: 약관 동의 조회 결과
2011k_EStoveIAPTypeKind_ShopCategoryListIStoveShopCategoryList: 상점 카테고리 목록 컨테이너
2012k_EStoveIAPTypeKind_ProductListIStoveProductList: 상품 목록 컨테이너
2013k_EStoveIAPTypeKind_InventoryListIStoveInventoryList: 인벤토리(구매 내역) 목록 컨테이너
2500k_EStoveIAPTypeKind_FetchProductsParamIStoveFetchProductsParam: 상품 조회 파라미터
2501k_EStoveIAPTypeKind_OrderProductParamIStoveOrderProductParam: 주문 상품 파라미터
2502k_EStoveIAPTypeKind_PurchaseParamIStovePurchaseParam: 구매 동작 파라미터
2503k_EStoveIAPTypeKind_StartPurchaseParamIStoveStartPurchaseParam: 구매 시작 파라미터
2504k_EStoveIAPTypeKind_FetchTermsAgreementParamIStoveFetchTermsAgreementParam: 약관 동의 조회 파라미터
-2505사용하지 않아요 (예약 번호)
2506k_EStoveIAPTypeKind_WithdrawGameParamIStoveWithdrawGameParam: 게임 탈퇴 파라미터 (로스트아크모바일 전용)
2507k_EStoveIAPTypeKind_ConfirmPurchaseParamIStoveConfirmPurchaseParam: 구매 확정 파라미터
-2508사용하지 않아요 (예약 번호)
0x7fffffffk_EStoveIAPTypeKind_Max사용하지 않아요

IStoveWebViewLayoutParam 은 IStovePurchaseParam · IStoveFetchTermsAgreementParam · IStoveWithdrawGameParam 이 공유하는 추상 베이스 타입으로, 이 열거형에 대응하는 값이 없어요. Stove_CreateParam() 으로 단독 생성할 수 없어요.

내부 전용 값은 표에서 제외했어요.

Example

c
IStoveFetchProductsParam* param = (IStoveFetchProductsParam*)Stove_CreateParam(k_EStoveIAPTypeKind_FetchProductsParam);

Notes

  • Base, IAP 등 모듈별 TypeKind 열거형은 서로 겹치지 않는 정수 범위를 사용하므로, Stove_CreateParam() 하나로 모든 모듈의 파라미터를 생성할 수 있어요.
  • 2000번대(결과/데이터 타입)는 호출자가 직접 생성하지 않으며, 콜백으로 전달되는 객체의 GetTypeKind() 값으로만 나타나요.
  • k_EStoveIAPTypeKind_StartPurchaseOutcome 은 옛 이름 PurchaseResult 에서 이름이 바뀐 것이에요. 과거 연동을 옮기는 경우 참고해 주세요.

See Also


EStoveLogMethodCode

종류 열거형 · 모듈 Log · 버전 3.5.0

Description

IStoveResult::GetMethodCode() 로 조회하며, 로깅과 오류 라우팅에 사용해요.

모듈 블록 6000~6999 를 순차적으로 사용해요.

Declaration

c
typedef enum EStoveLogMethodCode
{
    k_EStoveLogMethodCode_Invalid = -1,

    k_EStoveLogMethodCode_SendLog = 6000,

    k_EStoveLogMethodCode_Max = 0x7fffffff
} EStoveLogMethodCode;

Enum Values

CodeNameDescription
-1k_EStoveLogMethodCode_Invalid사용하지 않아요
6000k_EStoveLogMethodCode_SendLogStove_SendLog 가 만든 결과예요.
0x7fffffffk_EStoveLogMethodCode_Max사용하지 않아요

Example

c
IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

if (Stove_IStoveResult_GetMethodCode(result) == k_EStoveLogMethodCode_SendLog)
{
    // Stove_SendLog() 호출에 대한 결과예요.
}

Notes

  • 로그 기능은 Stove_SendLog() 하나만 공개 API 로 제공해요. 초기화·종료는 SDK 가 대신해요.
  • 모듈별 EStoveLogResultCode 는 삭제되었어요. 결과 코드는 EStoveResultCode, EStoveCommonResultCode 로 통합되었어요.

See Also


EStoveLogTypeKind

종류 열거형 · 모듈 Log · 버전 3.5.0

Description

Stove_CreateParam() 이 특정 파라미터 객체를 생성할 때, 그리고 IStoveTypeBase::GetTypeKind() 로 런타임 타입을 확인할 때 쓰예요. 정수 범위는 6000 ~ 6999 예요.

Declaration

c
typedef enum EStoveLogTypeKind
{
    k_EStoveLogTypeKind_Invalid = -1,

    k_EStoveLogTypeKind_SendLogParam = 6500,

    k_EStoveLogTypeKind_Max = 0x7fffffff
} EStoveLogTypeKind;

Enum Values

CodeNameDescription
-1k_EStoveLogTypeKind_Invalid사용하지 않아요
6500k_EStoveLogTypeKind_SendLogParam호출자가 Stove_CreateParam() 으로 생성하는 파라미터 타입이에요. IStoveSendLogParam 에 대응해요.
0x7fffffffk_EStoveLogTypeKind_Max사용하지 않아요

Example

c
IStoveSendLogParam* logParam = (IStoveSendLogParam*)Stove_CreateParam(k_EStoveLogTypeKind_SendLogParam);

Notes

  • 로그 기능의 TypeKind 범위(6000 ~ 6999)는 다른 모듈의 TypeKind 범위와 겹치지 않아요.
  • 현재 로그 기능이 정의하는 파라미터 타입은 k_EStoveLogTypeKind_SendLogParam 하나뿐이에요.

See Also


EStoveOverlayMode

종류 열거형 · 모듈 Base · 버전 3.5.0

Description

베트남 연령등급 고지, 과몰입 방지 고지 등 규제/알림 오버레이의 표시 상태를 나타내는 값이에요.

IStoveVietnamAgeRatingInfo::GetOverlayMode(), IStoveVietnamOverimmersionInfo::GetOverlayMode() 로 조회해요.

Declaration

c
typedef enum EStoveOverlayMode
{
    k_EStoveOverlayMode_Invalid = -1,

    k_EStoveOverlayMode_Show = 0,
    k_EStoveOverlayMode_Hide = 1,
    k_EStoveOverlayMode_Expanded = 2,

    k_EStoveOverlayMode_Max = 0x7fffffff
} EStoveOverlayMode;

Enum Values

CodeNameDescription
-1k_EStoveOverlayMode_Invalid사용하지 않아요
0k_EStoveOverlayMode_Show오버레이를 표시해요
1k_EStoveOverlayMode_Hide오버레이를 숨겨요
2k_EStoveOverlayMode_Expanded오버레이를 확장된 형태로 표시해요
0x7fffffffk_EStoveOverlayMode_Max사용하지 않아요

Example

c
void __cdecl OnVietnamAgeRatingNotificationCallback(const IStoveCallbackResult* callbackResult, const IStoveVietnamAgeRatingInfo* ageRatingInfo)
{
    int32_t overlayMode = Stove_IStoveVietnamAgeRatingInfo_GetOverlayMode(ageRatingInfo);
    if (overlayMode == k_EStoveOverlayMode_Show)
    {
        // 오버레이를 표시하는 로직을 구현해 주세요.
    }
}

Notes

  • k_EStoveOverlayMode_Expanded 는 베트남 과몰입 방지 고지(IStoveVietnamOverimmersionInfo)에서만 사용되는 값이에요. 연령등급 고지(IStoveVietnamAgeRatingInfo)에는 Show/Hide 만 전달돼요.
  • 옛 인터페이스에서는 값 이름에 밑줄이 없었어요(예: k_EStoveOverlayModeInvalid). 현재 인터페이스는 k_EStoveOverlayMode_Invalid 처럼 타입명과 값명 사이에 밑줄이 들어가요.

Changelog

VersionChange
3.5.0최초 제공

See Also


EStoveOwnershipCode

종류 열거형 · 모듈 Ownership · 버전 3.5.0

Description

IStoveOwnership::GetOwnershipCode() 가 돌려주는 값으로, 게임/DLC/데모 등 항목 하나의 현재 소유 상태를 나타내요.

Declaration

c
typedef enum EStoveOwnershipCode
{
    k_EStoveOwnershipCode_Invalid = -1,

    k_EStoveOwnershipCode_None = 0,
    k_EStoveOwnershipCode_Acquire = 1,
    k_EStoveOwnershipCode_Lose = 2,

    k_EStoveOwnershipCode_Max = 0x7fffffff
} EStoveOwnershipCode;

Enum Values

CodeNameDescription
-1k_EStoveOwnershipCode_Invalid사용하지 않아요
0k_EStoveOwnershipCode_None기록된 소유 상태가 없어요.
1k_EStoveOwnershipCode_Acquire사용자가 현재 이 항목을 소유하고 있어요.
2k_EStoveOwnershipCode_Lose사용자가 소유권을 잃었어요 (예: 환불).
0x7fffffffk_EStoveOwnershipCode_Max사용하지 않아요

Example

c
if (Stove_IStoveOwnership_GetOwnershipCode(ownership) == k_EStoveOwnershipCode_Acquire)
{
    // 소유 중인 항목에 대한 로직을 구현해 주세요.
}

Notes

See Also


EStoveOwnershipGameCode

종류 열거형 · 모듈 Ownership · 버전 3.5.0

Description

IStoveOwnership::GetGameCode() 가 돌려주는 값으로, 소유권 항목이 기본 게임인지 데모인지 DLC 인지를 나타내요.

Declaration

c
typedef enum EStoveOwnershipGameCode
{
    k_EStoveOwnershipGameCode_Invalid = -1,

    k_EStoveOwnershipGameCode_None = 0,
    // 1, 2 : 사용하지 않아요 (폐기된 번호)
    k_EStoveOwnershipGameCode_Basic = 3,
    k_EStoveOwnershipGameCode_Demo = 4,
    k_EStoveOwnershipGameCode_Dlc = 5,

    k_EStoveOwnershipGameCode_Max = 0x7fffffff
} EStoveOwnershipGameCode;

Enum Values

CodeNameDescription
-1k_EStoveOwnershipGameCode_Invalid사용하지 않아요
0k_EStoveOwnershipGameCode_None상품 항목이 아님 / 분류되지 않음
-1, 2사용하지 않아요 (폐기된 번호)
3k_EStoveOwnershipGameCode_Basic기본 게임
4k_EStoveOwnershipGameCode_Demo데모 빌드
5k_EStoveOwnershipGameCode_Dlc기본 게임에 연결된 다운로드 가능 콘텐츠(DLC)
0x7fffffffk_EStoveOwnershipGameCode_Max사용하지 않아요

Example

c
if (Stove_IStoveOwnership_GetGameCode(ownership) == k_EStoveOwnershipGameCode_Dlc)
{
    // DLC 항목에 대한 로직을 구현해 주세요.
}

Notes

  • 값 1, 2 는 예약/폐기(deprecated)된 번호예요.
  • IStoveOwnership 의 GameCode 필드 값이에요.

See Also


EStoveOwnershipMethodCode

종류 열거형 · 모듈 Ownership · 버전 3.5.0

Description

IStoveResult::GetMethodCode() 로 조회하며, 로깅과 오류 라우팅에 사용해요.

모듈 블록 4000~4999 를 순차적으로 사용해요.

Declaration

c
typedef enum EStoveOwnershipMethodCode
{
    k_EStoveOwnershipMethodCode_Invalid = -1,

    k_EStoveOwnershipMethodCode_FetchOwnerships = 4000,

    k_EStoveOwnershipMethodCode_Max = 0x7fffffff
} EStoveOwnershipMethodCode;

Enum Values

CodeNameDescription
-1k_EStoveOwnershipMethodCode_Invalid사용하지 않아요
4000k_EStoveOwnershipMethodCode_FetchOwnershipsStove_FetchOwnerships 가 만든 결과예요.
0x7fffffffk_EStoveOwnershipMethodCode_Max사용하지 않아요

Example

c
IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

if (Stove_IStoveResult_GetMethodCode(result) == k_EStoveOwnershipMethodCode_FetchOwnerships)
{
    // Stove_FetchOwnerships() 호출에 대한 결과예요.
}

Notes

  • 소유권 기능은 Stove_FetchOwnerships() 하나만 공개 API 로 제공해요. 초기화·종료는 SDK 가 대신해요.

See Also


EStoveOwnershipTypeKind

종류 열거형 · 모듈 Ownership · 버전 3.5.0

Description

소유권 기능의 비동기 콜백으로 전달되는 결과/데이터 객체의 런타임 타입 식별에 쓰예요. IStoveTypeBase::GetTypeKind() 로 조회해요. 정수 범위는 4000 ~ 4999 예요.

Declaration

c
typedef enum EStoveOwnershipTypeKind
{
    k_EStoveOwnershipTypeKind_Invalid = -1,

    k_EStoveOwnershipTypeKind_StoveOwnership = 4000,
    k_EStoveOwnershipTypeKind_OwnershipList = 4001,

    k_EStoveOwnershipTypeKind_Max = 0x7fffffff
} EStoveOwnershipTypeKind;

Enum Values

CodeNameDescription
-1k_EStoveOwnershipTypeKind_Invalid사용하지 않아요
4000k_EStoveOwnershipTypeKind_StoveOwnershipIStoveOwnership 의 타입 값이에요.
4001k_EStoveOwnershipTypeKind_OwnershipListIStoveOwnershipList 의 타입 값이에요.
0x7fffffffk_EStoveOwnershipTypeKind_Max사용하지 않아요

Example

c
if (Stove_IStoveTypeBase_GetTypeKind((const IStoveTypeBase*)ownerships) == k_EStoveOwnershipTypeKind_OwnershipList)
{
    // ownerships 를 IStoveOwnershipList 로 사용하는 로직을 구현해 주세요.
}

Notes

  • 소유권 기능은 호출자가 생성하는 입력 파라미터 타입을 정의하지 않아요. 이 열거형에 포함된 값은 모두 SDK 가 콜백으로 돌려주는 결과/데이터 타입이에요.
  • 4000~4999 범위는 소유권 기능 전용으로 예약되어 있어 다른 모듈의 TypeKind 값과 겹치지 않아요.

See Also


EStoveProductTypeCode

종류 열거형 · 모듈 IAP · 버전 3.5.0

Description

IStoveProduct 의 ProductTypeCode 로 반환되는 상품 분류 코드예요.

Declaration

c
typedef enum EStoveProductTypeCode
{
    k_EStoveProductTypeCode_None = 0,
    k_EStoveProductTypeCode_IndiePackageGameItem = 1,
    k_EStoveProductTypeCode_InGameItem = 2,
    k_EStoveProductTypeCode_PackageItem = 3,
    k_EStoveProductTypeCode_Max = 0x7fffffff
} EStoveProductTypeCode;

Enum Values

CodeNameDescription
0k_EStoveProductTypeCode_None분류 없음
1k_EStoveProductTypeCode_IndiePackageGameItem예약됨 (현재 사용하지 않음)
2k_EStoveProductTypeCode_InGameItem인게임 아이템
3k_EStoveProductTypeCode_PackageItem예약됨 (현재 사용하지 않음)
0x7fffffffk_EStoveProductTypeCode_Max사용하지 않아요

Example

c
int32_t typeCode = Stove_IStoveProduct_GetProductTypeCode(product);
if (typeCode == k_EStoveProductTypeCode_InGameItem)
{
    // 인게임 아이템 전용 로직을 구현해 주세요.
}

Notes

  • IStoveProduct::ProductTypeCode 값을 해석할 때 사용해요.
  • 현재 사용하는 값은 0 과 2 뿐이에요. 1 과 3 은 예약된 값이며 향후 다른 뜻으로 바뀔 예정이니, 게임 코드에서 이 값에 의존하지 말아 주세요.

See Also


EStovePurchaseLimitTypeCode

종류 열거형 · 모듈 IAP · 버전 3.5.0

Description

IStoveProduct 의 PurchaseLimitTypeCode 로 반환되며, PurchaseLimitCount 가 어느 범위(계정 단위 · 캐릭터 단위)로 적용되는지를 나타내요.

Declaration

c
typedef enum EStovePurchaseLimitTypeCode
{
    k_EStovePurchaseLimitTypeCode_None = 0,
    k_EStovePurchaseLimitTypeCode_Unlimited = 1,
    k_EStovePurchaseLimitTypeCode_Member = 2,
    k_EStovePurchaseLimitTypeCode_Character = 3,
    k_EStovePurchaseLimitTypeCode_Max = 0x7fffffff
} EStovePurchaseLimitTypeCode;

Enum Values

CodeNameDescription
0k_EStovePurchaseLimitTypeCode_None정의된 제한 정책 없음
1k_EStovePurchaseLimitTypeCode_Unlimited무제한 구매 가능
2k_EStovePurchaseLimitTypeCode_Member계정(회원) 단위 제한
3k_EStovePurchaseLimitTypeCode_Character캐릭터 단위 제한
0x7fffffffk_EStovePurchaseLimitTypeCode_Max사용하지 않아요

Example

c
int32_t limitType = Stove_IStoveProduct_GetPurchaseLimitTypeCode(product);
int32_t limitCount = Stove_IStoveProduct_GetPurchaseLimitCount(product);

Notes

See Also


EStovePurchaseOperation

종류 열거형 · 모듈 IAP · 버전 3.5.0

Description

IStovePurchaseParam 의 Operation 값으로 전달해, Stove_StartPurchase() 가 수동 URL 방식·Stove 웹뷰 방식·웹뷰+자동확정 방식 중 어느 흐름으로 동작할지 선택해요.

Declaration

c
typedef enum EStovePurchaseOperation
{
    k_EStovePurchaseOperation_Default = 0,
    k_EStovePurchaseOperation_WithWebView = 1,
    k_EStovePurchaseOperation_WithWebViewAndConfirmResult = 2,
    k_EStovePurchaseOperation_Max = 0x7fffffff
} EStovePurchaseOperation;

Enum Values

CodeNameDescription
0k_EStovePurchaseOperation_DefaultStove 웹뷰를 사용하지 않아요. 호출자가 구매 결과의 1회용 URL로 Stove 결제 페이지를 직접 열고, 결제 후 Stove_ConfirmPurchase() 를 호출해 구매를 확정해야 해요.
1k_EStovePurchaseOperation_WithWebViewStove 결제 페이지를 Stove 웹뷰 안에서 열어요. 결제 후에도 호출자가 Stove_ConfirmPurchase() 를 호출해야 구매가 확정돼요.
2k_EStovePurchaseOperation_WithWebViewAndConfirmResultStove 결제 페이지를 Stove 웹뷰 안에서 열고, 결제가 성공하면 Stove_ConfirmPurchase() 를 SDK 가 자동으로 호출해 확정된 구매 결과까지 돌려줘요.
0x7fffffffk_EStovePurchaseOperation_Max사용하지 않아요

Example

c
IStovePurchaseParam* purchaseParam = (IStovePurchaseParam*)Stove_CreateParam(k_EStoveIAPTypeKind_PurchaseParam);
Stove_IStovePurchaseParam_SetOperation(purchaseParam, k_EStovePurchaseOperation_WithWebViewAndConfirmResult);

Notes

  • Default 를 제외한 나머지 값을 쓸 때는 IStovePurchaseParam 이 상속하는 WebView* 필드(웹뷰 위치·크기)도 함께 채워야 해요.
  • 어느 필드가 결과에 채워지는지는 이 값에 따라 달라져요. 자세한 내용은 IStoveStartPurchaseOutcome 문서를 참고하세요.

See Also


EStovePurchaseProgress

종류 열거형 · 모듈 IAP · 버전 3.5.0

Description

IStoveStartPurchaseOutcome 의 PurchaseProgress 로 반환돼요.

Declaration

c
typedef enum EStovePurchaseProgress
{
    k_EStovePurchaseProgress_None = 0,
    k_EStovePurchaseProgress_NeedPaymentWindow = 1,
    k_EStovePurchaseProgress_NotNeedPaymentWindow = 2,
    k_EStovePurchaseProgress_Max = 0x7fffffff
} EStovePurchaseProgress;

Enum Values

CodeNameDescription
0k_EStovePurchaseProgress_None진행 상태 없음
1k_EStovePurchaseProgress_NeedPaymentWindow호출자가 결과의 1회용 결제 URL로 결제 창을 직접 열어야 해요.
2k_EStovePurchaseProgress_NotNeedPaymentWindow결제 창을 열 필요가 없어요, 무료 결제로 완료되었거나 웹뷰 기반 흐름이 이미 결제를 처리했어요.
0x7fffffffk_EStovePurchaseProgress_Max사용하지 않아요

Example

c
int32_t progress = Stove_IStoveStartPurchaseOutcome_GetPurchaseProgress(outcome);
if (progress == k_EStovePurchaseProgress_NeedPaymentWindow)
{
    const wchar_t* paymentUrl = Stove_IStoveStartPurchaseOutcome_GetTempPaymentUrl(outcome);
    // paymentUrl 로 결제 창을 열어 주세요.
}

Notes

See Also


EStoveResultCode

종류 결과코드 · 모듈 Base · 버전 3.5.0

Description

IStoveResult::GetResultCode() 로 조회하는 값 중, 여러 모듈이 공유하는 전역 사전에 속한 300번대 코드예요. 백의 자리 숫자로 범주를 구분해요(3xx: Base, 4xx: webview/popup UI, 5xx: IAP 구매/페이로드). 단일 바이너리 구조에서는 모듈 간 코드 분리가 의미가 없어, 여러 모듈에서 같은 의미로 쓰이던 코드를 하나의 번호로 통합했어요. 어떤 모듈에서 발생한 코드인지는 GetMethodCode() 값(코드 / 1000 = 모듈 블록)으로 확인할 수 있어요.

모든 모듈이 공통으로 쓰는 결과 코드(0~299)는 EStoveCommonResultCode 를 참조하세요.

옛 인터페이스의 모듈별 결과코드 열거형(EStoveBaseResultCode, EStoveIAPResultCode 등)은 없어졌어요. 현재는 이 열거형(300~) 과 EStoveCommonResultCode(0 ~ 299) 로 통합되었어요.

Declaration

c
typedef enum EStoveResultCode
{
    k_EStoveResultCode_LanguageNotSet = 300,
    // ... 이하 열거값 표 참조
    k_EStoveResultCode_InvalidOrderProductInformation = 503,

    k_EStoveResultCode_Max = 0x7fffffff
} EStoveResultCode;

Enum Values

3xx: Base 언어 / GDS / 런처 / 토큰 / IPC

CodeNameDescriptionShow to UserIn-Game Message
300k_EStoveResultCode_LanguageNotSet표시 언어가 설정되지 않았어요(Stove_SetLanguage 로 언어 설정 후 재호출)x
301k_EStoveResultCode_EmptyTranslatedString번역된 문자열이 비어 있어요x
302k_EStoveResultCode_NotFoundRequiredInformation필요한 정보를 찾지 못했어요x
303k_EStoveResultCode_InvalidGdsInfoGDS(국가/규제) 정보가 유효하지 않아요x
304k_EStoveResultCode_NeedStoveLauncherStove 런처가 필요하지만 실행되어 있지 않아요O게임이 스토브 PC 클라이언트를 통해 실행되지 않아 종료됩니다.클라이언트에서 다시 게임을 실행해주세요.클라이언트 미설치 시 스토브 홈페이지에서 설치해주세요.[확인]
305k_EStoveResultCode_LauncherFailedCreateRequired필요한 런처 리소스 생성에 실패했어요x
306k_EStoveResultCode_RenewTokenMaxRetryCountExceeded토큰 갱신이 최대 재시도 횟수를 초과했어요O네트워크 연결이 원활하지 않습니다. 네트워크 상태를 확인하고 다시 실행해 주세요. [확인]
307k_EStoveResultCode_IpcConnectFailed런처와의 IPC 연결에 실패했어요O게임이 스토브 PC 클라이언트를 통해 실행되지 않아 종료됩니다.클라이언트에서 다시 게임을 실행해주세요.클라이언트 미설치 시 스토브 홈페이지에서 설치해주세요.[확인]
308k_EStoveResultCode_IpcAesKeyNotReceivedIPC 로 AES 키를 받지 못했어요O게임이 스토브 PC 클라이언트를 통해 실행되지 않아 종료됩니다.클라이언트에서 다시 게임을 실행해주세요.클라이언트 미설치 시 스토브 홈페이지에서 설치해주세요.[확인]
309k_EStoveResultCode_IpcTimeout런처와의 IPC 통신이 시간 초과되었어요O게임이 스토브 PC 클라이언트를 통해 실행되지 않아 종료됩니다.클라이언트에서 다시 게임을 실행해주세요.클라이언트 미설치 시 스토브 홈페이지에서 설치해주세요.[확인]

아래 코드를 받으면 반드시 게임을 종료해야 해요. 정상 진행이 불가능한 상태예요.

  • 304 k_EStoveResultCode_NeedStoveLauncher: 스토브 PC 클라이언트를 통해 실행되지 않아 재실행이 필요해요
  • 307 k_EStoveResultCode_IpcConnectFailed: 런처와의 연결에 실패해 재실행이 필요해요
  • 308 k_EStoveResultCode_IpcAesKeyNotReceived: 런처와의 통신 준비에 실패해 재실행이 필요해요
  • 309 k_EStoveResultCode_IpcTimeout: 런처와의 통신이 시간 초과되어 재실행이 필요해요

4xx: (예약, 사용하지 않음)

CodeNameDescriptionShow to UserIn-Game Message
-400 ~ 499webview/popup UI 코드는 EStoveCommonResultCode 60~68 로 이동했어요--

5xx: IAP 구매 / 페이로드

CodeNameDescriptionShow to UserIn-Game Message
-501, 502EStoveCommonResultCode 80, 81 로 이동했어요--
503k_EStoveResultCode_InvalidOrderProductInformation주문/상품 정보가 유효하지 않아요O결제 정보가 유효하지 않아 결제를 진행할 수 없습니다. 다시 시도해 주세요. [확인]
0x7fffffffk_EStoveResultCode_Max사용하지 않아요--

Example

c
IStoveResult* result = Stove_SetGameProfile(profileParam);

if (Stove_IStoveResult_GetResultCode(result) == k_EStoveResultCode_LanguageNotSet)
{
    // Stove_SetLanguage() 를 먼저 호출하는 로직을 구현해 주세요.
}

Notes

  • 옛 인터페이스의 EStoveBaseResultCode(80번대)를 대체해요. 단일 바이너리 통합으로 모듈별 결과코드가 이 열거형(300~)과 EStoveCommonResultCode(0 ~ 299)로 재편되었어요.
  • 401 ~ 499, 501, 502 는 값 자체가 예약되어 있을 뿐 이 열거형에는 존재하지 않아요. 실제 코드는 EStoveCommonResultCode 60 ~ 68(webview/popup UI), 80 ~ 81(IAP 파라미터 검증)에서 찾을 수 있어요.

Changelog

VersionChange
3.5.0최초 제공 (옛 EStoveBaseResultCode 대체)

See Also


EStoveTermsOperation

종류 열거형 · 모듈 IAP · 버전 3.5.0

Description

IStoveFetchTermsAgreementParam 의 Operation 값으로 전달해, Stove_FetchTermsAgreement() 가 약관 페이지를 어떻게 노출할지 선택해요.

Declaration

c
typedef enum EStoveTermsOperation
{
    k_EStoveTermsOperation_Default = 0,
    k_EStoveTermsOperation_WithWebView = 1,
    k_EStoveTermsOperation_Max = 0x7fffffff
} EStoveTermsOperation;

Enum Values

CodeNameDescription
0k_EStoveTermsOperation_DefaultStove 웹뷰를 사용하지 않아요. 호출자가 결과로 받은 1회용 URL로 약관 페이지를 직접 열어요.
1k_EStoveTermsOperation_WithWebView약관 동의 페이지를 Stove 웹뷰 안에서 열어요.
0x7fffffffk_EStoveTermsOperation_Max사용하지 않아요

Example

c
IStoveFetchTermsAgreementParam* param = (IStoveFetchTermsAgreementParam*)Stove_CreateParam(k_EStoveIAPTypeKind_FetchTermsAgreementParam);
Stove_IStoveFetchTermsAgreementParam_SetOperation(param, k_EStoveTermsOperation_WithWebView);

Notes

  • WithWebView 를 쓸 때는 IStoveFetchTermsAgreementParam 이 상속하는 WebView* 필드(웹뷰 위치·크기)도 함께 채워야 해요.
  • 이미 최신 약관에 동의한 사용자라면 이 값과 무관하게 IStoveTermsAgreementOutcome 의 IsAgreed 가 true 로, Url 이 빈 문자열로 반환돼요.

See Also


EStoveWebViewMode

종류 열거형 · 모듈 Base · 버전 3.5.0

Description

View SDK 와 IAP SDK 에서 웹뷰를 외부 팝업(시스템 기본 브라우저)으로 열지, 내부 팝업(SDK 내장 웹뷰)으로 열지를 결정하는 값이에요.

Declaration

c
typedef enum EStoveWebViewMode
{
    k_EStoveWebViewMode_Invalid = -1,

    k_EStoveWebViewMode_External = 0,
    k_EStoveWebViewMode_Internal = 1,

    k_EStoveWebViewMode_Max = 0x7fffffff
} EStoveWebViewMode;

Enum Values

CodeNameDescription
-1k_EStoveWebViewMode_Invalid사용하지 않아요
0k_EStoveWebViewMode_External시스템 기본 브라우저에서 열어요
1k_EStoveWebViewMode_InternalSDK 내장 웹뷰에서 열어요
0x7fffffffk_EStoveWebViewMode_Max사용하지 않아요

Example

c
int32_t webViewMode = k_EStoveWebViewMode_Internal;

Notes

  • View SDK, IAP SDK 의 팝업 표시 방식을 지정할 때 사용하는 값이에요.
  • k_EStoveWebViewMode_Internal 은 "내부 웹뷰를 쓴다"는 도메인 의미의 값으로, SDK 내부 전용(Internal-only) 값이 아니에요.
  • 옛 인터페이스에서는 값 이름에 밑줄이 없었어요(예: k_EStoveWebViewModeInvalid). 현재 인터페이스는 k_EStoveWebViewMode_Invalid 처럼 타입명과 값명 사이에 밑줄이 들어가요.

Changelog

VersionChange
3.5.0최초 제공

See Also

  • 없음

IStoveAccessToken

종류 구조체 · 모듈 Base · 버전 3.5.0

Description

Stove_AccessTokenRenewed() 를 호출했을 때 AccessToken 이 갱신되는 시점에 콜백으로 전달되는 토큰 구조체예요.

SDK 가 만들어 콜백 인자로만 전달하며, 호출자는 해제하지 않아요.

Declaration

c
typedef struct IStoveAccessToken IStoveAccessToken;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
AccessTokenconst wchar_t*읽기Stove_IStoveAccessToken_GetAccessToken()Stove AccessToken 값이에요.
ExpireInint32_t읽기Stove_IStoveAccessToken_GetExpireIn()Stove AccessToken 의 남은 유효 시간(초)예요.

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK: 콜백 인자로만 전달되며 콜백이 끝나면 무효처리돼요. 호출자는 Destroy() 를 호출하지 않아요.

Example

c
void __cdecl OnAccessTokenRenewedCallback(const IStoveCallbackResult* callbackResult, const IStoveAccessToken* token)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    if (Stove_IStoveResult_GetResultCode(result) == k_EStoveCommonResultCode_Success)
    {
        const wchar_t* accessToken = Stove_IStoveAccessToken_GetAccessToken(token);
        int32_t expireIn = Stove_IStoveAccessToken_GetExpireIn(token);
        // 성공 시 로직을 구현해 주세요.
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }

    // token 은 Destroy() 를 호출하지 않아요.
}

Notes

  • 이 구조체는 Stove_AccessTokenRenewed() 로 등록한 콜백을 통해서만 받아요. 현재 유효한 토큰을 즉시 조회하려면 Stove_GetAccessToken 을 사용해요.
  • SDK 는 내부적으로 토큰을 자동 갱신하며, 갱신이 필요한 시점에 작업을 수행하려는 경우에만 이 콜백을 사용해요.

See Also


IStoveAchievement

종류 구조체 · 모듈 GameSupport · 버전 3.5.0

Description

IStoveAchievement 는 업적(Achievement) 조회 API 가 성공했을 때 전달되는 결과 정보를 담는 타입이에요. Stove_FetchAchievement 는 이 타입 하나를 OnGetAchievementCallback 인자로 전달하고, Stove_FetchAchievements 는 이 타입을 담은 IStoveAchievementList 를 OnGetAchievementsCallback 인자로 전달해요.

이 타입은 SDK 가 만들어 콜백을 통해 전달하며, 호출자가 직접 생성하지 않아요.

Declaration

c
typedef struct IStoveAchievement IStoveAchievement;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
Conditionconst IStoveAchievementCondition*읽기Stove_IStoveAchievement_GetCondition()업적 완료 조건이에요.
Valueint32_t읽기Stove_IStoveAchievement_GetValue()업적의 현재 진행 값이에요.
AchievementIdconst wchar_t*읽기Stove_IStoveAchievement_GetAchievementId()업적 ID 예요.
Nameconst wchar_t*읽기Stove_IStoveAchievement_GetName()업적의 현지화된 이름이에요.
Descriptionconst wchar_t*읽기Stove_IStoveAchievement_GetDescription()업적의 현지화된 설명이에요.
DefaultImageconst wchar_t*읽기Stove_IStoveAchievement_GetDefaultImage()미달성 상태 이미지 URL 이에요.
AchievedImageconst wchar_t*읽기Stove_IStoveAchievement_GetAchievedImage()달성 상태 이미지 URL 이에요.
Statusconst wchar_t*읽기Stove_IStoveAchievement_GetStatus()업적의 현재 상태예요. 예: "ONGOING"(진행 중), "ACHIEVED"(달성 완료)

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK (해제 금지. 콜백(Stove_FetchAchievement / Stove_FetchAchievements)이 끝나면 무효처리돼요)

Example

c
void OnGetAchievementFinished(const IStoveCallbackResult* callbackResult, const IStoveAchievement* achievement)
{
    if (Stove_IStoveResult_GetResultCode(Stove_IStoveCallbackResult_GetResult(callbackResult)) == 0 && achievement != NULL)
    {
        const wchar_t* status = Stove_IStoveAchievement_GetStatus(achievement);
        int32_t value = Stove_IStoveAchievement_GetValue(achievement);

        // 성공 시 로직을 구현해 주세요.
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Notes

  • 호출자가 직접 생성하지 않으며, Stove_FetchAchievement 또는 Stove_FetchAchievements 콜백을 통해서만 얻을 수 있어요.
  • Condition 으로 얻는 IStoveAchievementCondition 도 이 객체와 함께 콜백이 끝나면 무효처리돼요.
  • Status, Condition 의 ValueOperation/Type 값은 고정된 열거형이 아니라 문자열로 전달돼요.

See Also


IStoveAchievementCondition

종류 구조체 · 모듈 GameSupport · 버전 3.5.0

Description

IStoveAchievementCondition 은 업적(Achievement) 을 완료하기 위한 조건을 담는 타입이에요. IStoveAchievement 안에 포함되어 전달돼요.

이 타입은 SDK 가 만들어 콜백을 통해 전달하며, 호출자가 직접 생성하지 않아요.

Declaration

c
typedef struct IStoveAchievementCondition IStoveAchievementCondition;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
ValueOperationconst wchar_t*읽기Stove_IStoveAchievementCondition_GetValueOperation()값 처리 방식이에요. 예: "DELTA_SUM"(값 누적 합산), "REPLACE"(값 교체), "MAX"(더 큰 값으로 교체), "MIN"(더 작은 값으로 교체)
Typeconst wchar_t*읽기Stove_IStoveAchievementCondition_GetType()목표값과 사용자 값의 비교 방식이에요. 예: "GTE"(이상), "LTE"(이하)
GoalValueint32_t읽기Stove_IStoveAchievementCondition_GetGoalValue()업적의 목표값이에요.

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK (해제 금지. 이 객체를 담고 있는 IStoveAchievement 콜백 인자가 무효처리되면 함께 무효처리돼요)

Example

c
void PrintAchievementCondition(const IStoveAchievement* achievement)
{
    const IStoveAchievementCondition* condition = Stove_IStoveAchievement_GetCondition(achievement);
    const wchar_t* type = Stove_IStoveAchievementCondition_GetType(condition);
    int32_t goalValue = Stove_IStoveAchievementCondition_GetGoalValue(condition);

    // 조건 값을 활용하는 로직을 구현해 주세요.
}

Notes

  • 호출자가 직접 생성하지 않으며, IStoveAchievement 를 통해서만 얻을 수 있어요.
  • ValueOperation, Type 값은 고정된 열거형이 아니라 문자열로 전달돼요.

See Also


IStoveAchievementList

종류 구조체 · 모듈 GameSupport · 버전 3.5.0

Description

IStoveAchievementList 는 OnGetAchievementsCallback 으로 전달되는 업적(Achievement) 목록을 감싸는 컨테이너 타입이에요. Stove_FetchAchievements 의 onFinished 콜백 인자로 전달돼요.

이 타입은 SDK 가 만들어 콜백을 통해 전달하며, 호출자가 직접 생성하지 않아요.

Declaration

c
typedef struct IStoveAchievementList IStoveAchievementList;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
Countuint32_t읽기Stove_IStoveAchievementList_GetCount()이번 응답에 담긴 업적 개수예요.
-const IStoveAchievement*읽기Stove_IStoveAchievementList_GetAt(index)0 부터 시작하는 인덱스로 업적 항목을 가져와요. index >= Count 이면 NULL 을 반환해요.
TotalCountuint32_t읽기Stove_IStoveAchievementList_GetTotalCount()업적 총 개수예요. v3.5.0 에서는 전체 목록이 한 번에 전달되므로 Count 와 같은 값이에요.

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK (해제 금지. Stove_FetchAchievements 콜백이 끝나면 무효처리돼요)

Example

c
void OnGetAchievementsFinished(const IStoveCallbackResult* callbackResult, const IStoveAchievementList* list)
{
    if (Stove_IStoveResult_GetResultCode(Stove_IStoveCallbackResult_GetResult(callbackResult)) == 0 && list != NULL)
    {
        uint32_t count = Stove_IStoveAchievementList_GetCount(list);
        for (uint32_t i = 0; i < count; i++)
        {
            const IStoveAchievement* achievement = Stove_IStoveAchievementList_GetAt(list, i);
            const wchar_t* achievementId = Stove_IStoveAchievement_GetAchievementId(achievement);

            // 성공 시 로직을 구현해 주세요.
        }
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Notes

  • 호출자가 직접 생성하지 않으며, Stove_FetchAchievements 콜백을 통해서만 얻을 수 있어요.
  • 담긴 IStoveAchievement 항목들도 이 목록과 함께 콜백이 끝나면 무효처리돼요.
  • v3.5.0 에서는 전체 업적 목록이 한 번에 전달돼요. 페이지 단위 조회는 v3.5.1 부터 제공돼요.

See Also


IStoveCallbackResult

종류 구조체 · 모듈 Base · 버전 3.5.0

Description

비동기 콜백에 전달되는 결과예요. IStoveResult 를 감싸고, 부가적인 오류 정보와 호출 시 전달한 userData 포인터를 함께 담아요.

Stove_RestartAppIfNecessary(), Stove_AccessTokenRenewed() 등 콜백 기반 비동기 API 의 첫 번째 콜백 인자로 전달돼요. 이 객체와 내부 포인터의 수명은 콜백 호출 동안으로 한정돼요. SDK 가 만들어 콜백 인자로만 전달하며, 호출자는 해제하지 않아요.

콜백이 끝나면 이 객체와 GetResult() 로 얻은 IStoveResult* 는 모두 무효처리돼요. Destroy() 를 호출하지 않아요.

Declaration

c
typedef struct IStoveCallbackResult IStoveCallbackResult;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
ResultIStoveResult*읽기Stove_IStoveCallbackResult_GetResult()내부 결과 객체예요. 콜백 호출 동안에만 유효해요.
ErrorMessageconst wchar_t*읽기Stove_IStoveCallbackResult_GetErrorMessage()오류가 발생한 이유를 설명하는 상세 메시지예요.
ExternalErrorint32_t읽기Stove_IStoveCallbackResult_GetExternalError()외부 오류 값이에요(HTTP 오류 코드 또는 API 결과 코드).
UserDatavoid*읽기Stove_IStoveCallbackResult_GetUserData()호출자가 비동기 API 호출 시 전달한 userData 포인터예요.

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK: 콜백 인자로만 전달되며 콜백이 끝나면 무효처리돼요. 호출자는 Destroy() 를 호출하지 않아요.

Example

c
void __cdecl OnAccessTokenRenewedCallback(const IStoveCallbackResult* callbackResult, const IStoveAccessToken* token)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    if (Stove_IStoveResult_GetResultCode(result) == k_EStoveCommonResultCode_Success)
    {
        // 성공 시 로직을 구현해 주세요.
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }

    // callbackResult, result, token 은 Destroy() 를 호출하지 않아요.
}

Notes

  • SDK 의 비동기 콜백(OnRestartAppIfNecessaryCallback, OnAccessTokenRenewedCallback, OnOverImmersionNotificationCallback, OnShutdownNotificationCallback, OnVietnamAgeRatingNotificationCallback, OnVietnamOverimmersionNotificationCallback, OnOpenExternalUrlCallback)의 첫 번째 인자로 전달돼요.
  • 콜백은 Stove_RunCallback() (또는 Stove_RunCallbackWithTimeout())을 호출한 스레드에서 실행돼요.

See Also


IStoveChargeInfo

종류 구조체 · 모듈 IAP · 버전 3.5.0

Description

한 번의 구매에 사용된 결제 수단(쿠폰, 스토브 캐시, 포인트, PG 등) 하나를 나타내요. IStoveStartPurchaseOutcome 과 IStoveConfirmPurchaseOutcome 양쪽에 배열 형태로 담겨 전달돼요.

SDK 가 채워서 콜백으로 전달하는 데이터형이에요. 호출자가 직접 만들지 않아요.

콜백으로 전달되는 배열과 각 항목은 SDK 소유이며 콜백 호출이 끝나면 더 이상 유효하지 않아요. Destroy() 를 호출하지 말고, 보관이 필요한 값은 콜백 안에서 복사해 두어야 해요.

Declaration

c
typedef struct IStoveChargeInfo IStoveChargeInfo;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
ChargeDeductValdouble읽기Stove_IStoveChargeInfo_GetChargeDeductVal()결제 시점에 실제로 차감된 금액 (결제 단위 기준)
ChargeDisplayDeductValdouble읽기Stove_IStoveChargeInfo_GetChargeDisplayDeductVal()차감 금액의 캐시 환산 표시 값
ChargeTypeint32_t읽기Stove_IStoveChargeInfo_GetChargeType()결제 수단 코드(charge_type, Int32). 2: 쿠폰, 98: 스토브 캐시, 99: 포인트, 그 외: PG(결제대행사) 결제 수단(서버에서 추가될 수 있음). 2/98/99 만 고정값이며 나머지는 서버가 정해요.
ChargeTypeNameconst wchar_t*읽기Stove_IStoveChargeInfo_GetChargeTypeName()현지화된 결제 수단 이름

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK (해제 금지, 콜백이 끝나면 무효)

Example

c
void __cdecl OnConfirmPurchaseCallback(const IStoveCallbackResult* callbackResult, const IStoveConfirmPurchaseOutcome* outcome)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    // 스팀런처 동선은 IsConfirmed 가 항상 false 로 오므로 판정은 Stove_ConfirmPurchase 예제의 공통 판정을 따라 주세요.
    if (Stove_IStoveResult_GetResultCode(result) == 0 && Stove_IStoveConfirmPurchaseOutcome_IsConfirmed(outcome))
    {
        uint32_t count = Stove_IStoveConfirmPurchaseOutcome_GetChargeInfoCount(outcome);

        for (uint32_t i = 0; i < count; ++i)
        {
            const IStoveChargeInfo* chargeInfo = Stove_IStoveConfirmPurchaseOutcome_GetChargeInfoAt(outcome, i);

            double deductVal = Stove_IStoveChargeInfo_GetChargeDeductVal(chargeInfo);
            const wchar_t* typeName = Stove_IStoveChargeInfo_GetChargeTypeName(chargeInfo);

            // 필요한 값만 복사해서 보관해 주세요.
        }
        // outcome 과 그 안의 항목은 이 콜백이 끝나면 무효처리돼요. Destroy() 를 호출하지 마십시오.
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Notes

See Also


IStoveConfirmPurchaseOutcome

종류 구조체 · 모듈 IAP · 버전 3.5.0

Description

Stove_ConfirmPurchase 호출 결과를 나타내요. OnConfirmPurchaseCallback 콜백에 전달돼요. 예전에는 확정 여부 플래그와 상품/결제 정보 배열이 콜백 인자로 각각 개별 전달되었으나, 지금은 이 구조체 하나로 묶여 전달돼요.

SDK 가 채워서 콜백으로 전달하는 데이터형이에요. 호출자가 직접 만들지 않아요.

PurchasedProductAt() / ChargeInfoAt() 으로 얻는 항목은 모두 SDK 소유이며 콜백 호출이 끝나면 더 이상 유효하지 않아요. Destroy() 를 호출하지 말고, 보관이 필요한 값은 콜백 안에서 복사해 두어야 해요.

Declaration

c
typedef struct IStoveConfirmPurchaseOutcome IStoveConfirmPurchaseOutcome;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
IsConfirmedbool읽기Stove_IStoveConfirmPurchaseOutcome_IsConfirmed()구매가 성공적으로 확정되었는지 여부
PurchasedProductCountuint32_t읽기Stove_IStoveConfirmPurchaseOutcome_GetPurchasedProductCount()구매 확정된 상품 항목 수
PurchasedProductAt(index)const IStovePurchasedProduct*읽기Stove_IStoveConfirmPurchaseOutcome_GetPurchasedProductAt()index(0부터 시작) 위치의 구매 상품 항목. index >= PurchasedProductCount 이면 nullptr 을 반환해요.
ChargeInfoCountuint32_t읽기Stove_IStoveConfirmPurchaseOutcome_GetChargeInfoCount()charge-info 항목 수
ChargeInfoAt(index)const IStoveChargeInfo*읽기Stove_IStoveConfirmPurchaseOutcome_GetChargeInfoAt()index(0부터 시작) 위치의 charge-info 항목. index >= ChargeInfoCount 이면 nullptr 을 반환해요.

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK (해제 금지, 콜백이 끝나면 무효)

Example

c
void __cdecl OnConfirmPurchaseCallback(const IStoveCallbackResult* callbackResult, const IStoveConfirmPurchaseOutcome* outcome)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    // 스팀런처 동선은 IsConfirmed 가 항상 false 로 오므로 판정은 Stove_ConfirmPurchase 예제의 공통 판정을 따라 주세요.
    if (Stove_IStoveResult_GetResultCode(result) == 0 && Stove_IStoveConfirmPurchaseOutcome_IsConfirmed(outcome))
    {
        uint32_t productCount = Stove_IStoveConfirmPurchaseOutcome_GetPurchasedProductCount(outcome);
        for (uint32_t i = 0; i < productCount; ++i)
        {
            const IStovePurchasedProduct* product = Stove_IStoveConfirmPurchaseOutcome_GetPurchasedProductAt(outcome, i);
            // 아이템 지급 로직을 구현해 주세요. TxnDetailNo 기준으로 중복 지급을 방지해 주세요.
        }
        // outcome 과 그 안의 항목은 이 콜백이 끝나면 무효처리돼요. Destroy() 를 호출하지 마십시오.
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Notes

  • Stove_ConfirmPurchase 의 출력으로만 전달돼요.
  • IsConfirmed 가 false 이면 상품/결제 정보 배열이 비어 있을 수 있어요.

See Also


IStoveConfirmPurchaseParam

종류 구조체 · 모듈 IAP · 버전 3.5.0

Description

Stove_ConfirmPurchase 를 호출할 때 전달하는 입력 파라미터예요. IStoveStartPurchaseOutcome 에서 받은 트랜잭션 마스터 번호로 구매를 확정할 때 사용해요.

Stove_CreateParam(k_EStoveIAPTypeKind_ConfirmPurchaseParam) 으로 생성하고, setter 로 값을 채운 뒤 호출이 끝나면 Destroy() 로 해제해야 해요.

Declaration

c
typedef struct IStoveConfirmPurchaseParam IStoveConfirmPurchaseParam;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessRequiredAccessorDescription
TxnMasterNoint64_t읽기·쓰기예Stove_IStoveConfirmPurchaseParam_GetTxnMasterNo() / Stove_IStoveConfirmPurchaseParam_SetTxnMasterNo()IStoveStartPurchaseOutcome 에서 받은 트랜잭션 마스터 번호

Memory Management

ItemValue
생성 주체호출자 (Stove_CreateParam(k_EStoveIAPTypeKind_ConfirmPurchaseParam))
해제 책임호출자 (Destroy() 필수)

Example

c
IStoveConfirmPurchaseParam* confirmParam = (IStoveConfirmPurchaseParam*)Stove_CreateParam(k_EStoveIAPTypeKind_ConfirmPurchaseParam);

Stove_IStoveConfirmPurchaseParam_SetTxnMasterNo(confirmParam, txnMasterNo);

Stove_ConfirmPurchase(confirmParam, OnConfirmPurchaseCallback, NULL);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)confirmParam);

Notes

  • TxnMasterNo 는 Stove_StartPurchase 의 결과인 IStoveStartPurchaseOutcome 의 TxnMasterNo 값을 그대로 사용해 주세요.
  • Operation == Default 로 시작한 구매는 결제 창에서 결제를 마친 뒤 반드시 이 API 로 구매를 확정해야 해요.

See Also


IStoveFetchAchievementParam

종류 구조체 · 모듈 GameSupport · 버전 3.5.0

Description

IStoveFetchAchievementParam 은 조회할 업적(Achievement) 하나를 지정하는 파라미터 타입이에요. Stove_FetchAchievement 의 입력으로 사용해요.

호출자가 Stove_CreateParam(k_EStoveGameSupportTypeKind_FetchAchievementParam) 으로 생성하고, 값을 채운 뒤 API 호출이 끝나면 Destroy() 로 해제해요.

Declaration

c
typedef struct IStoveFetchAchievementParam IStoveFetchAchievementParam;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeRequiredAccessAccessorDescription
AchievementIdconst wchar_t*예읽기·쓰기Stove_IStoveFetchAchievementParam_GetAchievementId() / SetAchievementId()조회할 업적 ID 예요.

Memory Management

ItemValue
생성 주체호출자 (Stove_CreateParam(k_EStoveGameSupportTypeKind_FetchAchievementParam))
해제 책임호출자 (Destroy() 필수)

Example

c
IStoveFetchAchievementParam* param =
    (IStoveFetchAchievementParam*)Stove_CreateParam(k_EStoveGameSupportTypeKind_FetchAchievementParam);
Stove_IStoveFetchAchievementParam_SetAchievementId(param, L"ACHV_FIRST_KILL");

Stove_FetchAchievement(param, OnGetAchievementFinished, NULL);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param);

Notes

See Also


IStoveFetchAchievementsParam

종류 구조체 · 모듈 GameSupport · 버전 3.5.0

Description

IStoveFetchAchievementsParam 은 현재 사용자의 업적(Achievement) 목록을 조회할 때 넘기는 파라미터 타입이에요. Stove_FetchAchievements 의 입력으로 사용해요.

호출자가 Stove_CreateParam(k_EStoveGameSupportTypeKind_FetchAchievementsParam) 으로 생성하고, API 호출이 끝나면 Destroy() 로 해제해요.

v3.5.0 에서는 페이지 단위 조회를 사용하지 마세요. AchievementId · PageSize 를 채우지 않고 호출하면 기존과 같이 전체 업적 목록이 한 번에 조회돼요. 페이지 단위 조회는 서버 API 규격이 확정된 뒤 v3.5.1 부터 제공돼요.

Declaration

c
typedef struct IStoveFetchAchievementsParam IStoveFetchAchievementsParam;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeRequiredAccessAccessorDescription
AchievementIdconst wchar_t*아니오읽기·쓰기Stove_IStoveFetchAchievementsParam_GetAchievementId() / SetAchievementId()페이지 단위 조회에 쓰는 커서예요. v3.5.1 부터 사용해요, v3.5.0 에서는 값을 넣지 마세요.
PageSizeuint32_t아니오읽기·쓰기Stove_IStoveFetchAchievementsParam_GetPageSize() / SetPageSize()페이지당 조회할 업적 개수예요. v3.5.1 부터 사용해요, v3.5.0 에서는 값을 넣지 마세요. 넣지 않으면 전체 업적 목록을 조회해요.

Memory Management

ItemValue
생성 주체호출자 (Stove_CreateParam(k_EStoveGameSupportTypeKind_FetchAchievementsParam))
해제 책임호출자 (Destroy() 필수)

Example

c
// 전체 업적 목록 조회 (v3.5.0 은 이 형태만 사용해요)
IStoveFetchAchievementsParam* param =
    (IStoveFetchAchievementsParam*)Stove_CreateParam(k_EStoveGameSupportTypeKind_FetchAchievementsParam);

Stove_FetchAchievements(param, OnGetAchievementsFinished, NULL);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param);

Notes

  • 값을 채우지 않으면 전체 업적 목록을 한 번에 조회해요. v3.5.0 에서는 이 형태로만 호출하세요.
  • 두 값을 쓰는 페이지 단위 조회는 v3.5.1 부터 제공돼요. 그때 사용 방법을 이 문서에 추가해요.

See Also


IStoveFetchProductsParam

종류 구조체 · 모듈 IAP · 버전 3.5.0

Description

Stove_FetchProducts 를 호출할 때 전달하는 입력 파라미터예요. 조회할 카테고리와 페이지 범위를 지정해요.

Stove_CreateParam(k_EStoveIAPTypeKind_FetchProductsParam) 으로 생성하고, setter 로 값을 채운 뒤 호출이 끝나면 Destroy() 로 해제해야 해요.

Declaration

c
typedef struct IStoveFetchProductsParam IStoveFetchProductsParam;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessRequiredAccessorDescription
CategoryIdconst wchar_t*읽기·쓰기아니오Stove_IStoveFetchProductsParam_GetCategoryId() / Stove_IStoveFetchProductsParam_SetCategoryId()카테고리 ID 필터. 비워 두면 모든 카테고리의 상품을 조회해요.
PageIndexuint32_t읽기·쓰기예Stove_IStoveFetchProductsParam_GetPageIndex() / Stove_IStoveFetchProductsParam_SetPageIndex()페이지 번호(1부터 시작). 서버에 전달되는 page_no 값과 일치해요.
PageSizeuint32_t읽기·쓰기예Stove_IStoveFetchProductsParam_GetPageSize() / Stove_IStoveFetchProductsParam_SetPageSize()페이지당 상품 수

Memory Management

ItemValue
생성 주체호출자 (Stove_CreateParam(k_EStoveIAPTypeKind_FetchProductsParam))
해제 책임호출자 (Destroy() 필수)

Example

c
IStoveFetchProductsParam* param = (IStoveFetchProductsParam*)Stove_CreateParam(k_EStoveIAPTypeKind_FetchProductsParam);

Stove_IStoveFetchProductsParam_SetCategoryId(param, L"");
Stove_IStoveFetchProductsParam_SetPageIndex(param, 1);
Stove_IStoveFetchProductsParam_SetPageSize(param, 20);

Stove_FetchProducts(param, OnFetchProductsCallback, NULL);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param);

Notes

  • CategoryId 를 비워 두면 전체 카테고리의 상품을 조회해요. 특정 카테고리만 조회하려면 IStoveShopCategory 의 CategoryId 값을 지정해 주세요.

See Also


IStoveFetchRankingParam

종류 구조체 · 모듈 GameSupport · 버전 3.5.0

Description

IStoveFetchRankingParam 은 조회할 리더보드와 페이지 정보를 지정하는 파라미터 타입이에요. Stove_FetchRanking 의 입력으로 사용해요.

호출자가 Stove_CreateParam(k_EStoveGameSupportTypeKind_FetchRankingParam) 으로 생성하고, 값을 채운 뒤 API 호출이 끝나면 Destroy() 로 해제해요.

Declaration

c
typedef struct IStoveFetchRankingParam IStoveFetchRankingParam;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeRequiredAccessAccessorDescription
LeaderboardIdconst wchar_t*예읽기·쓰기Stove_IStoveFetchRankingParam_GetLeaderboardId() / SetLeaderboardId()스튜디오가 만든 리더보드 식별자예요.
PageIndexuint32_t예읽기·쓰기Stove_IStoveFetchRankingParam_GetPageIndex() / SetPageIndex()조회할 페이지 번호예요 (1 <= pageIndex).
PageSizeuint32_t예읽기·쓰기Stove_IStoveFetchRankingParam_GetPageSize() / SetPageSize()페이지당 조회할 랭킹 개수예요 (1 <= pageSize <= 50).
IncludeMyRankbool예읽기·쓰기Stove_IStoveFetchRankingParam_GetIncludeMyRank() / SetIncludeMyRank()조회 결과에 로그인한 사용자 본인의 랭킹을 포함할지 여부예요.

Memory Management

ItemValue
생성 주체호출자 (Stove_CreateParam(k_EStoveGameSupportTypeKind_FetchRankingParam))
해제 책임호출자 (Destroy() 필수)

Example

c
IStoveFetchRankingParam* param =
    (IStoveFetchRankingParam*)Stove_CreateParam(k_EStoveGameSupportTypeKind_FetchRankingParam);
Stove_IStoveFetchRankingParam_SetLeaderboardId(param, L"WEEKLY_SCORE");
Stove_IStoveFetchRankingParam_SetPageIndex(param, 1);
Stove_IStoveFetchRankingParam_SetPageSize(param, 20);
Stove_IStoveFetchRankingParam_SetIncludeMyRank(param, true);

Stove_FetchRanking(param, OnGetRankingFinished, NULL);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param);

Notes

See Also


IStoveFetchStatParam

종류 구조체 · 모듈 GameSupport · 버전 3.5.0

Description

IStoveFetchStatParam 은 조회할 통계(Stat) 를 지정하는 파라미터 타입이에요. Stove_FetchStat 의 입력으로 사용해요.

호출자가 Stove_CreateParam(k_EStoveGameSupportTypeKind_FetchStatParam) 으로 생성하고, 값을 채운 뒤 API 호출이 끝나면 Destroy() 로 해제해요.

Declaration

c
typedef struct IStoveFetchStatParam IStoveFetchStatParam;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeRequiredAccessAccessorDescription
StatsIdconst wchar_t*예읽기·쓰기Stove_IStoveFetchStatParam_GetStatsId() / SetStatsId()조회할 통계 ID 예요. 형식: [A-Z0-9\-_]*$ (대문자, 숫자, 밑줄, 하이픈)

Memory Management

ItemValue
생성 주체호출자 (Stove_CreateParam(k_EStoveGameSupportTypeKind_FetchStatParam))
해제 책임호출자 (Destroy() 필수)

Example

c
IStoveFetchStatParam* param =
    (IStoveFetchStatParam*)Stove_CreateParam(k_EStoveGameSupportTypeKind_FetchStatParam);
Stove_IStoveFetchStatParam_SetStatsId(param, L"KILL_COUNT");

Stove_FetchStat(param, OnGetStatFinished, NULL);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param);

Notes

  • StatsId 를 설정하지 않으면 올바른 통계를 조회할 수 없어요.

See Also


IStoveFetchTermsAgreementParam

종류 구조체 · 모듈 IAP · 버전 3.5.0

Description

Stove_FetchTermsAgreement 를 호출할 때 전달하는 입력 파라미터예요. IStoveWebViewLayoutParam 을 상속하며, WebView* 필드는 모두 Operation 이 Default 가 아닐 때만 적용돼요.

Stove_CreateParam(k_EStoveIAPTypeKind_FetchTermsAgreementParam) 으로 생성하고, setter 로 값을 채운 뒤 호출이 끝나면 Destroy() 로 해제해야 해요.

Declaration

c
typedef struct IStoveFetchTermsAgreementParam IStoveFetchTermsAgreementParam;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessRequiredAccessorDescription
OperationEStoveTermsOperation읽기·쓰기예Stove_IStoveFetchTermsAgreementParam_GetOperation() / Stove_IStoveFetchTermsAgreementParam_SetOperation()동작 방식 선택자
WebViewModeEStoveWebViewMode읽기·쓰기아니오Stove_IStoveFetchTermsAgreementParam_GetWebViewMode() / Stove_IStoveFetchTermsAgreementParam_SetWebViewMode()웹뷰 표시 모드 (외부 브라우저 / SDK 내장 웹뷰). Operation != Default 일 때만 적용돼요. IStoveWebViewLayoutParam 상속 멤버예요.
WebViewPosXint32_t읽기·쓰기아니오Stove_IStoveFetchTermsAgreementParam_GetWebViewPosX() / Stove_IStoveFetchTermsAgreementParam_SetWebViewPosX()웹뷰 x 좌표 (픽셀). Operation != Default 일 때만 적용돼요. IStoveWebViewLayoutParam 상속 멤버예요.
WebViewPosYint32_t읽기·쓰기아니오Stove_IStoveFetchTermsAgreementParam_GetWebViewPosY() / Stove_IStoveFetchTermsAgreementParam_SetWebViewPosY()웹뷰 y 좌표 (픽셀). Operation != Default 일 때만 적용돼요. IStoveWebViewLayoutParam 상속 멤버예요.
WebViewWidthint32_t읽기·쓰기아니오Stove_IStoveFetchTermsAgreementParam_GetWebViewWidth() / Stove_IStoveFetchTermsAgreementParam_SetWebViewWidth()웹뷰 너비 (픽셀). Operation != Default 일 때만 적용돼요. IStoveWebViewLayoutParam 상속 멤버예요.
WebViewHeightint32_t읽기·쓰기아니오Stove_IStoveFetchTermsAgreementParam_GetWebViewHeight() / Stove_IStoveFetchTermsAgreementParam_SetWebViewHeight()웹뷰 높이 (픽셀). Operation != Default 일 때만 적용돼요. IStoveWebViewLayoutParam 상속 멤버예요.

Memory Management

ItemValue
생성 주체호출자 (Stove_CreateParam(k_EStoveIAPTypeKind_FetchTermsAgreementParam))
해제 책임호출자 (Destroy() 필수)

Example

c
IStoveFetchTermsAgreementParam* param = (IStoveFetchTermsAgreementParam*)Stove_CreateParam(k_EStoveIAPTypeKind_FetchTermsAgreementParam);

Stove_IStoveFetchTermsAgreementParam_SetOperation(param, k_EStoveTermsOperation_WithWebView);
Stove_IStoveFetchTermsAgreementParam_SetWebViewMode(param, k_EStoveWebViewMode_Internal);
Stove_IStoveFetchTermsAgreementParam_SetWebViewWidth(param, 480);
Stove_IStoveFetchTermsAgreementParam_SetWebViewHeight(param, 640);

Stove_FetchTermsAgreement(param, OnFetchTermsAgreementCallback, NULL, NULL, NULL);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param);

Notes

  • Operation 이 Default 이면 WebView* 필드는 무시돼요.

See Also


IStoveGds

종류 구조체 · 모듈 Base · 버전 3.5.0

Description

Stove_GetGds() 호출 시 전달되는 국가/규제/시간대/언어 정보 구조체예요.

로그인한 사용자의 IP 기반 국가 코드를 기본으로 제공하며, IP 로 국가를 판별할 수 없을 때는 기본 국가 코드로 대체돼요(IsDefault 로 구분). SDK 가 Stove_GetGds() 의 out 파라미터로 만들어 돌려주며, 호출자가 사용 후 Destroy() 로 해제해요.

Declaration

c
typedef struct IStoveGds IStoveGds;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
IsDefaultbool읽기Stove_IStoveGds_IsDefault()사용자의 IP 로 국가 코드를 판별할 수 없어 기본 국가 코드를 사용했는지 여부예요. IP 로 판별된 경우 false 이에요.
Nationconst wchar_t*읽기Stove_IStoveGds_GetNation()로그인한 사용자의 IP 로 판별한 국가 코드예요(ISO 3166-1 ALPHA-2).
Regulationconst wchar_t*읽기Stove_IStoveGds_GetRegulation()국가 코드에 따라 적용되는 규제 이름이에요(예: GDPR).
Timezoneconst wchar_t*읽기Stove_IStoveGds_GetTimezone()로그인한 사용자의 시간대예요(IANA Time Zone Database ID, 예: L"Asia/Seoul").
UtcOffsetint32_t읽기Stove_IStoveGds_GetUtcOffset()사용자 시간대의 UTC 오프셋(분)이에요.
Langconst wchar_t*읽기Stove_IStoveGds_GetLang()로그인한 사용자의 언어예요(ISO 639-1 ALPHA-2). 예외: 중국어는 zh / zh-tw, 인도네시아어는 "in" 을 사용해요.

Memory Management

ItemValue
생성 주체SDK (Stove_GetGds() 의 out 파라미터로 전달)
해제 책임호출자 (Destroy() 필수)

Example

c
IStoveGds* gds = NULL;
IStoveResult* result = Stove_GetGds(&gds);

if (Stove_IStoveResult_GetResultCode(result) == k_EStoveCommonResultCode_Success)
{
    const wchar_t* nation = Stove_IStoveGds_GetNation(gds);
    const wchar_t* timezone = Stove_IStoveGds_GetTimezone(gds);
    // 성공 시 로직을 구현해 주세요.

    Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)gds);
}
else
{
    // 실패 시 로직을 구현해 주세요.
}

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result);

Notes

  • Stove_Initialize() 로 초기화가 끝난 뒤 호출해야 유효한 값을 받을 수 있어요.

See Also


IStoveInitializeParam

종류 구조체 · 모듈 Base · 버전 3.5.0

Description

Stove_Initialize() 호출에 필요한 파라미터를 담아요. IAP 상점 키와 게임 메인 윈도우 핸들을 설정하는 용도로만 쓰예요.

Stove_CreateParam(k_EStoveBaseTypeKind_InitializeParam) 으로 생성한 뒤 필요한 필드를 설정하고, 호출이 끝나면 Destroy() 로 해제해요. ShopKey 를 비워두지 않으면 Stove_Initialize() 가 IAP 모듈도 함께 초기화하며, MainWndHandle 을 설정하면 View 모듈(및 ShopKey 가 있으면 IAP 모듈)을 함께 초기화해요. initParam 자체를 null 로 전달하면 SDK 만 초기화해요.

MainWndHandle 은 게임의 메인 윈도우가 실제로 생성된 뒤에만 유효한 값이에요.

Declaration

c
typedef struct IStoveInitializeParam IStoveInitializeParam;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
ShopKeyconst wchar_t*읽기·쓰기Stove_IStoveInitializeParam_GetShopKey() / SetShopKey()IAP 상점 키예요. 값이 비어 있지 않으면 Stove_Initialize() 가 IAP 모듈을 함께 초기화해요. 비워두면 IAP 초기화를 건너뛰어요.
MainWndHandleconst void*읽기·쓰기Stove_IStoveInitializeParam_GetMainWndHandle() / SetMainWndHandle()게임 메인 윈도우 핸들(HWND, const void* 로 전달)이에요. 윈도우가 생성된 뒤에만 유효하며, 값이 있으면 View 모듈(및 ShopKey 가 있으면 IAP 모듈)을 초기화해요. 비워두면 View/IAP 설정을 건너뛰어요.

Memory Management

ItemValue
생성 주체호출자 (Stove_CreateParam(k_EStoveBaseTypeKind_InitializeParam))
해제 책임호출자 (Destroy() 필수): API 호출이 끝난 뒤 해제해요.

Example

c
IStoveInitializeParam* initParam =
    (IStoveInitializeParam*)Stove_CreateParam(k_EStoveBaseTypeKind_InitializeParam);

Stove_IStoveInitializeParam_SetShopKey(initParam, L"YOUR_SHOP_KEY");
Stove_IStoveInitializeParam_SetMainWndHandle(initParam, hWnd);

IStoveResult* result = Stove_Initialize(initParam);

if (Stove_IStoveResult_GetResultCode(result) == k_EStoveCommonResultCode_Success)
{
    // 성공 시 로직을 구현해 주세요.
}
else
{
    // 실패 시 로직을 구현해 주세요.
}

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result);
Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)initParam);

Notes

  • Environment/GameId/AppKey 는 이 타입에 없어요. 현재 인터페이스에서는 IStoveRestartAppIfNecessaryParam 으로 옮겨졌고, SDK 가 Stove_RestartAppIfNecessary() 호출 시 캐시한 값을 Stove_Initialize() 에서 재사용해요.
  • ShopKey, MainWndHandle 은 단일 바이너리 통합 이후 IAP/View 모듈을 함께 초기화하기 위해 추가된 필드예요.
  • Stove_Initialize() 가 일부만 성공(예: SDK/View 는 성공, IAP 는 실패)한 경우 SDK 는 부분 초기화 상태로 남을 수 있어요. 복구하려면 Stove_Uninitialize() 를 호출한 뒤 다시 Stove_Initialize() 를 호출해야 해요.

See Also


IStoveInventoryItem

종류 구조체 · 모듈 IAP · 버전 3.5.0

Description

사용자의 구매 이력 한 건을 나타내요. Stove_FetchInventory 호출 결과로 IStoveInventoryList 에 담겨 OnFetchInventoryCallback 콜백에 전달돼요.

SDK 가 채워서 콜백으로 전달하는 데이터형이에요. 호출자가 직접 만들지 않아요.

콜백으로 전달되는 목록과 각 항목은 SDK 소유이며 콜백 호출이 끝나면 더 이상 유효하지 않아요. Destroy() 를 호출하지 말고, 보관이 필요한 값은 콜백 안에서 복사해 두어야 해요.

Declaration

c
typedef struct IStoveInventoryItem IStoveInventoryItem;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
TxnMasterNoint64_t읽기Stove_IStoveInventoryItem_GetTxnMasterNo()트랜잭션 마스터 번호
TxnDetailNoint64_t읽기Stove_IStoveInventoryItem_GetTxnDetailNo()트랜잭션 상세 번호 (상품별 TID)
ProductIdint64_t읽기Stove_IStoveInventoryItem_GetProductId()플랫폼 고유 상품 식별자
InserviceItemIdconst wchar_t*읽기Stove_IStoveInventoryItem_GetInserviceItemId()이 상품에 매핑된 게임 내 아이템 식별자
ProductNameconst wchar_t*읽기Stove_IStoveInventoryItem_GetProductName()현지화된 상품 이름
Quantityint32_t읽기Stove_IStoveInventoryItem_GetQuantity()구매한 수량
ThumbnailUrlconst wchar_t*읽기Stove_IStoveInventoryItem_GetThumbnailUrl()상품 대표 썸네일 이미지 URL

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK (해제 금지, 콜백이 끝나면 무효)

Example

c
void __cdecl OnFetchInventoryCallback(const IStoveCallbackResult* callbackResult, const IStoveInventoryList* list)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    if (Stove_IStoveResult_GetResultCode(result) == 0)
    {
        uint32_t count = Stove_IStoveInventoryList_GetCount(list);

        for (uint32_t i = 0; i < count; ++i)
        {
            const IStoveInventoryItem* item = Stove_IStoveInventoryList_GetAt(list, i);

            int64_t productId = Stove_IStoveInventoryItem_GetProductId(item);
            int32_t quantity = Stove_IStoveInventoryItem_GetQuantity(item);

            // 필요한 값만 복사해서 보관해 주세요.
        }
        // list 와 각 항목은 이 콜백이 끝나면 무효처리돼요. Destroy() 를 호출하지 마십시오.
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Notes

  • Stove_FetchInventory 의 출력으로만 전달돼요.
  • 게임 아이템 지급 여부 확인 시 TxnDetailNo 를 기준으로 중복 처리를 방지해야 해요.

See Also


IStoveInventoryList

종류 구조체 · 모듈 IAP · 버전 3.5.0

Description

OnFetchInventoryCallback 콜백에 전달되는 컨테이너예요. Stove_FetchInventory 가 돌려주는 IStoveInventoryItem 배열을 감싸요.

SDK 가 채워서 콜백으로 전달하는 데이터형이에요. 호출자가 직접 만들지 않아요.

이 객체와 GetAt() 으로 얻는 각 항목은 모두 SDK 소유이며 콜백 호출이 끝나면 더 이상 유효하지 않아요. Destroy() 를 호출하지 말고, 보관이 필요한 값은 콜백 안에서 복사해 두어야 해요.

Declaration

c
typedef struct IStoveInventoryList IStoveInventoryList;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
Countuint32_t읽기Stove_IStoveInventoryList_GetCount()결과에 담긴 구매 이력 항목 수
At(index)const IStoveInventoryItem*읽기Stove_IStoveInventoryList_GetAt()index(0부터 시작) 위치의 구매 이력 항목. index >= Count 이면 nullptr 을 반환해요.

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK (해제 금지, 콜백이 끝나면 무효)

Example

c
void __cdecl OnFetchInventoryCallback(const IStoveCallbackResult* callbackResult, const IStoveInventoryList* list)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    if (Stove_IStoveResult_GetResultCode(result) == 0)
    {
        uint32_t count = Stove_IStoveInventoryList_GetCount(list);
        for (uint32_t i = 0; i < count; ++i)
        {
            const IStoveInventoryItem* item = Stove_IStoveInventoryList_GetAt(list, i);
            // 필요한 값만 복사해서 보관해 주세요.
        }
        // list 와 각 항목은 이 콜백이 끝나면 무효처리돼요. Destroy() 를 호출하지 마십시오.
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Notes

  • Stove_FetchInventory 의 출력으로만 전달돼요.
  • 예전에는 배열과 개수를 콜백 인자로 각각 따로 받는 방식이었으나, 지금은 이 컨테이너 하나로 감싸 전달돼요.

See Also


IStoveOrderProductParam

종류 구조체 · 모듈 IAP · 버전 3.5.0

Description

IStoveStartPurchaseParam 에 담기는 상품별 주문 항목이에요. 구매할 상품 하나당 하나씩 만들어 SetProducts() 로 전달해요.

Stove_CreateParam(k_EStoveIAPTypeKind_OrderProductParam) 으로 생성하고, setter 로 값을 채운 뒤 구매 호출이 끝나면(또는 상위 IStoveStartPurchaseParam 이 해제된 뒤) Destroy() 로 해제해야 해요.

Declaration

c
typedef struct IStoveOrderProductParam IStoveOrderProductParam;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessRequiredAccessorDescription
ProductIdint64_t읽기·쓰기예Stove_IStoveOrderProductParam_GetProductId() / Stove_IStoveOrderProductParam_SetProductId()플랫폼 고유 상품 식별자. IStoveProduct 의 ProductId 와 일치해야 해요.
SalePricedouble읽기·쓰기예Stove_IStoveOrderProductParam_GetSalePrice() / Stove_IStoveOrderProductParam_SetSalePrice()클라이언트가 관찰한 이 상품의 단가(판매가). 서버가 클라이언트/서버 가격 불일치를 검사하는 데 사용해요.
Quantityint32_t읽기·쓰기예Stove_IStoveOrderProductParam_GetQuantity() / Stove_IStoveOrderProductParam_SetQuantity()구매할 수량

Memory Management

ItemValue
생성 주체호출자 (Stove_CreateParam(k_EStoveIAPTypeKind_OrderProductParam))
해제 책임호출자 (Destroy() 필수)

Example

c
IStoveOrderProductParam* orderProduct = (IStoveOrderProductParam*)Stove_CreateParam(k_EStoveIAPTypeKind_OrderProductParam);

Stove_IStoveOrderProductParam_SetProductId(orderProduct, productId);
Stove_IStoveOrderProductParam_SetSalePrice(orderProduct, salePrice);
Stove_IStoveOrderProductParam_SetQuantity(orderProduct, 1);

IStoveOrderProductParam* orderProducts[] = { orderProduct };

// startPurchaseParam 은 IStoveStartPurchaseParam 문서를 참고해 미리 생성해 주세요.
Stove_IStoveStartPurchaseParam_SetProducts(startPurchaseParam, orderProducts, 1);

Stove_StartPurchase(startPurchaseParam, OnStartPurchaseCallback, NULL, NULL, NULL);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)orderProduct);

Mapping from IStoveProduct

Stove_FetchProducts 콜백으로 받는 IStoveProduct 와 이 타입은 서로 달라서 상품을 그대로 넘길 수 없고, 아래 세 값을 옮겨 담아요.

이 타입가져올 값비고
SetProductId()IStoveProduct::GetProductId()그대로 옮겨요.
SetSalePrice()IStoveProduct::GetSalePrice()결제용 판매가예요. GetPrice()(정가)나 GetDisplaySalePrice()(전시용)를 넣지 않아요.
SetQuantity()이용자가 고른 구매 수량IStoveProduct::GetQuantity() 는 1회 구매 시 지급되는 아이템 수량이라 구매 수량이 아니에요.

콜백으로 받은 목록과 각 상품은 SDK 소유라 콜백이 끝나면 쓸 수 없어요. 구매에 필요한 상품 아이디와 판매가를 콜백 안에서 복사해 두었다가, 구매 시점에 이 타입을 만들어 채워요.

c
// 조회 콜백에서 복사해 두는 값
typedef struct { int64_t productId; double salePrice; } ShopItem;

void __cdecl OnFetchProductsFinished(const IStoveCallbackResult* callbackResult, const IStoveProductList* list)
{
    if (!Stove_IStoveResult_IsSuccessful(Stove_IStoveCallbackResult_GetResult(callbackResult)))
        return;

    uint32_t count = Stove_IStoveProductList_GetCount(list);
    for (uint32_t i = 0; i < count; ++i)
    {
        const IStoveProduct* product = Stove_IStoveProductList_GetAt(list, i);
        ShopItem item;
        item.productId = Stove_IStoveProduct_GetProductId(product);
        item.salePrice = Stove_IStoveProduct_GetSalePrice(product);
        // item 을 게임의 상점 모델에 보관해 주세요.
    }
}

// 구매 시점 — 보관해 둔 값과 이용자가 고른 수량으로 채운다
IStoveOrderProductParam* orderProduct = (IStoveOrderProductParam*)Stove_CreateParam(k_EStoveIAPTypeKind_OrderProductParam);
Stove_IStoveOrderProductParam_SetProductId(orderProduct, item.productId);
Stove_IStoveOrderProductParam_SetSalePrice(orderProduct, item.salePrice);
Stove_IStoveOrderProductParam_SetQuantity(orderProduct, count);   // IStoveProduct 의 Quantity 가 아니라 구매 수량

Notes

  • SetProducts() 는 소유권을 넘겨받지 않아요. 호출자가 IStoveOrderProductParam 객체의 소유권을 계속 가지며, 구매 호출이 끝난 뒤 직접 Destroy() 해야 해요.
  • SalePrice 는 IStoveProduct 의 SalePrice 값을 그대로 사용해 주세요. 값이 다르면 서버에서 가격 불일치로 처리될 수 있어요.
  • Quantity 는 이용자가 고른 구매 수량이에요. IStoveProduct 의 Quantity(1회 구매 시 지급 수량)를 복사하지 마세요.

See Also


IStoveOverImmersionInfo

종류 구조체 · 모듈 Base · 버전 3.5.0

Description

Stove_OverImmersionNotification() 콜백으로 전달되는 과몰입 방지 고지 정보예요. 한국 전용 API 예요.

과몰입 경고 메시지와 게임 누적 이용 시간(시간 단위), 메시지 노출 시간을 담아요. SDK 가 만들어 콜백 인자로만 전달하며, 호출자는 해제하지 않아요.

이 콜백은 1회성이 아니라 대상 사용자에게 매시간 반복해서 전달돼요. 알림을 화면에 띄울 수 있는 시점 이후에 등록해야 해요.

Declaration

c
typedef struct IStoveOverImmersionInfo IStoveOverImmersionInfo;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
Msgconst wchar_t*읽기Stove_IStoveOverImmersionInfo_GetMsg()과몰입 경고 메시지예요.
ElapsedHoursint32_t읽기Stove_IStoveOverImmersionInfo_GetElapsedHours()게임 누적 이용 시간(시간 단위)예요.
ExposureTimeint32_t읽기Stove_IStoveOverImmersionInfo_GetExposureTime()메시지 노출 시간(초)예요.

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK: 콜백 인자로만 전달되며 콜백이 끝나면 무효처리돼요. 호출자는 Destroy() 를 호출하지 않아요.

Example

c
void __cdecl OnOverImmersionNotificationCallback(const IStoveCallbackResult* callbackResult, const IStoveOverImmersionInfo* overImmersion)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    if (Stove_IStoveResult_GetResultCode(result) == k_EStoveCommonResultCode_Success)
    {
        const wchar_t* msg = Stove_IStoveOverImmersionInfo_GetMsg(overImmersion);
        int32_t elapsedHours = Stove_IStoveOverImmersionInfo_GetElapsedHours(overImmersion);
        // 성공 시 로직을 구현해 주세요. (경고 메시지 표시)
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }

    // overImmersion 은 Destroy() 를 호출하지 않아요.
}

Notes

  • 한국 전용 API 예요. 콜백은 1회성이 아니라 대상 사용자에게 매시간 반복해서 전달되므로, 알림을 화면에 띄울 수 있는 시점 이후에 등록해야 해요.
  • ElapsedHours 단위는 시간(hour)이에요. 분 단위인 IStoveVietnamOverimmersionInfo 의 ElapsedMinutes 와 혼동하지 않도록 주의해요.

See Also


IStoveOwnership

종류 구조체 · 모듈 Ownership · 버전 3.5.0

Description

로그인한 사용자의 소유권 항목(기본 게임, DLC, 데모 등) 하나를 나타내요. Stove_FetchOwnerships 가 OnOwnershipListCallback 에 IStoveOwnershipList 로 묶어 전달해요. 레거시 이름은 StovePCOwnership 이에요.

호출자가 만들지 않으며, 읽기 전용이고 설정자가 없어요. 콜백 인자로만 전달되고 콜백이 끝나면 무효처리돼요.

콜백 밖에서 값을 써야 한다면 콜백 안에서 필드 값을 별도 변수에 복사해 두어야 해요. 객체 자체를 보관해서는 안 돼요.

Declaration

c
typedef struct IStoveOwnership IStoveOwnership;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
GameIdconst wchar_t*읽기Stove_IStoveOwnership_GetGameId()이 소유권 항목에 연결된 STOVE 게임 ID예요.
GameCodeint32_t읽기Stove_IStoveOwnership_GetGameCode()항목의 상품 분류예요. EStoveOwnershipGameCode (Basic / Demo / Dlc 등)
OwnershipCodeint32_t읽기Stove_IStoveOwnership_GetOwnershipCode()항목의 소유 상태예요. EStoveOwnershipCode (Acquire / Lose / None)
PurchaseDateuint64_t읽기Stove_IStoveOwnership_GetPurchaseDate()항목의 구매 시각이에요. UTC 밀리초 단위 Unix epoch 로 표현되며, 서버 값을 그대로 전달해요.

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK (해제 금지): OnOwnershipListCallback 콜백이 끝나면 무효처리돼요.

Example

c
void __cdecl OnOwnershipList(const IStoveCallbackResult* callbackResult, const IStoveOwnershipList* ownerships)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);
    if (Stove_IStoveResult_GetResultCode(result) == 0)
    {
        uint32_t count = Stove_IStoveOwnershipList_GetCount(ownerships);
        for (uint32_t i = 0; i < count; ++i)
        {
            const IStoveOwnership* ownership = Stove_IStoveOwnershipList_GetAt(ownerships, i);

            const wchar_t* gameId = Stove_IStoveOwnership_GetGameId(ownership);
            int32_t gameCode = Stove_IStoveOwnership_GetGameCode(ownership);
            int32_t ownershipCode = Stove_IStoveOwnership_GetOwnershipCode(ownership);
            uint64_t purchaseDate = Stove_IStoveOwnership_GetPurchaseDate(ownership);

            // 콜백이 끝나기 전에 필요한 값을 복사해 두는 로직을 구현해 주세요.
        }
    }
}

Notes

  • 레거시 이름은 StovePCOwnership 이에요.
  • Stove_FetchOwnerships 의 콜백으로만 전달되는 출력 데이터예요.
  • PurchaseDate 는 UTC 밀리초 Unix epoch 로 제공되며, 구 인터페이스(StovePCOwnership)의 purchaseDate 도 동일한 서버 값을 동일한 형식으로 반환하므로 값을 다시 계산할 필요가 없어요.

See Also


IStoveOwnershipList

종류 구조체 · 모듈 Ownership · 버전 3.5.0

Description

Stove_FetchOwnerships 의 OnOwnershipListCallback 으로 전달되는 IStoveOwnership 목록 래퍼예요.

호출자가 만들지 않으며, 콜백 인자로만 전달돼요. Destroy() 를 호출하지 않아요.

이 목록 객체와 GetAt() 이 돌려주는 각 IStoveOwnership* 은 콜백이 끝나면 모두 무효처리돼요. 콜백 밖에서 필요한 값은 콜백 안에서 미리 복사해 두어야 해요.

Declaration

c
typedef struct IStoveOwnershipList IStoveOwnershipList;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
Countuint32_t읽기Stove_IStoveOwnershipList_GetCount()목록에 담긴 소유권 항목의 총 개수예요.
At[index]const IStoveOwnership*읽기Stove_IStoveOwnershipList_GetAt(index)index 번째 소유권 항목을 돌려줘요. index 가 범위를 벗어나면 nullptr 을 돌려줘요.

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK (해제 금지): OnOwnershipListCallback 콜백이 끝나면 목록과 GetAt() 이 돌려준 각 항목이 모두 무효처리돼요.

Example

c
void __cdecl OnOwnershipList(const IStoveCallbackResult* callbackResult, const IStoveOwnershipList* ownerships)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);
    if (Stove_IStoveResult_GetResultCode(result) == 0)
    {
        uint32_t count = Stove_IStoveOwnershipList_GetCount(ownerships);
        for (uint32_t i = 0; i < count; ++i)
        {
            const IStoveOwnership* ownership = Stove_IStoveOwnershipList_GetAt(ownerships, i);
            if (ownership == nullptr)
            {
                continue;
            }

            // 항목별 로직을 구현해 주세요.
        }
    }
}

Notes

  • Stove_FetchOwnerships 의 콜백으로만 전달되는 출력 데이터예요.
  • 배열 + 개수 방식의 out-parameter 가 아니라, GetCount() / GetAt() 을 갖춘 SDK 소유 목록 래퍼 타입이에요.

See Also


IStoveProduct

종류 구조체 · 모듈 IAP · 버전 3.5.0

Description

상점에서 판매하는 상품 하나를 나타내요. Stove_FetchProducts 호출 결과로 IStoveProductList 에 담겨 OnFetchProductsCallback 콜백에 전달돼요.

SDK 가 채워서 콜백으로 전달하는 데이터형이에요. 호출자가 직접 만들지 않아요. 멤버가 32개로 많아 아래 멤버 표를 성격별로 나누어 정리했어요.

콜백으로 전달되는 목록과 각 항목은 SDK 소유이며 콜백 호출이 끝나면 더 이상 유효하지 않아요. Destroy() 를 호출하지 말고, 보관이 필요한 값은 콜백 안에서 복사해 두어야 해요.

Declaration

c
typedef struct IStoveProduct IStoveProduct;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

기본 정보

NameTypeAccessAccessorDescription
ProductIdint64_t읽기Stove_IStoveProduct_GetProductId()플랫폼 고유 상품 식별자
InserviceItemIdconst wchar_t*읽기Stove_IStoveProduct_GetInserviceItemId()이 상품에 매핑된 게임 내 아이템 식별자
ProductNameconst wchar_t*읽기Stove_IStoveProduct_GetProductName()현지화된 상품 이름
ProductDescriptionconst wchar_t*읽기Stove_IStoveProduct_GetProductDescription()현지화된 상품 설명
Quantityint32_t읽기Stove_IStoveProduct_GetQuantity()이 상품 1회 구매 시 지급되는 아이템 수량
ProductTypeCodeEStoveProductTypeCode읽기Stove_IStoveProduct_GetProductTypeCode()상품 분류 코드
CategoryIdconst wchar_t*읽기Stove_IStoveProduct_GetCategoryId()이 상품이 속한 상점 카테고리 식별자
CategoryNameconst wchar_t*읽기Stove_IStoveProduct_GetCategoryName()이 상품이 속한 상점 카테고리의 현지화된 이름
ThumbnailUrlconst wchar_t*읽기Stove_IStoveProduct_GetThumbnailUrl()상품 대표 썸네일 이미지 URL

가격

NameTypeAccessAccessorDescription
CurrencyCodeconst wchar_t*읽기Stove_IStoveProduct_GetCurrencyCode()ISO 4217 통화 코드 (예: L"USD", L"KRW")
Pricedouble읽기Stove_IStoveProduct_GetPrice()결제 처리에 사용되는 정가
DisplayPricedouble읽기Stove_IStoveProduct_GetDisplayPrice()화면 표시에 사용되는 정가 (반올림 등으로 Price 와 다를 수 있음)
StrDisplayPriceconst wchar_t*읽기Stove_IStoveProduct_GetStrDisplayPrice()통화 서식이 적용된 표시용 정가 문자열
SalePricedouble읽기Stove_IStoveProduct_GetSalePrice()결제 처리에 사용되는 판매가 (할인 중이 아니면 Price 와 동일)
DisplaySalePricedouble읽기Stove_IStoveProduct_GetDisplaySalePrice()화면 표시에 사용되는 판매가
StrDisplaySalePriceconst wchar_t*읽기Stove_IStoveProduct_GetStrDisplaySalePrice()통화 서식이 적용된 표시용 판매가 문자열

할인

NameTypeAccessAccessorDescription
IsDiscountedbool읽기Stove_IStoveProduct_IsDiscounted()현재 할인 중인지 여부
DiscountTypeEStoveDiscountType읽기Stove_IStoveProduct_GetDiscountType()할인 계산 방식
DiscountTypeValueint32_t읽기Stove_IStoveProduct_GetDiscountTypeValue()할인 값. DiscountType 이 FixedRate 이면 퍼센트(예: 10 = 10% 할인), FlatRate 이면 상품 통화 기준 정액 할인액
DiscountStartDateint64_t읽기Stove_IStoveProduct_GetDiscountStartDate()할인 시작 시각 (UTC epoch milliseconds)
DiscountEndDateint64_t읽기Stove_IStoveProduct_GetDiscountEndDate()할인 종료 시각 (UTC epoch milliseconds)

구매 수량 및 이력

NameTypeAccessAccessorDescription
TotalQuantityint32_t읽기Stove_IStoveProduct_GetTotalQuantity()모든 범위를 통틀어 이 상품이 구매된 총수량
MemberQuantityint32_t읽기Stove_IStoveProduct_GetMemberQuantity()로그인 계정(회원) 범위에서 구매된 수량
GuidQuantityint32_t읽기Stove_IStoveProduct_GetGuidQuantity()현재 캐릭터 GUID 범위에서 구매된 수량
HasPurchasedbool읽기Stove_IStoveProduct_HasPurchased()사용자가 이 상품을 한 번이라도 구매한 적이 있는지 여부
IsWithdrawablebool읽기Stove_IStoveProduct_IsWithdrawable()청약철회(소비자 보호 환불) 규정이 적용되는 상품인지 여부

구매 제한 및 판매 기간

NameTypeAccessAccessorDescription
PurchaseLimitTypeCodeEStovePurchaseLimitTypeCode읽기Stove_IStoveProduct_GetPurchaseLimitTypeCode()구매 제한 정책
PurchaseLimitCountint32_t읽기Stove_IStoveProduct_GetPurchaseLimitCount()현재 정책 하의 구매 횟수 제한
SaleLimitCountint32_t읽기Stove_IStoveProduct_GetSaleLimitCount()상품의 총 판매 수량 제한 (0 이면 무제한)
SalesStartDateint64_t읽기Stove_IStoveProduct_GetSalesStartDate()판매 기간 시작 시각 (UTC epoch milliseconds)
SalesEndDateint64_t읽기Stove_IStoveProduct_GetSalesEndDate()판매 기간 종료 시각 (UTC epoch milliseconds)
PurchaseAvailabilityCodeint16_t읽기Stove_IStoveProduct_GetPurchaseAvailabilityCode()구매 가능 여부 코드. 1: 구매 가능, 2: 구매 불가능(구매 제한 초과), 3: 구매 불가능(웹 스토어 품절), 4: 구매 불가능(웹 스토어에서 이미 수령함). 이 값 집합은 서버에서 확장될 수 있어요. 상품 1개 단위 구매 요청 기준이며, 2개 이상을 함께 구매 요청하면 결과가 다를 수 있어요. 서버 API 스키마가 이 필드(및 다른 code 필드들)를 Int16 으로 정의해서 타입이 int16_t 이에요.

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK (해제 금지, 콜백이 끝나면 무효)

Example

c
void __cdecl OnFetchProductsCallback(const IStoveCallbackResult* callbackResult, const IStoveProductList* list)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    if (Stove_IStoveResult_GetResultCode(result) == 0)
    {
        uint32_t count = Stove_IStoveProductList_GetCount(list);

        for (uint32_t i = 0; i < count; ++i)
        {
            const IStoveProduct* product = Stove_IStoveProductList_GetAt(list, i);

            int64_t productId = Stove_IStoveProduct_GetProductId(product);
            const wchar_t* productName = Stove_IStoveProduct_GetProductName(product);
            double salePrice = Stove_IStoveProduct_GetSalePrice(product);
            bool onSale = Stove_IStoveProduct_IsDiscounted(product);

            // 필요한 값만 복사해서 보관해 주세요.
        }
        // list 와 각 항목은 이 콜백이 끝나면 무효처리돼요. Destroy() 를 호출하지 마십시오.
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Notes

  • Stove_FetchProducts 의 출력으로만 전달돼요.
  • Price / SalePrice 는 결제 처리(서버 검증)에 사용하고, DisplayPrice / DisplaySalePrice / StrDisplayPrice / StrDisplaySalePrice 는 화면 표시에만 사용해 주세요.
  • 구매 시 서버가 관찰한 가격과의 불일치를 검사하므로, IStoveOrderProductParam 의 SalePrice 에는 이 상품의 SalePrice 값을 그대로 전달해야 해요.
  • DiscountStartDate / DiscountEndDate / SalesStartDate / SalesEndDate 는 모두 UTC epoch milliseconds(1970-01-01 UTC 기준 밀리초) 정수예요. YYYYMMDDHHMMSS 형식이 아니에요.
  • 구매 파라미터로 옮기는 방법은 IStoveOrderProductParam 의 Mapping from IStoveProduct 를 참고하세요. Quantity 는 1회 구매 시 지급 수량이라 구매 수량으로 복사하지 마세요.

See Also


IStoveProductList

종류 구조체 · 모듈 IAP · 버전 3.5.0

Description

OnFetchProductsCallback 콜백에 전달되는 컨테이너예요. Stove_FetchProducts 가 돌려주는 IStoveProduct 배열을 감싸요.

SDK 가 채워서 콜백으로 전달하는 데이터형이에요. 호출자가 직접 만들지 않아요.

이 객체와 GetAt() 으로 얻는 각 항목은 모두 SDK 소유이며 콜백 호출이 끝나면 더 이상 유효하지 않아요. Destroy() 를 호출하지 말고, 보관이 필요한 값은 콜백 안에서 복사해 두어야 해요.

Declaration

c
typedef struct IStoveProductList IStoveProductList;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
Countuint32_t읽기Stove_IStoveProductList_GetCount()결과에 담긴 상품 수
At(index)const IStoveProduct*읽기Stove_IStoveProductList_GetAt()index(0부터 시작) 위치의 상품. index >= Count 이면 nullptr 을 반환해요.

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK (해제 금지, 콜백이 끝나면 무효)

Example

c
void __cdecl OnFetchProductsCallback(const IStoveCallbackResult* callbackResult, const IStoveProductList* list)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    if (Stove_IStoveResult_GetResultCode(result) == 0)
    {
        uint32_t count = Stove_IStoveProductList_GetCount(list);
        for (uint32_t i = 0; i < count; ++i)
        {
            const IStoveProduct* product = Stove_IStoveProductList_GetAt(list, i);
            // 필요한 값만 복사해서 보관해 주세요.
        }
        // list 와 각 항목은 이 콜백이 끝나면 무효처리돼요. Destroy() 를 호출하지 마십시오.
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Notes

  • Stove_FetchProducts 의 출력으로만 전달돼요.
  • 예전에는 배열과 개수를 콜백 인자로 각각 따로 받는 방식이었으나, 지금은 이 컨테이너 하나로 감싸 전달돼요.

See Also


IStovePurchasedProduct

종류 구조체 · 모듈 IAP · 버전 3.5.0

Description

완료된 구매(트랜잭션) 안의 상품 한 항목을 나타내요. Stove_StartPurchase 의 결과인 IStoveStartPurchaseOutcome 과 Stove_ConfirmPurchase 의 결과인 IStoveConfirmPurchaseOutcome 양쪽에 배열 형태로 담겨 전달돼요.

SDK 가 채워서 콜백으로 전달하는 데이터형이에요. 호출자가 직접 만들지 않아요.

콜백으로 전달되는 배열과 각 항목은 SDK 소유이며 콜백 호출이 끝나면 더 이상 유효하지 않아요. Destroy() 를 호출하지 말고, 보관이 필요한 값은 콜백 안에서 복사해 두어야 해요.

Declaration

c
typedef struct IStovePurchasedProduct IStovePurchasedProduct;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
TxnDetailNoint64_t읽기Stove_IStovePurchasedProduct_GetTxnDetailNo()트랜잭션 상세 번호 (마스터 트랜잭션 내 상품별 TID)
ProductIdint64_t읽기Stove_IStovePurchasedProduct_GetProductId()플랫폼 고유 상품 식별자
CategoryIdconst wchar_t*읽기Stove_IStovePurchasedProduct_GetCategoryId()이 상품이 속한 상점 카테고리 식별자
TotalQuantityint32_t읽기Stove_IStovePurchasedProduct_GetTotalQuantity()이 상품의 총 구매 수량
MemberQuantityint32_t읽기Stove_IStovePurchasedProduct_GetMemberQuantity()회원(계정) 범위에서 구매된 수량
GuidQuantityint32_t읽기Stove_IStovePurchasedProduct_GetGuidQuantity()현재 캐릭터 GUID 범위에서 구매된 수량

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK (해제 금지, 콜백이 끝나면 무효)

Example

c
void __cdecl OnConfirmPurchaseCallback(const IStoveCallbackResult* callbackResult, const IStoveConfirmPurchaseOutcome* outcome)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    // 스팀런처 동선은 IsConfirmed 가 항상 false 로 오므로 판정은 Stove_ConfirmPurchase 예제의 공통 판정을 따라 주세요.
    if (Stove_IStoveResult_GetResultCode(result) == 0 && Stove_IStoveConfirmPurchaseOutcome_IsConfirmed(outcome))
    {
        uint32_t count = Stove_IStoveConfirmPurchaseOutcome_GetPurchasedProductCount(outcome);

        for (uint32_t i = 0; i < count; ++i)
        {
            const IStovePurchasedProduct* purchasedProduct = Stove_IStoveConfirmPurchaseOutcome_GetPurchasedProductAt(outcome, i);

            int64_t productId = Stove_IStovePurchasedProduct_GetProductId(purchasedProduct);
            int32_t totalQuantity = Stove_IStovePurchasedProduct_GetTotalQuantity(purchasedProduct);

            // 필요한 값만 복사해서 보관해 주세요.
        }
        // outcome 과 그 안의 항목은 이 콜백이 끝나면 무효처리돼요. Destroy() 를 호출하지 마십시오.
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Notes

See Also


IStovePurchaseParam

종류 구조체 · 모듈 IAP · 버전 3.5.0

Description

IStoveStartPurchaseParam 에 담겨 Stove_StartPurchase 의 동작 방식을 결정하는 옵션이에요. IStoveWebViewLayoutParam 을 상속하며, WebView* 필드는 모두 Operation 이 Default 가 아닐 때만 적용돼요.

Stove_CreateParam(k_EStoveIAPTypeKind_PurchaseParam) 으로 생성하고, setter 로 값을 채운 뒤 구매 호출이 끝나면 Destroy() 로 해제해야 해요.

Declaration

c
typedef struct IStovePurchaseParam IStovePurchaseParam;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessRequiredAccessorDescription
OperationEStovePurchaseOperation읽기·쓰기예Stove_IStovePurchaseParam_GetOperation() / Stove_IStovePurchaseParam_SetOperation()동작 방식 선택자
WebViewModeEStoveWebViewMode읽기·쓰기아니오Stove_IStovePurchaseParam_GetWebViewMode() / Stove_IStovePurchaseParam_SetWebViewMode()웹뷰 표시 모드 (외부 브라우저 / SDK 내장 웹뷰). Operation != Default 일 때만 적용돼요. IStoveWebViewLayoutParam 상속 멤버예요.
WebViewPosXint32_t읽기·쓰기아니오Stove_IStovePurchaseParam_GetWebViewPosX() / Stove_IStovePurchaseParam_SetWebViewPosX()웹뷰 x 좌표 (픽셀). Operation != Default 일 때만 적용돼요. IStoveWebViewLayoutParam 상속 멤버예요.
WebViewPosYint32_t읽기·쓰기아니오Stove_IStovePurchaseParam_GetWebViewPosY() / Stove_IStovePurchaseParam_SetWebViewPosY()웹뷰 y 좌표 (픽셀). Operation != Default 일 때만 적용돼요. IStoveWebViewLayoutParam 상속 멤버예요.
WebViewWidthint32_t읽기·쓰기아니오Stove_IStovePurchaseParam_GetWebViewWidth() / Stove_IStovePurchaseParam_SetWebViewWidth()웹뷰 너비 (픽셀). Operation != Default 일 때만 적용돼요. IStoveWebViewLayoutParam 상속 멤버예요.
WebViewHeightint32_t읽기·쓰기아니오Stove_IStovePurchaseParam_GetWebViewHeight() / Stove_IStovePurchaseParam_SetWebViewHeight()웹뷰 높이 (픽셀). Operation != Default 일 때만 적용돼요. IStoveWebViewLayoutParam 상속 멤버예요.

Memory Management

ItemValue
생성 주체호출자 (Stove_CreateParam(k_EStoveIAPTypeKind_PurchaseParam))
해제 책임호출자 (Destroy() 필수)

Example

c
IStovePurchaseParam* purchaseParam = (IStovePurchaseParam*)Stove_CreateParam(k_EStoveIAPTypeKind_PurchaseParam);

Stove_IStovePurchaseParam_SetOperation(purchaseParam, k_EStovePurchaseOperation_WithWebViewAndConfirmResult);
Stove_IStovePurchaseParam_SetWebViewMode(purchaseParam, k_EStoveWebViewMode_Internal);
Stove_IStovePurchaseParam_SetWebViewWidth(purchaseParam, 480);
Stove_IStovePurchaseParam_SetWebViewHeight(purchaseParam, 640);

// startPurchaseParam 은 IStoveStartPurchaseParam 문서를 참고해 미리 생성해 주세요.
Stove_IStoveStartPurchaseParam_SetPurchaseParam(startPurchaseParam, purchaseParam);

Stove_StartPurchase(startPurchaseParam, OnStartPurchaseCallback, NULL, NULL, NULL);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)purchaseParam);

Notes

  • SetPurchaseParam() 은 소유권을 넘겨받지 않아요. 호출자가 이 객체의 소유권을 계속 가지며, 구매 호출이 끝난 뒤 직접 Destroy() 해야 해요.
  • Operation 이 Default 이면 WebView* 필드는 무시돼요.

See Also


IStoveRank

종류 구조체 · 모듈 GameSupport · 버전 3.5.0

Description

IStoveRank 는 리더보드의 순위 항목 하나를 담는 타입이에요. Stove_FetchRanking 의 조회 결과인 IStoveRanking 안에서 GetAt(index) 로 각 항목을 얻어요.

이 타입은 SDK 가 만들어 콜백을 통해 전달하며, 호출자가 직접 생성하지 않아요.

Declaration

c
typedef struct IStoveRank IStoveRank;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
Nicknameconst wchar_t*읽기Stove_IStoveRank_GetNickname()사용자 닉네임이에요.
ProfileImageconst wchar_t*읽기Stove_IStoveRank_GetProfileImage()사용자 프로필 이미지 URL 이에요.
Scoreint32_t읽기Stove_IStoveRank_GetScore()리더보드 점수예요.
Rankuint32_t읽기Stove_IStoveRank_GetRank()사용자의 현재 순위예요.

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK (해제 금지. 이 객체를 담고 있는 IStoveRanking 콜백 인자가 무효처리되면 함께 무효처리돼요)

Example

c
void OnGetRankingFinished(const IStoveCallbackResult* callbackResult, const IStoveRanking* ranking)
{
    if (Stove_IStoveResult_GetResultCode(Stove_IStoveCallbackResult_GetResult(callbackResult)) == 0 && ranking != NULL)
    {
        uint32_t count = Stove_IStoveRanking_GetCount(ranking);
        for (uint32_t i = 0; i < count; i++)
        {
            const IStoveRank* rank = Stove_IStoveRanking_GetAt(ranking, i);
            const wchar_t* nickname = Stove_IStoveRank_GetNickname(rank);
            uint32_t place = Stove_IStoveRank_GetRank(rank);

            // 성공 시 로직을 구현해 주세요.
        }
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Notes

  • 호출자가 직접 생성하지 않으며, IStoveRanking 을 통해서만 얻을 수 있어요.
  • "Ranking" 은 리더보드 전체를, "Rank" 는 그 안의 순위 항목 하나를 가리켜요.

See Also


IStoveRanking

종류 구조체 · 모듈 GameSupport · 버전 3.5.0

Description

IStoveRanking 은 OnGetRankingCallback 으로 전달되는, 페이지 단위 리더보드를 감싸는 컨테이너 타입이에요. Stove_FetchRanking 의 onFinished 콜백 인자로 전달돼요.

"Ranking" 은 리더보드 전체를, "Rank" 는 그 안의 순위 항목 하나를 가리켜요. 이 타입은 SDK 가 만들어 콜백을 통해 전달하며, 호출자가 직접 생성하지 않아요.

Declaration

c
typedef struct IStoveRanking IStoveRanking;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
Countuint32_t읽기Stove_IStoveRanking_GetCount()이번 페이지에 담긴 순위 항목 개수예요.
-const IStoveRank*읽기Stove_IStoveRanking_GetAt(index)0 부터 시작하는 인덱스로 순위 항목을 가져와요. index >= Count 이면 NULL 을 반환해요.
TotalCountuint32_t읽기Stove_IStoveRanking_GetTotalCount()페이지 전체를 통틀은 순위 항목 총 개수예요.

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK (해제 금지. Stove_FetchRanking 콜백이 끝나면 무효처리돼요)

Example

c
void OnGetRankingFinished(const IStoveCallbackResult* callbackResult, const IStoveRanking* ranking)
{
    if (Stove_IStoveResult_GetResultCode(Stove_IStoveCallbackResult_GetResult(callbackResult)) == 0 && ranking != NULL)
    {
        uint32_t count = Stove_IStoveRanking_GetCount(ranking);
        uint32_t totalCount = Stove_IStoveRanking_GetTotalCount(ranking);

        for (uint32_t i = 0; i < count; i++)
        {
            const IStoveRank* rank = Stove_IStoveRanking_GetAt(ranking, i);
            // 성공 시 로직을 구현해 주세요.
        }
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Notes

  • 호출자가 직접 생성하지 않으며, Stove_FetchRanking 콜백을 통해서만 얻을 수 있어요.
  • 담긴 IStoveRank 항목들도 이 목록과 함께 콜백이 끝나면 무효처리돼요.

See Also


IStoveRestartAppIfNecessaryOutcome

종류 구조체 · 모듈 Base · 버전 3.5.0

Description

Stove_RestartAppIfNecessary() 비동기 호출의 결과를 담아요. requiresRestart 플래그 하나를 도메인 엔티티로 감싸, 향후 필드가 추가되어도 콜백 시그니처가 바뀌지 않도록 설계되어 있어요.

SDK 가 만들어 콜백 인자로만 전달하며, 호출자는 해제하지 않아요.

Declaration

c
typedef struct IStoveRestartAppIfNecessaryOutcome IStoveRestartAppIfNecessaryOutcome;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
IsRestartRequiredbool읽기Stove_IStoveRestartAppIfNecessaryOutcome_IsRestartRequired()true 면 앱을 Stove 런처를 통해 다시 실행해야 해요(현재 프로세스는 종료해야 해요). false 면 계속 진행해도 돼요.

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK: 콜백 인자로만 전달되며 콜백이 끝나면 무효처리돼요. 호출자는 Destroy() 를 호출하지 않아요.

Example

c
void __cdecl OnRestartAppIfNecessaryCallback(const IStoveCallbackResult* callbackResult, const IStoveRestartAppIfNecessaryOutcome* outcome)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    if (Stove_IStoveResult_GetResultCode(result) == k_EStoveCommonResultCode_Success)
    {
        if (Stove_IStoveRestartAppIfNecessaryOutcome_IsRestartRequired(outcome))
        {
            // 앱을 종료하는 로직을 구현해 주세요.
        }
        else
        {
            // 계속 진행하는 로직을 구현해 주세요(Stove_Initialize() 호출 등).
        }
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }

    // outcome 은 Destroy() 를 호출하지 않아요.
}

Notes

  • Stove_RestartAppIfNecessary() 는 Stove_Initialize() 보다 먼저 호출해야 해요.
  • IsRestartRequired() 가 true 인데 프로세스를 종료하지 않으면 이후 SDK 동작이 올바르지 않을 수 있어요.

See Also


IStoveRestartAppIfNecessaryParam

종류 구조체 · 모듈 Base · 버전 3.5.0

Description

Stove_RestartAppIfNecessary() 호출에 필요한 파라미터를 담아요. Stove 환경, 게임 ID, 애플리케이션 키, 플랫폼 이름과 런처 확인 관련 옵션을 포함해요.

Stove_CreateParam(k_EStoveBaseTypeKind_RestartAppIfNecessaryParam) 으로 생성한 뒤 각 필드를 설정하고, 호출이 끝나면 Destroy() 로 해제해요.

Declaration

c
typedef struct IStoveRestartAppIfNecessaryParam IStoveRestartAppIfNecessaryParam;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
Environmentconst wchar_t*읽기·쓰기Stove_IStoveRestartAppIfNecessaryParam_GetEnvironment() / SetEnvironment()Stove 환경 값이에요.
GameIdconst wchar_t*읽기·쓰기Stove_IStoveRestartAppIfNecessaryParam_GetGameId() / SetGameId()Stove 게임 ID 값이에요.
AppKeyconst wchar_t*읽기·쓰기Stove_IStoveRestartAppIfNecessaryParam_GetAppKey() / SetAppKey()Stove 애플리케이션 키 값이에요.
WaitTimeMilliSecuint32_t읽기·쓰기Stove_IStoveRestartAppIfNecessaryParam_GetWaitTimeMilliSec() / SetWaitTimeMilliSec()앱이 런처를 통해 실행되었는지 확인하는 대기 시간(밀리초)예요.
LaunchStoveLauncherbool읽기·쓰기Stove_IStoveRestartAppIfNecessaryParam_GetLaunchStoveLauncher() / SetLaunchStoveLauncher()Stove 런처가 실행 중이 아닐 때 런처를 실행할지 여부예요.
PlatformNameconst wchar_t*읽기·쓰기Stove_IStoveRestartAppIfNecessaryParam_GetPlatformName() / SetPlatformName()플랫폼 이름이에요. 선택 필드이며 스토브 외 플랫폼(Steam 등)과 함께 연동할 때만 지정해요. 설정하지 않으면 빈 문자열이고, 빈 문자열이나 L"Stove" 는 스토브 단독 연동으로 동작해요.

Memory Management

ItemValue
생성 주체호출자 (Stove_CreateParam(k_EStoveBaseTypeKind_RestartAppIfNecessaryParam))
해제 책임호출자 (Destroy() 필수): API 호출이 끝난 뒤 해제해요.

Example

c
IStoveRestartAppIfNecessaryParam* param =
    (IStoveRestartAppIfNecessaryParam*)Stove_CreateParam(k_EStoveBaseTypeKind_RestartAppIfNecessaryParam);

Stove_IStoveRestartAppIfNecessaryParam_SetEnvironment(param, L"real");
Stove_IStoveRestartAppIfNecessaryParam_SetGameId(param, L"YOUR_GAME_ID");
Stove_IStoveRestartAppIfNecessaryParam_SetAppKey(param, L"YOUR_APP_KEY");
Stove_IStoveRestartAppIfNecessaryParam_SetLaunchStoveLauncher(param, true);

Stove_RestartAppIfNecessary(param, OnRestartAppIfNecessaryCallback, NULL);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param);

Notes

  • Stove_RestartAppIfNecessary() 는 Stove_Initialize() 보다 먼저 호출해야 해요. SDK 는 이 호출로 캐시한 Environment/GameId/AppKey 를 이후의 Stove_Initialize() 에서도 재사용해요.
  • 과거 인터페이스에서는 Environment/GameId/AppKey 가 IStoveInitializeParam 에 있었으나, 현재 인터페이스에서는 이 타입으로 옮겨졌어요. IStoveInitializeParam 에는 더 이상 이 필드들이 없어요.
  • PlatformName 은 런처와 통신할 IPC 경로를 정하는 데 쓰예요. 값을 비워 두거나 L"Stove" 를 지정하면 기존과 같은 경로를 사용해요. 런처가 지원하지 않는 임의의 값을 넣으면 경로가 달라져 k_EStoveResultCode_IpcConnectFailed(307) 또는 k_EStoveResultCode_IpcTimeout(309) 이 발생하므로, 스토브 외 플랫폼 연동 계획이 없다면 설정하지 않아요.

See Also


IStoveResult

종류 구조체 · 모듈 Base · 버전 3.5.0

Description

동기 API 호출의 결과를 담아요. 결과를 생성한 API 를 식별하는 메서드 코드와 결과 코드를 포함해요.

Stove_Initialize(), Stove_GetUser() 등 대부분의 동기 API 가 이 타입을 반환값으로 돌려줘요. 반환된 객체는 사용 후 Destroy() 로 해제해야 해요.

Declaration

c
typedef struct IStoveResult IStoveResult;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
MethodCodeuint32_t읽기Stove_IStoveResult_GetMethodCode()이 결과를 생성한 API 를 식별하는 전역 고유 메서드 코드예요. 모듈을 1000 단위 블록으로 인코딩해요(모듈별 EStove<Module>MethodCode 참조).
ResultCodeuint32_t읽기Stove_IStoveResult_GetResultCode()결과 코드예요. 0(Success)이면 성공, 0이 아니면 실패예요. 공통 코드는 EStoveCommonResultCode(0 ~ 299), 모듈별 코드는 EStoveResultCode(300~)예요.
IsSuccessfulbool읽기Stove_IStoveResult_IsSuccessful()성공 여부예요(ResultCode 가 0인지와 동일한 판정).

Memory Management

ItemValue
생성 주체SDK (동기 API 호출의 반환값)
해제 책임호출자 (Destroy() 필수)

Example

c
IStoveResult* result = Stove_Uninitialize();

if (Stove_IStoveResult_GetResultCode(result) == k_EStoveCommonResultCode_Success)
{
    // 성공 시 로직을 구현해 주세요.
}
else
{
    // 실패 시 로직을 구현해 주세요.
}

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result);

Notes

  • 콜백이 아닌 동기 API(Stove_Initialize, Stove_GetUser 등)의 반환값으로 쓰예요. 비동기 API 의 콜백 결과는 IStoveCallbackResult 를 통해 전달돼요.
  • 결과 코드는 EStoveCommonResultCode(공통, 0 ~ 299) 또는 EStoveResultCode(모듈별, 300~) 값이에요. 과거의 모듈별 EStoveBaseResultCode 는 없어졌고 EStoveResultCode 로 통합되었어요.
  • flat C 접근 함수에는 Stove_IStoveResult_IsSuccessful() 이 있어 GetResultCode() == 0 판정과 동일한 결과를 즉시 얻을 수 있어요.

See Also


IStoveSendLogParam

종류 구조체 · 모듈 Log · 버전 3.5.0

Description

Stove_SendLog 의 입력 파라미터예요. Stove_CreateParam(k_EStoveLogTypeKind_SendLogParam) 으로 생성한 뒤, 아래 멤버 표의 Setter 로 값을 채우고 호출이 끝나면 해제해요.

값을 모르는 항목은 채우지 않아도 돼요. 숫자 필드는 기본값 0, 문자열 필드는 빈 값/nullptr 로 남아요.

게임이 채워야 하는 값은 이 구조체에 노출된 필드뿐이에요. 디바이스 정보, GDS 정보, 세션 ID, 타임스탬프, 게임 ID·환경 등 나머지 항목은 SDK 가 자동으로 채워 함께 전송해요.

Declaration

c
typedef struct IStoveSendLogParam IStoveSendLogParam;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
Auidint64_t읽기·쓰기Stove_IStoveSendLogParam_GetAuid() / SetAuid()계정 UID(STOVE 계정 식별자)예요.
Cuidint64_t읽기·쓰기Stove_IStoveSendLogParam_GetCuid() / SetCuid()캐릭터 UID(게임 내 캐릭터 식별자)예요.
MktType1const wchar_t*읽기·쓰기Stove_IStoveSendLogParam_GetMktType1() / SetMktType1()연동된 3rd-party 마케팅 서비스 이름(슬롯 1)이에요.
MktId1const wchar_t*읽기·쓰기Stove_IStoveSendLogParam_GetMktId1() / SetMktId1()슬롯 1 마케팅 서비스가 발급한 식별자(캠페인/리퍼러 ID)예요.
MktType2const wchar_t*읽기·쓰기Stove_IStoveSendLogParam_GetMktType2() / SetMktType2()연동된 3rd-party 마케팅 서비스 이름(슬롯 2)예요.
MktId2const wchar_t*읽기·쓰기Stove_IStoveSendLogParam_GetMktId2() / SetMktId2()슬롯 2 마케팅 서비스가 발급한 식별자예요.
GameVersionconst wchar_t*읽기·쓰기Stove_IStoveSendLogParam_GetGameVersion() / SetGameVersion()게임 클라이언트 버전 문자열이에요 (예: L"1.2.3").
LogGroupIdconst wchar_t*읽기·쓰기Stove_IStoveSendLogParam_GetLogGroupId() / SetLogGroupId()서로 연관된 로그 항목 여러 개를 하나의 집합으로 묶는 상관관계 ID예요.
ServerCodeconst wchar_t*읽기·쓰기Stove_IStoveSendLogParam_GetServerCode() / SetServerCode()사용자가 접속한 월드/지역 서버 코드예요.
ServerCodeDetailconst wchar_t*읽기·쓰기Stove_IStoveSendLogParam_GetServerCodeDetail() / SetServerCodeDetail()ServerCode 하위의 서브서버/채널/샤드 등 상세 코드예요.
LevelCodeconst wchar_t*읽기·쓰기Stove_IStoveSendLogParam_GetLevelCode() / SetLevelCode()로그 기록 시점의 계정 레벨 값이에요.
LevelCodeDetailconst wchar_t*읽기·쓰기Stove_IStoveSendLogParam_GetLevelCodeDetail() / SetLevelCodeDetail()로그 기록 시점의 캐릭터 레벨 값이에요. 이름에 "Detail" 이 붙지만 LevelCode 의 하위 단계가 아니라, 계정 범위인 LevelCode 에 대응하는 캐릭터 범위 값이에요.
ExternalIdconst wchar_t*읽기·쓰기Stove_IStoveSendLogParam_GetExternalId() / SetExternalId()광고 어트리뷰션부터 게임 내 행동까지 연결·추적하는 데 쓰는 식별자예요. Singular(MMP) 연동 게임은 SDID(Singular Device ID)를 전달해요.
Contentsconst wchar_t*읽기·쓰기Stove_IStoveSendLogParam_GetContents() / SetContents()위 필드로 다루지 않는 자유 형식 로그 페이로드예요(보통 wide-string 으로 인코딩한 JSON 문서). 레거시 81plug 의 action_param 필드에 대응해요.

Memory Management

ItemValue
생성 주체호출자 (Stove_CreateParam(k_EStoveLogTypeKind_SendLogParam))
해제 책임호출자 (Stove_IStoveTypeBase_Destroy() 필수): Stove_SendLog() 호출이 반환된 뒤 바로 해제할 수 있어요.

Example

c
IStoveSendLogParam* logParam = (IStoveSendLogParam*)Stove_CreateParam(k_EStoveLogTypeKind_SendLogParam);

Stove_IStoveSendLogParam_SetAuid(logParam, auid);
Stove_IStoveSendLogParam_SetCuid(logParam, cuid);
Stove_IStoveSendLogParam_SetContents(logParam, L"{\"event\":\"login\"}");

Stove_SendLog(logParam, OnSendLogFinished, nullptr);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)logParam);

Notes

  • MktType1/MktId1 과 MktType2/MktId2 는 서로 독립된 두 슬롯이에요. 주(primary)/보조(fallback) 관계가 아니므로, 해당하는 슬롯만 채워요.
  • LevelCodeDetail 은 이름과 달리 LevelCode 의 하위 값이 아니라 캐릭터 범위의 별도 값이에요.
  • Contents 는 레거시 81plug 의 action_param 필드에 대응해요.

See Also


IStoveSetGameProfileParam

종류 구조체 · 모듈 Base · 버전 3.5.0

Description

Stove_SetGameProfile() 호출 시 전달하는 게임 프로필 구조체예요. 게임의 월드 식별자와 월드 내 캐릭터 번호를 담아요.

Stove_CreateParam(k_EStoveBaseTypeKind_SetGameProfileParam) 으로 생성한 뒤 각 필드를 설정하고, 호출이 끝나면 Destroy() 로 해제해요.

Declaration

c
typedef struct IStoveSetGameProfileParam IStoveSetGameProfileParam;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
WorldIdconst wchar_t*읽기·쓰기Stove_IStoveSetGameProfileParam_GetWorldId() / SetWorldId()게임의 월드 식별자예요.
CharacterNoint64_t읽기·쓰기Stove_IStoveSetGameProfileParam_GetCharacterNo() / SetCharacterNo()월드 내 캐릭터 번호예요.

Memory Management

ItemValue
생성 주체호출자 (Stove_CreateParam(k_EStoveBaseTypeKind_SetGameProfileParam))
해제 책임호출자 (Destroy() 필수): API 호출이 끝난 뒤 해제해요.

Example

c
IStoveSetGameProfileParam* profileParam =
    (IStoveSetGameProfileParam*)Stove_CreateParam(k_EStoveBaseTypeKind_SetGameProfileParam);

Stove_IStoveSetGameProfileParam_SetWorldId(profileParam, L"world_01");
Stove_IStoveSetGameProfileParam_SetCharacterNo(profileParam, 12345);

IStoveResult* result = Stove_SetGameProfile(profileParam);

if (Stove_IStoveResult_GetResultCode(result) == k_EStoveCommonResultCode_Success)
{
    // 성공 시 로직을 구현해 주세요.
}
else
{
    // 실패 시 로직을 구현해 주세요.
}

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result);
Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)profileParam);

Notes

  • 옛 이름은 StoveGameProfileParams 이에요. 옛 구조체에서는 CharacterNo 필드가 "worldId Length" 로 잘못 표기되어 있었어요, 실제로는 캐릭터 번호이며, 현재 인터페이스의 CharacterNo 명칭이 정확한 의미예요.

See Also


IStoveSetStatOutcome

종류 구조체 · 모듈 GameSupport · 버전 3.5.0

Description

IStoveSetStatOutcome 은 통계(Stat) 수정 API 가 완료됐을 때 전달되는 결과 정보를 담는 타입이에요. Stove_SetStat 의 onFinished 콜백(OnSetStatCallback) 인자로 전달돼요.

이 타입은 SDK 가 만들어 콜백을 통해 전달하며, 호출자가 직접 생성하지 않아요.

Declaration

c
typedef struct IStoveSetStatOutcome IStoveSetStatOutcome;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
ErrorMessageconst wchar_t*읽기Stove_IStoveSetStatOutcome_GetErrorMessage()통계 값 갱신 처리 중 발생할 수 있는 예외 메시지예요. 호출이 성공한 상태에서도 값이 채워질 수 있으며, 현재는 integer overflow만 전달돼요(추후 다른 값이 추가될 수 있어요). integer overflow가 오는 경우는 설정하려는 값이 int32 범위를 넘어 값이 잘렸다는 의미예요. ASCII 문자로만 구성돼요.
CurrentValueint32_t읽기Stove_IStoveSetStatOutcome_GetCurrentValue()수정이 반영된 통계의 현재(갱신된) 값이에요.
IsUpdatedbool읽기Stove_IStoveSetStatOutcome_IsUpdated()통계 값이 실제로 변경되었는지 여부예요. 기존 값과 같은 값으로 설정하면 값이 바뀌지 않으므로 false가 돼요. 이 경우에도 호출 자체는 성공이에요.

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK (해제 금지. Stove_SetStat 콜백이 끝나면 무효처리돼요)

Example

c
void OnSetStatFinished(const IStoveCallbackResult* callbackResult, const IStoveSetStatOutcome* statOutcome)
{
    if (Stove_IStoveResult_GetResultCode(Stove_IStoveCallbackResult_GetResult(callbackResult)) == 0 && statOutcome != NULL)
    {
        if (Stove_IStoveSetStatOutcome_IsUpdated(statOutcome))
        {
            int32_t currentValue = Stove_IStoveSetStatOutcome_GetCurrentValue(statOutcome);
            // 성공 시 로직을 구현해 주세요.
        }
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Notes

  • 호출자가 직접 생성하지 않으며, Stove_SetStat 콜백을 통해서만 얻을 수 있어요.
  • 기존 값과 같은 값을 다시 설정해도 호출 자체는 성공하며, 이때 IsUpdated는 false로 전달돼요. 이는 실패가 아니라 값이 변경되지 않았다는 의미이므로 오류로 처리하지 않아야 해요.
  • ErrorMessage는 호출이 성공한 상태에서도 값이 채워질 수 있어요.
  • 설정하려는 값이 int32 범위를 넘으면 값이 2147483647로 잘려요. 이때도 호출은 성공하며 IsUpdated는 true로 전달돼요.
  • 값이 잘렸는지는 ErrorMessage에 integer overflow가 담기는지로 확인해요.

See Also


IStoveSetStatParam

종류 구조체 · 모듈 GameSupport · 버전 3.5.0

Description

IStoveSetStatParam 은 수정할 통계(Stat) 와 적용할 새 값을 지정하는 파라미터 타입이에요. Stove_SetStat 의 입력으로 사용해요.

호출자가 Stove_CreateParam(k_EStoveGameSupportTypeKind_SetStatParam) 으로 생성하고, 값을 채운 뒤 API 호출이 끝나면 Destroy() 로 해제해요.

Declaration

c
typedef struct IStoveSetStatParam IStoveSetStatParam;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeRequiredAccessAccessorDescription
StatsIdconst wchar_t*예읽기·쓰기Stove_IStoveSetStatParam_GetStatsId() / SetStatsId()수정할 통계 ID 예요. 형식: [A-Z0-9\-_]*$ (대문자, 숫자, 밑줄, 하이픈)
StatValueint32_t예읽기·쓰기Stove_IStoveSetStatParam_GetStatValue() / SetStatValue()통계에 적용할 새 값이에요. 기존 값에 더해지는 증가분이 아니라, 통계 값을 이 값으로 그대로 대체(설정)해요.

Memory Management

ItemValue
생성 주체호출자 (Stove_CreateParam(k_EStoveGameSupportTypeKind_SetStatParam))
해제 책임호출자 (Destroy() 필수)

Example

c
IStoveSetStatParam* param =
    (IStoveSetStatParam*)Stove_CreateParam(k_EStoveGameSupportTypeKind_SetStatParam);
Stove_IStoveSetStatParam_SetStatsId(param, L"KILL_COUNT");
Stove_IStoveSetStatParam_SetStatValue(param, 42);

Stove_SetStat(param, OnSetStatFinished, NULL);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param);

Notes

  • StatsId · StatValue 를 모두 설정해야 정상적으로 수정 요청을 보낼 수 있어요.
  • StatValue 는 증가·감소가 아니라 설정(대체) 동작이에요. 누적하려면 현재 값을 먼저 조회해 더한 값을 전달해야 해요.
  • 처리 결과(적용 성공 여부, 갱신된 값)는 IStoveSetStatOutcome 콜백 인자로 전달돼요.

See Also


IStoveShopCategory

종류 구조체 · 모듈 IAP · 버전 3.5.0

Description

상점 카테고리 트리를 구성하는 항목 하나를 나타내요. Stove_FetchShopCategories 호출 결과로 IStoveShopCategoryList 에 담겨 OnFetchShopCategoriesCallback 콜백에 전달돼요.

SDK 가 채워서 콜백으로 전달하는 데이터형이에요. 호출자가 직접 만들지 않아요.

콜백으로 전달되는 목록과 각 항목은 SDK 소유이며 콜백 호출이 끝나면 더 이상 유효하지 않아요. Destroy() 를 호출하지 말고, 보관이 필요한 값은 콜백 안에서 복사해 두어야 해요.

Declaration

c
typedef struct IStoveShopCategory IStoveShopCategory;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
CategoryIdconst wchar_t*읽기Stove_IStoveShopCategory_GetCategoryId()카테고리 식별자
CategoryParentIdconst wchar_t*읽기Stove_IStoveShopCategory_GetCategoryParentId()상위 카테고리 식별자. 최상위 카테고리는 비어 있어요.
CategoryDisplayNoint32_t읽기Stove_IStoveShopCategory_GetCategoryDisplayNo()같은 계층 내에서의 표시 순서
CategoryNameconst wchar_t*읽기Stove_IStoveShopCategory_GetCategoryName()현지화된 카테고리 이름
CategoryDepthint32_t읽기Stove_IStoveShopCategory_GetCategoryDepth()카테고리 트리에서의 깊이 (0 = 최상위)

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK (해제 금지, 콜백이 끝나면 무효)

Example

c
void __cdecl OnFetchShopCategoriesCallback(const IStoveCallbackResult* callbackResult, const IStoveShopCategoryList* list)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    if (Stove_IStoveResult_GetResultCode(result) == 0)
    {
        uint32_t count = Stove_IStoveShopCategoryList_GetCount(list);

        for (uint32_t i = 0; i < count; ++i)
        {
            const IStoveShopCategory* category = Stove_IStoveShopCategoryList_GetAt(list, i);

            const wchar_t* categoryId = Stove_IStoveShopCategory_GetCategoryId(category);
            const wchar_t* categoryName = Stove_IStoveShopCategory_GetCategoryName(category);
            int32_t depth = Stove_IStoveShopCategory_GetCategoryDepth(category);

            // 필요한 값만 복사해서 보관해 주세요.
        }
        // list 와 각 항목은 이 콜백이 끝나면 무효처리돼요. Destroy() 를 호출하지 마십시오.
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Notes

  • Stove_FetchShopCategories 의 출력으로만 전달돼요.
  • CategoryParentId 가 비어 있으면 최상위 카테고리예요.
  • IStoveProduct 의 CategoryId 와 CategoryName 은 이 항목과 대응해요.

See Also


IStoveShopCategoryList

종류 구조체 · 모듈 IAP · 버전 3.5.0

Description

OnFetchShopCategoriesCallback 콜백에 전달되는 컨테이너예요. Stove_FetchShopCategories 가 돌려주는 IStoveShopCategory 배열을 감싸요.

SDK 가 채워서 콜백으로 전달하는 데이터형이에요. 호출자가 직접 만들지 않아요.

이 객체와 GetAt() 으로 얻는 각 항목은 모두 SDK 소유이며 콜백 호출이 끝나면 더 이상 유효하지 않아요. Destroy() 를 호출하지 말고, 보관이 필요한 값은 콜백 안에서 복사해 두어야 해요.

Declaration

c
typedef struct IStoveShopCategoryList IStoveShopCategoryList;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
Countuint32_t읽기Stove_IStoveShopCategoryList_GetCount()결과에 담긴 상점 카테고리 수
At(index)const IStoveShopCategory*읽기Stove_IStoveShopCategoryList_GetAt()index(0부터 시작) 위치의 상점 카테고리. index >= Count 이면 nullptr 을 반환해요.

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK (해제 금지, 콜백이 끝나면 무효)

Example

c
void __cdecl OnFetchShopCategoriesCallback(const IStoveCallbackResult* callbackResult, const IStoveShopCategoryList* list)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    if (Stove_IStoveResult_GetResultCode(result) == 0)
    {
        uint32_t count = Stove_IStoveShopCategoryList_GetCount(list);
        for (uint32_t i = 0; i < count; ++i)
        {
            const IStoveShopCategory* category = Stove_IStoveShopCategoryList_GetAt(list, i);
            // 필요한 값만 복사해서 보관해 주세요.
        }
        // list 와 각 항목은 이 콜백이 끝나면 무효처리돼요. Destroy() 를 호출하지 마십시오.
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Notes

  • Stove_FetchShopCategories 의 출력으로만 전달돼요.
  • 예전에는 배열과 개수를 콜백 인자로 각각 따로 받는 방식이었으나, 지금은 이 컨테이너 하나로 감싸 전달돼요.

See Also


IStoveShutdownInfo

종류 구조체 · 모듈 Base · 버전 3.5.0

Description

Stove_ShutdownNotification() 콜백으로 전달되는 셧다운 고지 정보예요.

셧다운 고지 메시지, 메시지 노출 시간, 셧다운까지 남은 시간을 담아요. SDK 가 만들어 콜백 인자로만 전달하며, 호출자는 해제하지 않아요.

셧다운이 적용된 계정이면 국내뿐 아니라 해외에서도 이 알림이 동작해요.

Declaration

c
typedef struct IStoveShutdownInfo IStoveShutdownInfo;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
Msgconst wchar_t*읽기Stove_IStoveShutdownInfo_GetMsg()셧다운 고지 메시지예요.
ExposureTimeint32_t읽기Stove_IStoveShutdownInfo_GetExposureTime()셧다운 메시지 노출 시간(초)예요.
InadvanceMinutesint32_t읽기Stove_IStoveShutdownInfo_GetInadvanceMinutes()사용자가 셧다운되기까지 남은 시간(분)이에요.

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK: 콜백 인자로만 전달되며 콜백이 끝나면 무효처리돼요. 호출자는 Destroy() 를 호출하지 않아요.

Example

c
void __cdecl OnShutdownNotificationCallback(const IStoveCallbackResult* callbackResult, const IStoveShutdownInfo* shutdown)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    if (Stove_IStoveResult_GetResultCode(result) == k_EStoveCommonResultCode_Success)
    {
        const wchar_t* msg = Stove_IStoveShutdownInfo_GetMsg(shutdown);
        int32_t inadvanceMinutes = Stove_IStoveShutdownInfo_GetInadvanceMinutes(shutdown);
        // 성공 시 로직을 구현해 주세요. (셧다운 고지 표시)
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }

    // shutdown 은 Destroy() 를 호출하지 않아요.
}

Notes

  • ShutdownNotification 은 한국 전용이 아니에요. 셧다운이 적용된 계정이면 해외에서도 동작해요.
  • 이 콜백은 1회성이 아니에요. 서버가 내려준 사전 안내 시점(예: 셧다운 30분 전, 10분 전 등)마다, 그리고 실제 셧다운 시각이 되었을 때 각각 한 번씩 반복 호출돼요.

See Also


IStoveSignin

종류 구조체 · 모듈 Base · 버전 3.5.0

Description

Stove_GetSignin() 호출 시 전달되는 로그인 인증 정보 구조체예요.

본인 인증/이메일 인증 완료 여부와 가입 국가, 가입 시 사용한 인증 방식(IDP) 정보를 담아요. SDK 가 Stove_GetSignin() 의 out 파라미터로 만들어 돌려주며, 호출자가 사용 후 Destroy() 로 해제해요.

Declaration

c
typedef struct IStoveSignin IStoveSignin;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
IsPersonVerifiedbool읽기Stove_IStoveSignin_IsPersonVerified()사용자의 본인 인증 완료 여부예요.
IsEmailVerifiedbool읽기Stove_IStoveSignin_IsEmailVerified()사용자의 이메일 인증 완료 여부예요.
RegisteredCountryCodeconst wchar_t*읽기Stove_IStoveSignin_GetRegisteredCountryCode()Stove 플랫폼 가입 국가 코드예요(ISO 3166-1 ALPHA-2).
ProviderCodeconst wchar_t*읽기Stove_IStoveSignin_GetProviderCode()Stove 로그인 시 사용한 인증 방식을 나타내는 IDP 분류 코드(문자열)이에요. 예: SO(Stove 이메일), FB(Facebook), GP(Google), STEAM, VTCO 등.
AccountTypeint32_t읽기Stove_IStoveSignin_GetAccountType()계정 유형 코드(숫자, 서버 관리)예요. 예: 2=Facebook, 3=Twitter, 6=Naver, 9=Google+, 11=Stove PC 가입, 12=Apple, 13=LINE, 14=LINE Games, 15=Steam, 16=VTCO 등. 값→의미 매핑이 공개 규격으로 고정되어 있지 않으므로, IDP/계정 종류(예: STEAM vs STEAM_SHADOW)를 식별하려면 ProviderCode 를 대신 참조해요.

Memory Management

ItemValue
생성 주체SDK (Stove_GetSignin() 의 out 파라미터로 전달)
해제 책임호출자 (Destroy() 필수)

Example

c
IStoveSignin* signin = NULL;
IStoveResult* result = Stove_GetSignin(&signin);

if (Stove_IStoveResult_GetResultCode(result) == k_EStoveCommonResultCode_Success)
{
    bool personVerified = Stove_IStoveSignin_IsPersonVerified(signin);
    const wchar_t* providerCode = Stove_IStoveSignin_GetProviderCode(signin);
    // 성공 시 로직을 구현해 주세요.

    Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)signin);
}
else
{
    // 실패 시 로직을 구현해 주세요.
}

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result);

Notes

  • Stove_Initialize() 로 초기화가 끝난 뒤 호출해야 유효한 값을 받을 수 있어요.
  • AccountType 은 숫자 코드, ProviderCode 는 문자열 코드로, 같은 인증 방식을 서로 다른 표현으로 나타내요. IDP/계정 종류를 정확히 식별해야 할 때는 ProviderCode 를 사용해요.

See Also


IStoveStartPurchaseOutcome

종류 구조체 · 모듈 IAP · 버전 3.5.0

Description

Stove_StartPurchase 호출 결과를 나타내요. OnStartPurchaseCallback 콜백에 전달돼요. 어느 필드가 채워지는지는 IStovePurchaseParam 의 Operation 값에 따라 달라져요.

  • Operation 이 Default 이면 TempPaymentUrl 이 수동 결제 진행용으로 채워져요.
  • Operation 이 WithWebViewAndConfirmResult 이면 결제가 성공했을 때 IsPurchased, PurchasedProduct*, ChargeInfo* 가 채워져요.

SDK 가 채워서 콜백으로 전달하는 데이터형이에요. 호출자가 직접 만들지 않아요.

TxnDetailNos 가 가리키는 배열, PurchasedProductAt() / ChargeInfoAt() 으로 얻는 항목은 모두 SDK 소유이며 콜백 호출이 끝나면 더 이상 유효하지 않아요. Destroy() 를 호출하지 말고, 보관이 필요한 값은 콜백 안에서 복사해 두어야 해요.

Declaration

c
typedef struct IStoveStartPurchaseOutcome IStoveStartPurchaseOutcome;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
TxnMasterNoint64_t읽기Stove_IStoveStartPurchaseOutcome_GetTxnMasterNo()트랜잭션 마스터 번호 (구매 1건당 TID)
TxnDetailNosconst int64_t*읽기Stove_IStoveStartPurchaseOutcome_GetTxnDetailNos()상품별 트랜잭션 상세 번호 배열의 포인터. SDK 소유이며 콜백이 끝나면 무효처리돼요.
TxnDetailNosCountuint32_t읽기Stove_IStoveStartPurchaseOutcome_GetTxnDetailNosCount()TxnDetailNos 가 가리키는 배열의 원소 수
TempPaymentUrlconst wchar_t*읽기Stove_IStoveStartPurchaseOutcome_GetTempPaymentUrl()1회용 결제 URL. Operation == Default 일 때 제공돼요.
PurchaseProgressEStovePurchaseProgress읽기Stove_IStoveStartPurchaseOutcome_GetPurchaseProgress()구매 진행 상태
IsPurchasedbool읽기Stove_IStoveStartPurchaseOutcome_IsPurchased()Operation == WithWebViewAndConfirmResult 이고 결제가 성공적으로 완료되었으면 true. 그 외에는 false.
ExtraDataconst wchar_t*읽기Stove_IStoveStartPurchaseOutcome_GetExtraData()Stove_StartPurchase 호출 시 전달한 ExtraData 문자열의 에코
PurchasedProductCountuint32_t읽기Stove_IStoveStartPurchaseOutcome_GetPurchasedProductCount()구매된 상품 항목 수. Operation == WithWebViewAndConfirmResult 이고 결제가 성공했을 때 채워져요.
PurchasedProductAt(index)const IStovePurchasedProduct*읽기Stove_IStoveStartPurchaseOutcome_GetPurchasedProductAt()index(0부터 시작) 위치의 구매 상품 항목. index >= PurchasedProductCount 이면 nullptr 을 반환해요.
ChargeInfoCountuint32_t읽기Stove_IStoveStartPurchaseOutcome_GetChargeInfoCount()결제에 사용된 화폐 종류를 설명하는 charge-info 항목 수
ChargeInfoAt(index)const IStoveChargeInfo*읽기Stove_IStoveStartPurchaseOutcome_GetChargeInfoAt()index(0부터 시작) 위치의 charge-info 항목. index >= ChargeInfoCount 이면 nullptr 을 반환해요.

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK (해제 금지, 콜백이 끝나면 무효)

Example

c
void __cdecl OnStartPurchaseCallback(const IStoveCallbackResult* callbackResult, const IStoveStartPurchaseOutcome* outcome)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    if (Stove_IStoveResult_GetResultCode(result) == 0)
    {
        int32_t progress = Stove_IStoveStartPurchaseOutcome_GetPurchaseProgress(outcome);

        if (progress == k_EStovePurchaseProgress_NeedPaymentWindow)
        {
            const wchar_t* paymentUrl = Stove_IStoveStartPurchaseOutcome_GetTempPaymentUrl(outcome);
            // paymentUrl 을 열어 결제를 진행한 뒤 Stove_ConfirmPurchase() 를 호출해 주세요.
        }
        else if (Stove_IStoveStartPurchaseOutcome_IsPurchased(outcome))
        {
            uint32_t productCount = Stove_IStoveStartPurchaseOutcome_GetPurchasedProductCount(outcome);
            for (uint32_t i = 0; i < productCount; ++i)
            {
                const IStovePurchasedProduct* product = Stove_IStoveStartPurchaseOutcome_GetPurchasedProductAt(outcome, i);
                // 필요한 값만 복사해서 보관해 주세요.
            }
        }
        // outcome 과 그 안의 배열/항목은 이 콜백이 끝나면 무효처리돼요. Destroy() 를 호출하지 마십시오.
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Notes

  • Stove_StartPurchase 의 출력으로만 전달돼요.
  • PurchaseProgress 가 NeedPaymentWindow 이면 TempPaymentUrl 로 결제 창을 열고, 결제 후 Stove_ConfirmPurchase 로 구매를 확정해야 해요.
  • ExtraData 는 IStoveStartPurchaseParam 의 ExtraData 를 그대로 반환해요.
  • 이 타입의 옛 이름은 IStovePurchaseResult 이에요(TypeKind 옛 이름: PurchaseResult). 과거 연동을 옮기는 경우 참고해 주세요.

See Also


IStoveStartPurchaseParam

종류 구조체 · 모듈 IAP · 버전 3.5.0

Description

Stove_StartPurchase 를 호출할 때 전달하는 입력 파라미터예요. 구매할 상품 목록(IStoveOrderProductParam)과 구매 동작 옵션(IStovePurchaseParam)을 함께 담아요.

Stove_CreateParam(k_EStoveIAPTypeKind_StartPurchaseParam) 으로 생성하고, setter 로 값을 채운 뒤 호출이 끝나면 Destroy() 로 해제해야 해요.

Declaration

c
typedef struct IStoveStartPurchaseParam IStoveStartPurchaseParam;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessRequiredAccessorDescription
Productsconst IStoveOrderProductParam* const* / IStoveOrderProductParam**읽기·쓰기예Stove_IStoveStartPurchaseParam_GetProducts() / Stove_IStoveStartPurchaseParam_SetProducts()구매할 상품별 주문 항목 배열
ProductsCountuint32_t읽기-Stove_IStoveStartPurchaseParam_GetProductsCount()Products 배열의 원소 수. SetProducts() 호출 시 함께 지정돼요.
PurchaseParamconst IStovePurchaseParam* / IStovePurchaseParam*읽기·쓰기예Stove_IStoveStartPurchaseParam_GetPurchaseParam() / Stove_IStoveStartPurchaseParam_SetPurchaseParam()구매 동작 옵션(웹뷰 배치 포함)
ServiceTxnNoconst wchar_t*읽기·쓰기아니오Stove_IStoveStartPurchaseParam_GetServiceTxnNo() / Stove_IStoveStartPurchaseParam_SetServiceTxnNo()게임이 발급한 서비스 측 트랜잭션 번호 (선택)
ExtraDataconst wchar_t*읽기·쓰기아니오Stove_IStoveStartPurchaseParam_GetExtraData() / Stove_IStoveStartPurchaseParam_SetExtraData()추가 요청 데이터 (일반적으로 JSON 문자열, 선택). IStoveStartPurchaseOutcome 의 ExtraData 로 그대로 반환돼요.

Memory Management

ItemValue
생성 주체호출자 (Stove_CreateParam(k_EStoveIAPTypeKind_StartPurchaseParam))
해제 책임호출자 (Destroy() 필수)

Example

c
IStoveOrderProductParam* orderProduct = (IStoveOrderProductParam*)Stove_CreateParam(k_EStoveIAPTypeKind_OrderProductParam);
Stove_IStoveOrderProductParam_SetProductId(orderProduct, productId);
Stove_IStoveOrderProductParam_SetSalePrice(orderProduct, salePrice);
Stove_IStoveOrderProductParam_SetQuantity(orderProduct, 1);

IStovePurchaseParam* purchaseParam = (IStovePurchaseParam*)Stove_CreateParam(k_EStoveIAPTypeKind_PurchaseParam);
Stove_IStovePurchaseParam_SetOperation(purchaseParam, k_EStovePurchaseOperation_WithWebViewAndConfirmResult);

IStoveStartPurchaseParam* startPurchaseParam = (IStoveStartPurchaseParam*)Stove_CreateParam(k_EStoveIAPTypeKind_StartPurchaseParam);

IStoveOrderProductParam* orderProducts[] = { orderProduct };
Stove_IStoveStartPurchaseParam_SetProducts(startPurchaseParam, orderProducts, 1);
Stove_IStoveStartPurchaseParam_SetPurchaseParam(startPurchaseParam, purchaseParam);
Stove_IStoveStartPurchaseParam_SetExtraData(startPurchaseParam, L"{\"orderFrom\":\"shop\"}");

Stove_StartPurchase(startPurchaseParam, OnStartPurchaseCallback, NULL, NULL, NULL);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)startPurchaseParam);
Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)purchaseParam);
Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)orderProduct);

Notes

  • SetProducts() 와 SetPurchaseParam() 은 소유권을 넘겨받지 않아요. 전달한 IStoveOrderProductParam, IStovePurchaseParam 객체는 호출자가 소유권을 유지하며, Stove_StartPurchase() 가 반환된 뒤 언제든 각각 직접 Destroy() 할 수 있어요. Stove_StartPurchase() 는 호출이 반환되기 전에 이 자식 객체들의 필요한 값을 모두 동기적으로 복사해 가므로, 비동기 콜백이 실행되는 동안 이 객체들이 참조되지 않아요.
  • Destroy() 는 이 파라미터를 구성하는 하위 객체(Products, PurchaseParam)까지 함께 해제하지 않아요. 각 객체를 개별적으로 해제해야 해요.

See Also


IStoveStat

종류 구조체 · 모듈 GameSupport · 버전 3.5.0

Description

IStoveStat 은 통계(Stat) 조회 API 가 성공했을 때 전달되는 결과 정보를 담는 타입이에요. Stove_FetchStat 의 onFinished 콜백(OnGetStatCallback) 인자로 전달돼요.

이 타입은 SDK 가 만들어 콜백을 통해 전달하며, 호출자가 직접 생성하지 않아요.

Declaration

c
typedef struct IStoveStat IStoveStat;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
StatsFullIdconst IStoveStatFullId*읽기Stove_IStoveStat_GetStatsFullId()통계의 전체 식별 정보예요.
UpdatedAtuint64_t읽기Stove_IStoveStat_GetUpdatedAt()마지막 갱신 시각이에요 (epoch time, 밀리초).
CurrentValueint32_t읽기Stove_IStoveStat_GetCurrentValue()통계의 현재 값이에요.

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK (해제 금지. Stove_FetchStat 콜백이 끝나면 무효처리돼요)

Example

c
void OnGetStatFinished(const IStoveCallbackResult* callbackResult, const IStoveStat* stat)
{
    if (Stove_IStoveResult_GetResultCode(Stove_IStoveCallbackResult_GetResult(callbackResult)) == 0 && stat != NULL)
    {
        int32_t currentValue = Stove_IStoveStat_GetCurrentValue(stat);
        uint64_t updatedAt = Stove_IStoveStat_GetUpdatedAt(stat);

        // 성공 시 로직을 구현해 주세요.
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Notes

  • 호출자가 직접 생성하지 않으며, Stove_FetchStat 콜백을 통해서만 얻을 수 있어요.
  • StatsFullId 로 얻는 IStoveStatFullId 도 이 객체와 함께 콜백이 끝나면 무효처리돼요.

See Also


IStoveStatFullId

종류 구조체 · 모듈 GameSupport · 버전 3.5.0

Description

IStoveStatFullId 는 통계(Stat) 하나를 완전히 식별하는 정보를 담는 타입이에요. Stove_FetchStat 의 조회 결과인 IStoveStat 안에 포함되어 전달돼요.

이 타입은 SDK 가 만들어 콜백을 통해 전달하며, 호출자가 직접 생성하지 않아요.

Declaration

c
typedef struct IStoveStatFullId IStoveStatFullId;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
GameIdconst wchar_t*읽기Stove_IStoveStatFullId_GetGameId()이 통계와 연결된 게임 ID 예요.
StatsIdconst wchar_t*읽기Stove_IStoveStatFullId_GetStatsId()통계 ID 예요. 형식: [A-Z0-9\-_]*$ (대문자, 숫자, 밑줄, 하이픈)

Memory Management

ItemValue
생성 주체SDK (IStoveStat 콜백 인자 안에 포함되어 전달돼요)
해제 책임SDK (해제 금지. 이 객체를 담고 있는 IStoveStat 콜백 인자가 무효처리되면 함께 무효처리돼요)

Example

c
void OnGetStatFinished(const IStoveCallbackResult* callbackResult, const IStoveStat* stat)
{
    if (Stove_IStoveResult_GetResultCode(Stove_IStoveCallbackResult_GetResult(callbackResult)) == 0 && stat != NULL)
    {
        const IStoveStatFullId* fullId = Stove_IStoveStat_GetStatsFullId(stat);
        const wchar_t* statsId = Stove_IStoveStatFullId_GetStatsId(fullId);

        // 성공 시 로직을 구현해 주세요.
    }
}

Notes

  • 호출자가 직접 생성하지 않으며, IStoveStat 을 통해서만 얻을 수 있어요.
  • StatsId 형식은 통계를 요청할 때 사용하는 IStoveFetchStatParam 의 StatsId 와 동일한 규칙을 따라요.

See Also


IStoveTermsAgreementOutcome

종류 구조체 · 모듈 IAP · 버전 3.5.0

Description

Stove_FetchTermsAgreement 호출 결과를 나타내요. OnFetchTermsAgreementCallback 콜백에 전달돼요.

SDK 가 채워서 콜백으로 전달하는 데이터형이에요. 호출자가 직접 만들지 않아요.

이 객체는 SDK 소유이며 콜백 호출이 끝나면 더 이상 유효하지 않아요. Destroy() 를 호출하지 말고, 보관이 필요한 값은 콜백 안에서 복사해 두어야 해요.

Declaration

c
typedef struct IStoveTermsAgreementOutcome IStoveTermsAgreementOutcome;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
IsAgreedbool읽기Stove_IStoveTermsAgreementOutcome_IsAgreed()사용자가 이미 최신 약관에 동의했는지 여부. true 이면 Url 은 빈 문자열이에요.
Urlconst wchar_t*읽기Stove_IStoveTermsAgreementOutcome_GetUrl()호출자가 열어야 하는(또는 웹뷰로 이미 열었던) 약관 페이지 URL. IsAgreed 가 true 이면 비어 있어요.

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK (해제 금지, 콜백이 끝나면 무효)

Example

c
void __cdecl OnFetchTermsAgreementCallback(const IStoveCallbackResult* callbackResult, const IStoveTermsAgreementOutcome* outcome)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    if (Stove_IStoveResult_GetResultCode(result) == 0)
    {
        if (!Stove_IStoveTermsAgreementOutcome_IsAgreed(outcome))
        {
            const wchar_t* url = Stove_IStoveTermsAgreementOutcome_GetUrl(outcome);
            // Operation == Default 이면 url 로 약관 페이지를 직접 열어 주세요.
        }
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Notes

See Also


IStoveTypeBase

종류 구조체 · 모듈 Base · 버전 3.5.0

Description

DLL 경계를 넘어 전달되는 모든 SDK 소유 객체가 상속하는 루트 인터페이스예요. 런타임 타입 식별 기능(GetTypeKind())과 명시적인 Destroy() 해제 방식을 제공해요.

IStoveResult, IStoveUser 뿐 아니라 결제·소유권·통계와 업적·팝업·PC방·로그 등 SDK 가 다루는 모든 객체 타입이 이 인터페이스를 상속해요. 객체를 직접 만드는 일은 없고, 다른 API 가 반환하거나 콜백으로 전달하는 객체의 공통 동작을 정의해요. 해제 책임은 인스턴스마다 ShouldDestroy() 로 확인해요.

ShouldDestroy() 가 false 를 반환하는 인스턴스(콜백 인자로 전달된 객체 등)는 Destroy() 를 호출하면 안 돼요.

Declaration

c
typedef struct IStoveTypeBase IStoveTypeBase;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
TypeKindint32_t읽기Stove_IStoveTypeBase_GetTypeKind()구체적인 타입 종류를 반환해요(EStoveBaseTypeKind 값 중 하나).
ShouldDestroybool읽기Stove_IStoveTypeBase_ShouldDestroy()호출자가 이 인스턴스에 대해 Destroy() 를 호출할 책임이 있는지 여부예요. true 면 호출자 소유(반환값 등)이므로 사용 후 정확히 한 번 Destroy() 를 호출해야 하고, false 면 SDK 가 수명을 관리(콜백 인자 등)하므로 Destroy() 를 호출하면 안 돼요.
-void동작Stove_IStoveTypeBase_Destroy() (Non-const)객체를 해제해요. 소유한 인스턴스마다 정확히 한 번만 호출해야 해요.
QueryExtvoid*읽기Stove_IStoveTypeBase_QueryExt(extId)확장 인터페이스 포인터를 반환해요(없으면 nullptr). extId 구간: 0=예약, 1~0xFFFF=이 루트 인터페이스 자체의 향후 확장을 위해 예약된 구간, 0x10000 이상=결제·소유권·통계 등 개별 기능이 정의하는 확장 ID 구간이에요. 현재 SDK 에는 실제로 등록된 확장이 없어 어떤 extId 를 넘겨도 항상 nullptr 을 반환해요.

Memory Management

ItemValue
생성 주체하위 타입에 따라 달라요, SDK 가 반환/전달하는 결과·데이터 타입이거나, 호출자가 Stove_CreateParam() 으로 생성하는 파라미터 타입이에요.
해제 책임ShouldDestroy() 가 true 를 반환하는 인스턴스는 호출자가 Destroy() 를 호출해요. 콜백 인자로 전달된 인스턴스는 ShouldDestroy() 가 false 이며 해제하지 않아요.

Example

c
IStoveResult* result = Stove_Uninitialize();

if (Stove_IStoveTypeBase_ShouldDestroy((IStoveTypeBase*)result))
{
    Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result);
}

Notes

  • IStoveResult, IStoveUser, IStoveGds 뿐 아니라 결제·소유권·통계와 업적·팝업·PC방·로그 등 SDK 가 다루는 모든 객체 타입이 이 인터페이스를 상속해요. 이 문서에서 소개하지 않은 다른 구조체도 예외 없이 포함돼요.
  • QueryExt() 는 아직 실제로 등록된 확장이 없어, 어떤 extId 를 넘기더라도 항상 nullptr 을 반환하는 예약 기능이에요.
  • 콜백 인자로 전달되는 인스턴스(IStoveCallbackResult, IStoveAccessToken 등)는 콜백이 끝나면 무효처리되므로 Destroy() 를 호출하지 않아요.

See Also


IStoveUser

종류 구조체 · 모듈 Base · 버전 3.5.0

Description

Stove_GetUser() 호출 시 전달되는 사용자 정보 구조체예요.

런처에서 로그인한 사용자의 닉네임과 게임 사용자 ID 를 담아요. SDK 가 Stove_GetUser() 의 out 파라미터로 만들어 돌려주며, 호출자가 사용 후 Destroy() 로 해제해요.

Declaration

c
typedef struct IStoveUser IStoveUser;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
NickNameconst wchar_t*읽기Stove_IStoveUser_GetNickName()런처에서 로그인한 사용자의 Stove 닉네임이에요.
UserIduint64_t읽기Stove_IStoveUser_GetUserId()런처에서 로그인한 사용자의 GameUserId 이에요.

Memory Management

ItemValue
생성 주체SDK (Stove_GetUser() 의 out 파라미터로 전달)
해제 책임호출자 (Destroy() 필수)

Example

c
IStoveUser* user = NULL;
IStoveResult* result = Stove_GetUser(&user);

if (Stove_IStoveResult_GetResultCode(result) == k_EStoveCommonResultCode_Success)
{
    const wchar_t* nickName = Stove_IStoveUser_GetNickName(user);
    uint64_t userId = Stove_IStoveUser_GetUserId(user);
    // 성공 시 로직을 구현해 주세요.

    Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)user);
}
else
{
    // 실패 시 로직을 구현해 주세요.
}

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result);

Notes

  • Stove_Initialize() 로 초기화가 끝난 뒤 호출해야 유효한 값을 받을 수 있어요.

See Also


IStoveVietnamAgeRatingInfo

종류 구조체 · 모듈 Base · 버전 3.5.0

Description

Stove_VietnamAgeRatingNotification() 콜백으로 전달되는 연령등급 고지 오버레이 정보예요. 베트남 전용 API 예요.

오버레이 표시 상태와 형태, 크기/위치, 게임 연령등급, 고지 메시지를 담아요. SDK 가 만들어 콜백 인자로만 전달하며, 호출자는 해제하지 않아요.

1회성 콜백이므로 렌더링이 가능한 시점 이후에 호출해야 해요.

Declaration

c
typedef struct IStoveVietnamAgeRatingInfo IStoveVietnamAgeRatingInfo;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
OverlayModeint32_t읽기Stove_IStoveVietnamAgeRatingInfo_GetOverlayMode()오버레이 표시 상태예요(SHOW: 오버레이 표시, HIDE: 오버레이 숨김). EStoveOverlayMode 값이에요.
OverlayTypeint32_t읽기Stove_IStoveVietnamAgeRatingInfo_GetOverlayType()오버레이 유형이에요(0=Black: 어두운 배경(RGB(33,33,33))에 흰 글자, 1=White: 흰 배경(RGB(255,255,255))에 검은 글자, 기본값은 White).
OverlayScalefloat읽기Stove_IStoveVietnamAgeRatingInfo_GetOverlayScale()오버레이 크기 비율이에요(0.0 ~ 1.0).
OverlayOpacityfloat읽기Stove_IStoveVietnamAgeRatingInfo_GetOverlayOpacity()오버레이 불투명도예요(0.0 ~ 1.0).
AgeRatingint32_t읽기Stove_IStoveVietnamAgeRatingInfo_GetAgeRating()게임 연령등급이에요(0=전체이용가, 12=12세, 16=16세, 18=18세).
Msgconst wchar_t*읽기Stove_IStoveVietnamAgeRatingInfo_GetMsg()연령등급 고지 메시지예요.
DisplayPositionXfloat읽기Stove_IStoveVietnamAgeRatingInfo_GetDisplayPositionX()메시지 표시 위치의 x 좌표예요. 화면 왼쪽 기준(0.0 ~ 1.0).
DisplayPositionYfloat읽기Stove_IStoveVietnamAgeRatingInfo_GetDisplayPositionY()메시지 표시 위치의 y 좌표예요. 화면 위쪽 기준(0.0 ~ 1.0).
Languageconst wchar_t*읽기Stove_IStoveVietnamAgeRatingInfo_GetLanguage()폰트 선택을 위한 언어 코드예요(예: L"ko", L"en", L"ja", L"vi", L"zh-cn", L"zh-tw", L"th").

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK: 콜백 인자로만 전달되며 콜백이 끝나면 무효처리돼요. 호출자는 Destroy() 를 호출하지 않아요.

Example

c
void __cdecl OnVietnamAgeRatingNotificationCallback(const IStoveCallbackResult* callbackResult, const IStoveVietnamAgeRatingInfo* ageRatingInfo)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    if (Stove_IStoveResult_GetResultCode(result) == k_EStoveCommonResultCode_Success)
    {
        int32_t overlayMode = Stove_IStoveVietnamAgeRatingInfo_GetOverlayMode(ageRatingInfo);
        const wchar_t* msg = Stove_IStoveVietnamAgeRatingInfo_GetMsg(ageRatingInfo);
        // 성공 시 로직을 구현해 주세요. (overlayMode 에 따라 오버레이 표시/숨김)
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }

    // ageRatingInfo 는 Destroy() 를 호출하지 않아요.
}

Notes

  • 베트남 전용 API 이며, 1회성 콜백이므로 렌더링이 가능한 시점 이후에 호출해야 해요.
  • OverlayMode 는 EStoveOverlayMode 값을 사용해요.

See Also


IStoveVietnamOverimmersionInfo

종류 구조체 · 모듈 Base · 버전 3.5.0

Description

Stove_VietnamOverimmersionNotification() 콜백으로 전달되는 과몰입 방지 고지 오버레이 정보예요. 베트남 전용 API 예요.

오버레이 표시 상태와 형태, 크기/위치, 게임 연령등급, 경고 메시지(일반/스타일 적용)를 담아요. SDK 가 만들어 콜백 인자로만 전달하며, 호출자는 해제하지 않아요.

1회성 콜백이므로 렌더링이 가능한 시점 이후에 호출해야 해요.

Declaration

c
typedef struct IStoveVietnamOverimmersionInfo IStoveVietnamOverimmersionInfo;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용해요.

Members

NameTypeAccessAccessorDescription
OverlayModeint32_t읽기Stove_IStoveVietnamOverimmersionInfo_GetOverlayMode()오버레이 표시 상태예요(SHOW: 오버레이 표시, HIDE: 오버레이 숨김). EStoveOverlayMode 값이에요.
OverlayTypeint32_t읽기Stove_IStoveVietnamOverimmersionInfo_GetOverlayType()오버레이 유형이에요(0=Black: 어두운 배경(RGB(33,33,33))에 흰 글자, 1=White: 흰 배경(RGB(255,255,255))에 검은 글자, 기본값은 White).
OverlayScalefloat읽기Stove_IStoveVietnamOverimmersionInfo_GetOverlayScale()오버레이 크기 비율이에요(0.0 ~ 1.0).
OverlayOpacityfloat읽기Stove_IStoveVietnamOverimmersionInfo_GetOverlayOpacity()오버레이 불투명도예요(0.0 ~ 1.0).
AgeRatingint32_t읽기Stove_IStoveVietnamOverimmersionInfo_GetAgeRating()게임 연령등급이에요(0=전체이용가, 12=12세, 16=16세, 18=18세).
Msgconst wchar_t*읽기Stove_IStoveVietnamOverimmersionInfo_GetMsg()과몰입 경고 메시지예요.
StyledMsgconst wchar_t*읽기Stove_IStoveVietnamOverimmersionInfo_GetStyledMsg()<b>, <color=#RRGGBBAA> 등 마크업 태그가 포함된 스타일(번역) 경고 메시지예요. 리치 텍스트 렌더링에 사용해요.
ElapsedMinutesint32_t읽기Stove_IStoveVietnamOverimmersionInfo_GetElapsedMinutes()게임 누적 이용 시간(분 단위)예요.
ExposureTimeint32_t읽기Stove_IStoveVietnamOverimmersionInfo_GetExposureTime()메시지 노출 시간(초)예요.
ExpandAnimationTimefloat읽기Stove_IStoveVietnamOverimmersionInfo_GetExpandAnimationTime()Show → Expand 전환 시 오버레이가 확장되는 애니메이션 시간(초)예요.
DisplayPositionXfloat읽기Stove_IStoveVietnamOverimmersionInfo_GetDisplayPositionX()메시지 표시 위치의 x 좌표예요. 화면 왼쪽 기준(0.0 ~ 1.0).
DisplayPositionYfloat읽기Stove_IStoveVietnamOverimmersionInfo_GetDisplayPositionY()메시지 표시 위치의 y 좌표예요. 화면 위쪽 기준(0.0 ~ 1.0).
Languageconst wchar_t*읽기Stove_IStoveVietnamOverimmersionInfo_GetLanguage()폰트 선택을 위한 언어 코드예요(예: L"ko", L"en", L"ja", L"vi", L"zh-cn", L"zh-tw", L"th").

Memory Management

ItemValue
생성 주체SDK
해제 책임SDK: 콜백 인자로만 전달되며 콜백이 끝나면 무효처리돼요. 호출자는 Destroy() 를 호출하지 않아요.

Example

c
void __cdecl OnVietnamOverimmersionNotificationCallback(const IStoveCallbackResult* callbackResult, const IStoveVietnamOverimmersionInfo* overimmersionInfo)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    if (Stove_IStoveResult_GetResultCode(result) == k_EStoveCommonResultCode_Success)
    {
        int32_t overlayMode = Stove_IStoveVietnamOverimmersionInfo_GetOverlayMode(overimmersionInfo);
        const wchar_t* styledMsg = Stove_IStoveVietnamOverimmersionInfo_GetStyledMsg(overimmersionInfo);
        // 성공 시 로직을 구현해 주세요. (overlayMode 에 따라 오버레이 표시/숨김/확장)
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }

    // overimmersionInfo 는 Destroy() 를 호출하지 않아요.
}

Notes

  • 베트남 전용 API 이며, 1회성 콜백이므로 렌더링이 가능한 시점 이후에 호출해야 해요.
  • OverlayMode 는 EStoveOverlayMode 값을 사용하며, k_EStoveOverlayMode_Expanded(확장 표시)도 지원해요.
  • ElapsedMinutes 단위는 분(minute)예요. 시간(hour) 단위인 IStoveOverImmersionInfo 의 ElapsedHours 와 혼동하지 않도록 주의해요.

See Also


IStoveWebViewLayoutParam

종류 구조체 · 모듈 IAP · 버전 3.5.0

Description

IStovePurchaseParam, IStoveFetchTermsAgreementParam, IStoveWithdrawGameParam 세 파라미터 타입이 공통으로 상속하는 웹뷰 배치 필드 모음이에요.

이 타입은 Stove_CreateParam() 으로 단독 생성할 수 있는 종류가 아니에요(대응하는 EStoveIAPTypeKind 값이 없어요). 항상 위 세 구체 타입 중 하나의 베이스로만 존재하며, 값을 읽고 쓸 때도 구체 타입 각각의 flat 접근 함수(예: Stove_IStovePurchaseParam_GetWebViewMode())를 사용해요. Stove_IStoveWebViewLayoutParam_* 형태의 접근 함수는 없어요.

Declaration

c
// 추상 공유 베이스예요. 단독 typedef 나 Stove_CreateParam() 대상이 아니에요.
// 실제 사용은 아래 구체 타입 문서를 참고해 주세요.

Members

NameTypeDescription
WebViewModeEStoveWebViewMode웹뷰 표시 모드 (외부 브라우저 / SDK 내장 웹뷰)
WebViewPosXint32_t웹뷰 x 좌표 (픽셀)
WebViewPosYint32_t웹뷰 y 좌표 (픽셀)
WebViewWidthint32_t웹뷰 너비 (픽셀)
WebViewHeightint32_t웹뷰 높이 (픽셀)

이 멤버들에 대한 접근 함수·필수 여부는 실제로 사용하는 구체 타입 문서(IStovePurchaseParam, IStoveFetchTermsAgreementParam, IStoveWithdrawGameParam)의 멤버 표를 참고해 주세요.

Memory Management

이 타입은 단독으로 생성·해제되지 않아요. 항상 구체 타입(IStovePurchaseParam 등)의 일부로 함께 생성되고 해제돼요. 해제 방법은 각 구체 타입 문서를 참고해 주세요.

Example

c
// IStoveWebViewLayoutParam 은 직접 생성하지 않아요.
// 아래처럼 구체 타입을 통해 상속된 필드를 사용해요.
IStovePurchaseParam* purchaseParam = (IStovePurchaseParam*)Stove_CreateParam(k_EStoveIAPTypeKind_PurchaseParam);
Stove_IStovePurchaseParam_SetWebViewMode(purchaseParam, k_EStoveWebViewMode_Internal);
Stove_IStovePurchaseParam_SetWebViewWidth(purchaseParam, 480);
Stove_IStovePurchaseParam_SetWebViewHeight(purchaseParam, 640);

Notes

  • IStovePurchaseParam, IStoveFetchTermsAgreementParam 에서는 이 필드들이 각 타입의 Operation 값이 Default 가 아닐 때만 적용돼요.
  • IStoveWithdrawGameParam 에는 Operation 이 없어 이 필드들이 항상 적용돼요.

See Also


Stove_AccessTokenRenewed

종류 함수 · 모듈 Base · 버전 3.5.0

Description

AccessToken이 갱신될 때 새로 발급된 토큰을 콜백으로 전달해요. 토큰이 갱신되는 시점에 맞춰 별도 작업이 필요할 때 사용해요.

Declaration

c
void Stove_AccessTokenRenewed(const IStoveTypeBase* param, OnAccessTokenRenewedCallback onFinished, void* userData);

Parameters

NameTypeRequiredDescription
paramconst IStoveTypeBase*N예약된 인자로, 전용 ...Param TypeKind는 정의되어 있지 않아요.
onFinishedOnAccessTokenRenewedCallbackY결과를 받을 콜백이에요.
userDatavoid*N콜백에 그대로 전달되는 사용자 데이터예요.

Returns

없음

이 함수의 메서드 코드는 k_EStoveBaseMethodCode_AccessTokenRenewed 예요.

Callback

c
typedef void(__cdecl* OnAccessTokenRenewedCallback)(const IStoveCallbackResult* callbackResult, const IStoveAccessToken* token);
NameTypeDescription
callbackResultconst IStoveCallbackResult*호출 결과예요.
tokenconst IStoveAccessToken*새로 발급된 토큰 정보예요. Stove_IStoveAccessToken_GetAccessToken(), Stove_IStoveAccessToken_GetExpireIn()으로 조회해요.

콜백은 Stove_RunCallback()을 호출한 스레드에서 실행돼요. AccessToken이 갱신될 때마다 반복해서 전달돼요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
5k_EStoveCommonResultCode_InvalidParamonFinished가 nullptr이에요.x
16k_EStoveCommonResultCode_BaseNotInitialized초기화되지 않은 상태에서 호출했어요.x
253k_EStoveCommonResultCode_UnmanagedException실행 중 알 수 없는 예외가 발생했어요.O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 예외가 발생했어요.O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

하위 계층(토큰 처리 로직)에서 k_EStoveResultCode_RenewTokenMaxRetryCountExceeded(306) 또는 k_EStoveCommonResultCode_Fail(1)이 전달될 수 있어요.

전체 목록: EStoveCommonResultCode, EStoveResultCode

Memory Management

ObjectOwnerRelease
param호출자전달했다면 Stove_IStoveTypeBase_Destroy() 필수
콜백의 callbackResult, tokenSDK해제 금지. 콜백이 끝나면 무효처리돼요

Example

c
Stove_AccessTokenRenewed(nullptr, [](const IStoveCallbackResult* callbackResult, const IStoveAccessToken* token)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);
    if (Stove_IStoveResult_IsSuccessful(result))
    {
        // 성공 시 로직을 구현해 주세요.
        const wchar_t* newAccessToken = Stove_IStoveAccessToken_GetAccessToken(token);
        int32_t expireIn = Stove_IStoveAccessToken_GetExpireIn(token);
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}, nullptr);

Notes

  • 토큰이 갱신될 때마다 반복해서 호출되는 콜백이에요. 1회성 콜백이 아니에요.
  • 매번 최신 토큰이 필요하지 않다면 Stove_GetAccessToken으로 그때그때 조회해도 돼요.

See Also


Stove_CloseAllPopups

종류 함수 · 모듈 Base · 버전 3.5.0

Description

SDK가 띄운 모든 팝업을 닫아요. IAP 팝업과 View 팝업이 모두 대상이에요.

단일바이너리(BaseSDK Consolidation) 통합 이후, 모듈별로 따로 있던 Stove_IAP_CloseAllPopups() / Stove_View_CloseAllPopups()를 이 함수 하나로 대체해요. 이제 한 번의 호출로 SDK의 모든 팝업이 함께 닫혀요.

Declaration

c
IStoveResult* Stove_CloseAllPopups();

Parameters

없음

Returns

TypeDescription
IStoveResult*호출 결과예요. Stove_IStoveResult_IsSuccessful(result)이면 성공이에요.

이 함수의 메서드 코드는 k_EStoveBaseMethodCode_CloseAllPopups 예요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공(IAP · View 팝업 닫기 모두 성공)x
68k_EStoveCommonResultCode_CloseAllPopupsFailedIAP 또는 View 중 하나 이상의 팝업 닫기 처리가 실패함(구체적인 원인 코드는 이 값 하나로 정규화되어 노출되지 않음)x
253k_EStoveCommonResultCode_UnmanagedException실행 중 알 수 없는 예외가 발생함O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 내부 예외가 발생함O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

이 함수는 내부적으로 IAP 모듈과 View 모듈의 팝업 닫기를 항상 모두 수행해요. 두 결과 중 하나라도 실패했다면(IAP 우선 검사) 그 결과를 채택하고, 채택된 결과 코드가 성공(0) · UnmanagedException(253) · ManagedException(254) 이 아닌 그 외의 모든 실패는 CloseAllPopupsFailed(68) 하나로 정규화되어 반환돼요. 즉 View · IAP 각 모듈이 실제로 어떤 원인으로 실패했는지(예: 웹뷰 미초기화, 팝업 데이터 없음 등)는 이 함수의 반환값만으로는 구분할 수 없어요.

전체 목록: EStoveCommonResultCode, EStoveResultCode

Memory Management

ObjectOwnerRelease
반환된 IStoveResult*호출자Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result) 필수

Example

c
IStoveResult* result = Stove_CloseAllPopups();
if (Stove_IStoveResult_IsSuccessful(result))
{
    // 성공 시 로직을 구현해 주세요.
}
else
{
    // 실패 시 로직을 구현해 주세요.
}

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result);

Notes

  • 단일바이너리 통합 이후 IAP 팝업과 View 팝업을 한 번의 호출로 모두 닫아요. 두 모듈 모두 항상 시도되며, 실패 시 반환되는 결과 코드는 CloseAllPopupsFailed(68) 하나로 정규화돼요.
  • 이 함수는 동기 함수이며 콜백을 받지 않아요.

Stove_ConfirmPurchase

종류 함수 · 모듈 IAP · 버전 3.5.0

Description

Stove_StartPurchase의 Operation(EStovePurchaseOperation) 값이 WithWebViewAndConfirmResult가 아닌 경우, 결제 완료 후 이 함수를 호출해 구매를 확정해요. param에는 Stove_StartPurchase 결과로 받은 IStoveStartPurchaseOutcome::GetTxnMasterNo() 값을 설정해요.

확정 결과는 onFinished 콜백으로 전달되며, 확정 여부와 함께 구매한 상품 목록·결제에 사용된 화폐(차지) 정보가 함께 전달돼요.

Declaration

c
void Stove_ConfirmPurchase(const IStoveConfirmPurchaseParam* param, OnConfirmPurchaseCallback onFinished, void* userData);

Parameters

NameTypeRequiredDescription
paramconst IStoveConfirmPurchaseParam*Y확정할 거래의 마스터 번호(TxnMasterNo) 파라미터예요.
onFinishedOnConfirmPurchaseCallbackY확정 결과를 받을 콜백이에요.
userDatavoid*N콜백에 그대로 전달되는 사용자 데이터예요.

Returns

없음

이 함수의 메서드 코드는 k_EStoveIAPMethodCode_ConfirmPurchase 예요.

Callback

c
typedef void(__cdecl* OnConfirmPurchaseCallback)(const IStoveCallbackResult* callbackResult, const IStoveConfirmPurchaseOutcome* outcome);
NameTypeDescription
callbackResultconst IStoveCallbackResult*호출 결과예요.
outcomeconst IStoveConfirmPurchaseOutcome*확정 결과예요. Stove_IStoveConfirmPurchaseOutcome_IsConfirmed()로 최종 확정 여부를, GetPurchasedProductCount()/GetPurchasedProductAt(), GetChargeInfoCount()/GetChargeInfoAt()로 구매 상품·화폐 정보를 조회해요.

콜백은 Stove_RunCallback()을 호출한 스레드에서 실행돼요. 호출 1건당 1회만 전달돼요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
17k_EStoveCommonResultCode_NotInitialized결제 기능이 초기화되지 않았어요.x
21k_EStoveCommonResultCode_NullEntity표시 언어 정보가 준비되지 않았어요(Stove_SetLanguage 호출 여부 확인).x
253k_EStoveCommonResultCode_UnmanagedException실행 중 관리되지 않는 예외가 발생했어요.O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 관리되는 예외가 발생했어요(로그인 토큰 등 내부 엔티티 누락 포함).O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

네트워크/서버 응답 오류는 하위 HTTP 계층에서 전달돼요.

전체 목록: EStoveCommonResultCode, EStoveResultCode

Memory Management

ObjectOwnerRelease
param호출자Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param) 필수. 호출이 반환된 뒤 해제해요.
콜백의 callbackResultSDK해제 금지. 콜백이 끝나면 무효처리돼요.
콜백의 outcome(및 그 안의 각 IStovePurchasedProduct, IStoveChargeInfo)SDK해제 금지. 콜백이 끝나면 무효처리되며, 필요한 값은 콜백 안에서 복사해 두어야 해요.

Example

c
// 외부플랫폼연동모듈(스팀) 인증 경로로 PCSDK를 기동했다면 true. SDK는 이때 넘긴 SteamUserId 로 스팀 결제 동선을 고르므로 같은 시점에 함께 세워 주세요.
static bool g_isSteamPayment = false;

void __cdecl OnConfirmPurchaseFinished(const IStoveCallbackResult* callbackResult, const IStoveConfirmPurchaseOutcome* outcome)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);
    if (!Stove_IStoveResult_IsSuccessful(result))
    {
        // 호출 실패. Stove_IStoveCallbackResult_GetExternalError() 로 원인을 확인해 주세요. (스팀 미승인은 22001)
        return;
    }

    if (g_isSteamPayment || Stove_IStoveConfirmPurchaseOutcome_IsConfirmed(outcome))
    {
        // 구매 확정. 스팀런처 동선은 IsConfirmed 가 항상 false 로 오므로 호출 성공을 확정으로 봐요.
        // 스팀런처 동선은 PurchasedProducts 가 비어 오므로 StartPurchase 때 보관한 상품 정보를 사용해 주세요.
        uint32_t count = Stove_IStoveConfirmPurchaseOutcome_GetPurchasedProductCount(outcome);
        for (uint32_t i = 0; i < count; ++i)
        {
            const IStovePurchasedProduct* purchasedProduct = Stove_IStoveConfirmPurchaseOutcome_GetPurchasedProductAt(outcome, i);
            int64_t productId = Stove_IStovePurchasedProduct_GetProductId(purchasedProduct);
        }
        return;
    }

    // 스토브런처 동선 미확정(취소·결제 전·서버 반영 전). 지급하지 말고, 결제창을 닫은 직후라면 5초 뒤 한 번만 다시 조회해 주세요.
}

// 호출 (txnMasterNo 는 Stove_StartPurchase() 결과의 IStoveStartPurchaseOutcome::GetTxnMasterNo() 값)
IStoveConfirmPurchaseParam* param = (IStoveConfirmPurchaseParam*)Stove_CreateParam(k_EStoveIAPTypeKind_ConfirmPurchaseParam);
Stove_IStoveConfirmPurchaseParam_SetTxnMasterNo(param, txnMasterNo);

Stove_ConfirmPurchase(param, OnConfirmPurchaseFinished, nullptr);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param);

Notes

  • 이 함수는 비동기 함수이며 결과는 onFinished 콜백으로만 전달돼요.
  • Stove_StartPurchase의 Operation이 WithWebViewAndConfirmResult인 경우에는 SDK가 이 함수를 자동으로 호출하므로 별도로 호출할 필요가 없어요.
  • callbackResult의 성공 여부와 outcome의 IsConfirmed()는 별개예요. 호출 자체가 성공했더라도 IsConfirmed()가 false이면 구매가 최종 확정되지 않은 상태예요.
  • 스팀런처 동선에서는 IsConfirmed()가 서버 응답과 무관하게 항상 false로 전달돼요. 이 동선에서는 호출 성공(IsSuccessful이 참)을 구매 확정으로 보고, PurchasedProducts·ChargeInfos는 빈 배열로 오므로 참조하지 마세요. 스토브런처와 스팀런처를 한 조건으로 판정하는 방법은 위 예제와 결제 가이드의 스팀 결제 절을 참고하세요.
  • 옛 인터페이스에서는 이 결과가 status·purchasedProducts·chargeInfos 등 개별 인자로 전달되었어요. 현재는 이를 감싼 IStoveConfirmPurchaseOutcome 하나로 전달돼요.

See Also


Stove_CreateParam

종류 함수 · 모듈 Base · 버전 3.5.0

Description

Stove_CreateParam은 SDK의 모든 모듈이 공유하는 단일 객체 생성 창구예요. kind로 전달한 값에 대응하는 IStoveTypeBase 파생 객체를 생성해서 돌려줘요.

kind에는 모듈에 상관없이 아무 EStove*TypeKind 값이나 전달할 수 있어요. 각 모듈의 TypeKind 열거형은 정수 범위가 서로 겹치지 않게 나뉘어 있어서, 이 함수 하나로 어떤 모듈의 타입이든 구분해서 생성할 수 있어요(예: k_EStoveBaseTypeKind_InitializeParam, k_EStoveIAPTypeKind_FetchProductsParam). 다만 각 모듈의 ...Param 계열 TypeKind만 유효한 값이며, 결과/데이터 계열(Outcome·Info·List) TypeKind나 알 수 없는 값을 전달해도 오류로 처리되지 않고 nullptr을 반환해요.

단일바이너리(BaseSDK Consolidation) 통합 이후, 모듈별로 따로 있던 Stove_<Module>CreateParam() 팩토리 함수들이 이 함수 하나로 대체되었어요.

Declaration

c
IStoveTypeBase* Stove_CreateParam(int kind);

Parameters

NameTypeRequiredDescription
kindintY생성할 객체의 종류를 지정하는 EStove*TypeKind 값이에요. Base 모듈의 경우 EStoveBaseTypeKind의 ...Param 계열 값(예: k_EStoveBaseTypeKind_InitializeParam)을 전달해요.

Returns

TypeDescription
IStoveTypeBase*생성된 객체 포인터예요. kind 값이 ...Param 계열이 아니거나 알 수 없으면 nullptr을 반환해요. 항상 nullptr 여부를 확인한 뒤, 요청한 타입으로 캐스팅해서 사용해요(예: (IStoveInitializeParam*)).

Error Codes

없음. 이 함수는 IStoveResult를 반환하지 않는 순수 팩토리 함수이며, 실패는 반환값이 nullptr인지로만 판단해요. 개별 오류코드는 존재하지 않아요.

Memory Management

ObjectOwnerRelease
반환된 IStoveTypeBase*호출자Stove_IStoveTypeBase_Destroy() 필수

Example

c
IStoveTypeBase* base = Stove_CreateParam(k_EStoveBaseTypeKind_InitializeParam);
if (base != nullptr)
{
    IStoveInitializeParam* initParam = (IStoveInitializeParam*)base;

    Stove_IStoveInitializeParam_SetShopKey(initParam, L"YOUR_SHOP_KEY");
    Stove_IStoveInitializeParam_SetMainWndHandle(initParam, hWnd);

    // initParam을 사용한 뒤에는 반드시 Destroy 해요.
    Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)initParam);
}
else
{
    // kind 값이 잘못되었을 때의 처리 로직을 구현해 주세요.
}

Notes

  • kind에 어떤 값을 넣을 수 있는지는 각 모듈의 TypeKind 문서를 참조해요. Base 모듈은 EStoveBaseTypeKind를 참조해요.
  • 이 함수로 생성한 객체는 모두 사용 후 Stove_IStoveTypeBase_Destroy()로 해제해야 해요.

See Also


Stove_FetchAchievement

종류 함수 · 모듈 GameSupport · 버전 3.5.0

Description

Stove_FetchAchievement()는 지정한 업적(Achievement) ID의 진행 상황과 상세 정보를 조회하는 함수예요. 조회 결과는 onFinished 콜백으로 전달돼요.

통계·업적 기능은 별도의 초기화 절차를 두지 않고 SDK 초기화에 생명주기가 종속돼요. Stove_Initialize()가 성공한 이후에 호출해요.

Declaration

c
void Stove_FetchAchievement(const IStoveFetchAchievementParam* param, OnGetAchievementCallback onFinished, void* userData);

Parameters

NameTypeRequiredDescription
paramconst IStoveFetchAchievementParam*Y조회할 업적 ID를 담은 파라미터. Stove_CreateParam(k_EStoveGameSupportTypeKind_FetchAchievementParam)으로 생성해요
onFinishedOnGetAchievementCallbackY조회 결과를 받을 콜백
userDatavoid*N콜백에 그대로 전달되는 사용자 데이터

Returns

없음 (void)

이 함수의 메서드 코드는 k_EStoveGameSupportMethodCode_FetchAchievement 예요.

Callback

c
typedef void(__cdecl* OnGetAchievementCallback)(const IStoveCallbackResult* callbackResult, const IStoveAchievement* achievement);
NameTypeDescription
callbackResultconst IStoveCallbackResult*호출 결과
achievementconst IStoveAchievement*조회된 업적 정보

이 콜백은 Stove_RunCallback()을 호출한 스레드에서 실행돼요. Stove_FetchAchievement() 호출 1건당 1회만 전달돼요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
5k_EStoveCommonResultCode_InvalidParamparam의 업적 ID(AchievementId)가 빈 문자열x
253k_EStoveCommonResultCode_UnmanagedException처리 중 알 수 없는 예외 발생O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException처리 중 내부 예외 발생(엔티티 조회 실패 등)O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

HTTP 통신 실패에 해당하는 코드(HttpError=22, ResponseError=23, ResponseInvalidCode=24, ResponseValueIsNull=25, ResponseInvalidValueFormat=26, NetworkTransportError=249)는 이 함수가 직접 설정하지 않고 하위 통신 계층에서 전달돼요.

구 인터페이스(GameSupport_Achievement)는 모듈이 초기화되지 않았을 때 NotInitialized(17)를 반환하는 별도 게이트를 갖고 있지만, 신규 flat C 표면인 Stove_FetchAchievement()에는 이 게이트가 없어요. 즉 이 함수는 17을 반환하지 않아요.

전체 목록: EStoveCommonResultCode

Memory Management

ObjectOwnerRelease
param호출자Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param) 필수 (Stove_FetchAchievement() 호출이 반환된 이후 바로 해제 가능)
콜백의 callbackResultSDK해제 금지. 콜백이 끝나면 무효처리돼요
콜백의 achievementSDK해제 금지. 콜백이 끝나면 무효처리돼요

Example

c
void OnFetchAchievementFinished(const IStoveCallbackResult* callbackResult, const IStoveAchievement* achievement)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    if (Stove_IStoveResult_IsSuccessful(result) && achievement != NULL)
    {
        const wchar_t* status = Stove_IStoveAchievement_GetStatus(achievement);

        // 성공 시 로직을 구현해 주세요.
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

IStoveFetchAchievementParam* param =
    (IStoveFetchAchievementParam*)Stove_CreateParam(k_EStoveGameSupportTypeKind_FetchAchievementParam);
Stove_IStoveFetchAchievementParam_SetAchievementId(param, L"FIRST_WIN");

Stove_FetchAchievement(param, OnFetchAchievementFinished, NULL);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param);

Notes

  • 이 함수는 초기화 여부를 검사하지 않고 곧바로 하위 로직을 수행해요. 미초기화 상태에서 호출하면 ManagedException(254)으로 귀결될 수 있어요.
  • 로그인한 사용자의 업적 전체 목록을 조회하려면 Stove_FetchAchievements를 사용해요.
  • 통계·업적 기능은 스토어 전용이에요.

See Also


Stove_FetchAchievements

종류 함수 · 모듈 GameSupport · 버전 3.5.0

Description

Stove_FetchAchievements()는 현재 로그인한 사용자의 전체 업적 정보를 조회하는 함수예요. 조회 결과는 onFinished 콜백으로 전달돼요.

v3.5.0 에서는 페이지 단위 조회를 사용하지 마세요. AchievementId · PageSize 를 채우지 않고 호출하면 기존과 같이 전체 업적 목록이 한 번에 조회돼요. 페이지 단위 조회는 서버 API 규격이 확정된 뒤 v3.5.1 부터 제공돼요.

통계·업적 기능은 별도의 초기화 절차를 두지 않고 SDK 초기화에 생명주기가 종속돼요. Stove_Initialize()가 성공한 이후에 호출해요.

Declaration

c
void Stove_FetchAchievements(const IStoveFetchAchievementsParam* param, OnGetAchievementsCallback onFinished, void* userData);

Parameters

NameTypeRequiredDescription
paramconst IStoveFetchAchievementsParam*Y조회 파라미터. Stove_CreateParam(k_EStoveGameSupportTypeKind_FetchAchievementsParam)으로 생성해요. v3.5.0 에서는 값을 채우지 않고 그대로 넘겨요
onFinishedOnGetAchievementsCallbackY조회 결과를 받을 콜백
userDatavoid*N콜백에 그대로 전달되는 사용자 데이터

Returns

없음 (void)

이 함수의 메서드 코드는 k_EStoveGameSupportMethodCode_FetchAchievements 예요.

Callback

c
typedef void(__cdecl* OnGetAchievementsCallback)(const IStoveCallbackResult* callbackResult, const IStoveAchievementList* list);
NameTypeDescription
callbackResultconst IStoveCallbackResult*호출 결과
listconst IStoveAchievementList*조회된 업적 목록

이 콜백은 Stove_RunCallback()을 호출한 스레드에서 실행돼요. Stove_FetchAchievements() 호출 1건당 1회만 전달돼요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
253k_EStoveCommonResultCode_UnmanagedException처리 중 알 수 없는 예외 발생O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException처리 중 내부 예외 발생(엔티티 조회 실패 등)O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

HTTP 통신 실패에 해당하는 코드(HttpError=22, ResponseError=23, ResponseInvalidCode=24, ResponseValueIsNull=25, ResponseInvalidValueFormat=26, NetworkTransportError=249)는 이 함수가 직접 설정하지 않고 하위 통신 계층에서 전달돼요.

param의 필드(AchievementId, PageSize) 값에는 별도의 InvalidParam(5) 검증이 적용되지 않아요, 값을 넣지 않으면 오류 없이 전체 목록이 조회돼요.

구 인터페이스(GameSupport_AllAchievement)는 모듈이 초기화되지 않았을 때 NotInitialized(17)를 반환하는 별도 게이트를 갖고 있지만, 신규 flat C 표면인 Stove_FetchAchievements()에는 이 게이트가 없어요. 즉 이 함수는 17을 반환하지 않아요.

전체 목록: EStoveCommonResultCode

Memory Management

ObjectOwnerRelease
param호출자Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param) 필수 (Stove_FetchAchievements() 호출이 반환된 이후 바로 해제 가능)
콜백의 callbackResultSDK해제 금지. 콜백이 끝나면 무효처리돼요
콜백의 list(및 그 안의 각 업적 항목)SDK해제 금지. 콜백이 끝나면 무효처리돼요

Example

c
void OnFetchAchievementsFinished(const IStoveCallbackResult* callbackResult, const IStoveAchievementList* list)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    if (Stove_IStoveResult_IsSuccessful(result) && list != NULL)
    {
        uint32_t count = Stove_IStoveAchievementList_GetCount(list);
        for (uint32_t i = 0; i < count; ++i)
        {
            const IStoveAchievement* achievement = Stove_IStoveAchievementList_GetAt(list, i);
            // 성공 시 로직을 구현해 주세요.
        }
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

IStoveFetchAchievementsParam* param =
    (IStoveFetchAchievementsParam*)Stove_CreateParam(k_EStoveGameSupportTypeKind_FetchAchievementsParam);
// v3.5.0 에서는 값을 채우지 않고 그대로 넘겨요.

Stove_FetchAchievements(param, OnFetchAchievementsFinished, NULL);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param);

Notes

  • 이 함수는 초기화 여부를 검사하지 않고 곧바로 하위 로직을 수행해요. 미초기화 상태에서 호출하면 ManagedException(254)으로 귀결될 수 있어요.
  • 특정 업적 하나만 조회하려면 Stove_FetchAchievement를 사용해요.
  • v3.5.0 에서는 AchievementId · PageSize 를 채우지 마세요. 값을 넣지 않으면 전체 업적 목록이 한 번에 조회돼요.
  • 두 값을 쓰는 페이지 단위 조회는 서버 API 규격 확정 뒤 v3.5.1 부터 제공돼요.
  • 통계·업적 기능은 스토어 전용이에요.

See Also


Stove_FetchInventory

종류 함수 · 모듈 IAP · 버전 3.5.0

Description

현재 로그인한 사용자의 구매 내역을 조회해요. 조회된 인벤토리 항목 목록은 onFinished 콜백으로 IStoveInventoryList 형태로 전달돼요.

Declaration

c
void Stove_FetchInventory(const IStoveTypeBase* param, OnFetchInventoryCallback onFinished, void* userData);

Parameters

NameTypeRequiredDescription
paramconst IStoveTypeBase*N예약된 매개변수예요. 현재 사용되지 않으므로 항상 nullptr을 전달해요.
onFinishedOnFetchInventoryCallbackY인벤토리 항목 목록을 받을 콜백이에요.
userDatavoid*N콜백에 그대로 전달되는 사용자 데이터예요.

Returns

없음

이 함수의 메서드 코드는 k_EStoveIAPMethodCode_FetchInventory 예요.

Callback

c
typedef void(__cdecl* OnFetchInventoryCallback)(const IStoveCallbackResult* callbackResult, const IStoveInventoryList* list);
NameTypeDescription
callbackResultconst IStoveCallbackResult*호출 결과예요.
listconst IStoveInventoryList*조회된 인벤토리 항목 목록이에요. Stove_IStoveInventoryList_GetCount() / Stove_IStoveInventoryList_GetAt()으로 순회해요.

콜백은 Stove_RunCallback()을 호출한 스레드에서 실행돼요. 호출 1건당 1회만 전달돼요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
17k_EStoveCommonResultCode_NotInitialized결제 기능이 초기화되지 않았어요.x
253k_EStoveCommonResultCode_UnmanagedException실행 중 관리되지 않는 예외가 발생했어요.O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 관리되는 예외가 발생했어요(로그인 토큰 등 내부 엔티티 누락 포함).O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

네트워크/서버 응답 오류는 하위 HTTP 계층에서 전달돼요.

전체 목록: EStoveCommonResultCode, EStoveResultCode

Memory Management

ObjectOwnerRelease
param호출자현재 사용되지 않는 예약 매개변수이므로 해제할 대상이 없어요.
콜백의 callbackResultSDK해제 금지. 콜백이 끝나면 무효처리돼요.
콜백의 list(및 그 안의 각 IStoveInventoryItem)SDK해제 금지. 콜백이 끝나면 무효처리되며, 필요한 값은 콜백 안에서 복사해 두어야 해요.

Example

c
void __cdecl OnFetchInventoryFinished(const IStoveCallbackResult* callbackResult, const IStoveInventoryList* list)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);
    if (Stove_IStoveResult_IsSuccessful(result))
    {
        // 성공 시 로직을 구현해 주세요.
        uint32_t count = Stove_IStoveInventoryList_GetCount(list);
        for (uint32_t i = 0; i < count; ++i)
        {
            const IStoveInventoryItem* item = Stove_IStoveInventoryList_GetAt(list, i);
            const wchar_t* productName = Stove_IStoveInventoryItem_GetProductName(item);
        }
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

// 호출
Stove_FetchInventory(nullptr, OnFetchInventoryFinished, nullptr);

Notes

  • 이 함수는 비동기 함수이며 결과는 onFinished 콜백으로만 전달돼요.
  • param은 현재 사용되지 않는 예약 매개변수이므로 항상 nullptr을 전달해요.

See Also


Stove_FetchOwnerships

종류 함수 · 모듈 Ownership · 버전 3.5.0

Description

현재 실행 중인 게임(기본 게임, DLC, 데모 등)에 대해 로그인한 사용자가 보유한 소유권 항목을 조회해요. 조회 결과는 IStoveOwnershipList 로 콜백에 전달돼요.

SDK 가 초기화된 뒤에 호출해야 해요.

Declaration

c
void Stove_FetchOwnerships(const IStoveTypeBase* param, OnOwnershipListCallback onFinished, void* userData);

Parameters

NameTypeRequiredDescription
paramconst IStoveTypeBase*N예약된 파라미터예요. 이 호출에는 전용 파라미터 타입이 없으므로 nullptr 을 전달해요.
onFinishedOnOwnershipListCallbackY조회 결과를 전달받을 콜백이에요.
userDatavoid*N콜백에 그대로 전달되는 사용자 데이터예요.

Returns

없음

이 함수의 메서드 코드는 k_EStoveOwnershipMethodCode_FetchOwnerships 예요.

Callback

c
typedef void(__cdecl* OnOwnershipListCallback)(const IStoveCallbackResult* callbackResult, const IStoveOwnershipList* ownerships);
NameTypeDescription
callbackResultconst IStoveCallbackResult*조회 호출 결과예요.
ownershipsconst IStoveOwnershipList*소유권 항목 목록이에요. GetCount() / GetAt() 으로 순회해요.

콜백은 Stove_RunCallback() 을 호출한 스레드에서 실행되며, Stove_FetchOwnerships() 호출 1회당 1회 전달돼요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
5k_EStoveCommonResultCode_InvalidParamonFinished 가 nullptr 이에요x
17k_EStoveCommonResultCode_NotInitializedSDK 가 초기화되지 않았어요(Operation 내부 체크)x
253k_EStoveCommonResultCode_UnmanagedException알 수 없는 예외가 발생했어요O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException처리된 예외가 발생했어요O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

그 밖의 HTTP/응답 관련 코드는 하위 계층에서 전달돼요.

전체 목록: EStoveCommonResultCode, EStoveResultCode

Memory Management

ObjectOwnerRelease
param호출자현재 사용하지 않는 예약 파라미터이므로 nullptr 을 전달하며 별도로 해제할 필요가 없어요.
콜백의 callbackResultSDK해제 금지. 콜백이 끝나면 무효처리돼요.
콜백의 ownerships 및 GetAt() 이 돌려주는 각 항목SDK해제 금지. 콜백이 끝나면 모두 무효처리돼요. 보관이 필요한 값은 콜백 안에서 복사하세요.

Example

c
void __cdecl OnFetchOwnerships(const IStoveCallbackResult* callbackResult, const IStoveOwnershipList* ownerships)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);
    if (Stove_IStoveResult_IsSuccessful(result))
    {
        uint32_t count = Stove_IStoveOwnershipList_GetCount(ownerships);
        for (uint32_t i = 0; i < count; ++i)
        {
            const IStoveOwnership* ownership = Stove_IStoveOwnershipList_GetAt(ownerships, i);
            if (ownership == nullptr)
            {
                continue;
            }

            const wchar_t* gameId = Stove_IStoveOwnership_GetGameId(ownership);
            int32_t ownershipCode = Stove_IStoveOwnership_GetOwnershipCode(ownership);

            // 성공 시 로직을 구현해 주세요.
        }
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Stove_FetchOwnerships(nullptr, OnFetchOwnerships, nullptr);

// 게임 루프 안에서 반복 호출해야 콜백이 실행돼요.
while (isGameRunning)
{
    Stove_RunCallback();
}

Notes

  • 이 함수는 비동기 함수이며, 결과는 콜백으로만 전달돼요.
  • param 은 현재 사용되지 않는 예약 슬롯이므로 nullptr 을 전달하면 돼요.
  • ownerships 는 배열 + 개수 형태의 out-parameter 가 아니라 GetCount()/GetAt() 을 갖춘 SDK 소유 목록 래퍼 타입이에요.

See Also


Stove_FetchProducts

종류 함수 · 모듈 IAP · 버전 3.5.0

Description

params로 전달한 카테고리 ID와 페이지 조건에 맞는 상품 목록을 조회해요. 조회된 상품 목록은 onFinished 콜백으로 IStoveProductList 형태로 전달돼요.

카테고리 ID를 비워두면 전체 카테고리의 상품을 조회해요. 특정 카테고리의 상품만 조회하려면 Stove_FetchShopCategories로 얻은 CategoryId를 필터로 지정해요.

Declaration

c
void Stove_FetchProducts(const IStoveFetchProductsParam* params, OnFetchProductsCallback onFinished, void* userData);

Parameters

NameTypeRequiredDescription
paramsconst IStoveFetchProductsParam*Y카테고리 필터·페이지 조건 파라미터예요.
onFinishedOnFetchProductsCallbackY상품 목록을 받을 콜백이에요.
userDatavoid*N콜백에 그대로 전달되는 사용자 데이터예요.

Returns

없음

이 함수의 메서드 코드는 k_EStoveIAPMethodCode_FetchProducts 예요.

Callback

c
typedef void(__cdecl* OnFetchProductsCallback)(const IStoveCallbackResult* callbackResult, const IStoveProductList* list);
NameTypeDescription
callbackResultconst IStoveCallbackResult*호출 결과예요.
listconst IStoveProductList*조회된 상품 목록이에요. Stove_IStoveProductList_GetCount() / Stove_IStoveProductList_GetAt()으로 순회해요.

콜백은 Stove_RunCallback()을 호출한 스레드에서 실행돼요. 호출 1건당 1회만 전달돼요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
17k_EStoveCommonResultCode_NotInitialized결제 기능이 초기화되지 않았어요.x
253k_EStoveCommonResultCode_UnmanagedException실행 중 관리되지 않는 예외가 발생했어요.O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 관리되는 예외가 발생했어요(로그인 토큰 등 내부 엔티티 누락 포함).O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

네트워크/서버 응답 오류는 하위 HTTP 계층에서 전달돼요.

전체 목록: EStoveCommonResultCode, EStoveResultCode

Memory Management

ObjectOwnerRelease
params호출자Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)params) 필수. 호출이 반환된 뒤 해제해요.
콜백의 callbackResultSDK해제 금지. 콜백이 끝나면 무효처리돼요.
콜백의 list(및 그 안의 각 IStoveProduct)SDK해제 금지. 콜백이 끝나면 무효처리되며, 필요한 값은 콜백 안에서 복사해 두어야 해요.

Example

c
void __cdecl OnFetchProductsFinished(const IStoveCallbackResult* callbackResult, const IStoveProductList* list)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);
    if (Stove_IStoveResult_IsSuccessful(result))
    {
        // 성공 시 로직을 구현해 주세요.
        uint32_t count = Stove_IStoveProductList_GetCount(list);
        for (uint32_t i = 0; i < count; ++i)
        {
            const IStoveProduct* product = Stove_IStoveProductList_GetAt(list, i);
            int64_t productId = Stove_IStoveProduct_GetProductId(product);
            const wchar_t* productName = Stove_IStoveProduct_GetProductName(product);
        }
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

// 호출
IStoveFetchProductsParam* params = (IStoveFetchProductsParam*)Stove_CreateParam(k_EStoveIAPTypeKind_FetchProductsParam);
Stove_IStoveFetchProductsParam_SetCategoryId(params, L"");
Stove_IStoveFetchProductsParam_SetPageIndex(params, 1);
Stove_IStoveFetchProductsParam_SetPageSize(params, 20);

Stove_FetchProducts(params, OnFetchProductsFinished, nullptr);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)params);

Notes

  • 이 호출은 상품 목록 조회의 확장 동작(구 인터페이스의 Ex 변형에 해당)을 수행해요.
  • 이 함수는 비동기 함수이며 결과는 onFinished 콜백으로만 전달돼요.
  • params는 Stove_CreateParam(k_EStoveIAPTypeKind_FetchProductsParam)으로 생성해요.
  • 조회된 상품의 ProductId는 Stove_StartPurchase 호출 시 주문 항목의 상품 식별자로 사용해요.

See Also


Stove_FetchRanking

종류 함수 · 모듈 GameSupport · 버전 3.5.0

Description

Stove_FetchRanking()은 지정한 리더보드(leaderboard)의 순위 정보를 페이지 단위로 조회하는 함수예요. 조회 결과는 onFinished 콜백으로 전달돼요.

통계·업적 기능은 별도의 초기화 절차를 두지 않고 SDK 초기화에 생명주기가 종속돼요. Stove_Initialize()가 성공한 이후에 호출해요.

Declaration

c
void Stove_FetchRanking(const IStoveFetchRankingParam* rankParams, OnGetRankingCallback onFinished, void* userData);

Parameters

NameTypeRequiredDescription
rankParamsconst IStoveFetchRankingParam*Y조회할 리더보드 ID와 페이징 조건을 담은 파라미터. Stove_CreateParam(k_EStoveGameSupportTypeKind_FetchRankingParam)으로 생성해요
onFinishedOnGetRankingCallbackY조회 결과를 받을 콜백
userDatavoid*N콜백에 그대로 전달되는 사용자 데이터

Returns

없음 (void)

이 함수의 메서드 코드는 k_EStoveGameSupportMethodCode_FetchRanking 예요.

Callback

c
typedef void(__cdecl* OnGetRankingCallback)(const IStoveCallbackResult* callbackResult, const IStoveRanking* ranking);
NameTypeDescription
callbackResultconst IStoveCallbackResult*호출 결과
rankingconst IStoveRanking*조회된 순위 목록(현재 페이지분)

이 콜백은 Stove_RunCallback()을 호출한 스레드에서 실행돼요. Stove_FetchRanking() 호출 1건당 1회만 전달돼요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
5k_EStoveCommonResultCode_InvalidParamrankParams의 리더보드 ID(LeaderboardId)가 빈 문자열x
253k_EStoveCommonResultCode_UnmanagedException처리 중 알 수 없는 예외 발생O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException처리 중 내부 예외 발생(엔티티 조회 실패 등)O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

HTTP 통신 실패에 해당하는 코드(HttpError=22, ResponseError=23, ResponseInvalidCode=24, ResponseValueIsNull=25, ResponseInvalidValueFormat=26, NetworkTransportError=249)는 이 함수가 직접 설정하지 않고 하위 통신 계층에서 전달돼요.

구 인터페이스(GameSupport_Rank)는 모듈이 초기화되지 않았을 때 NotInitialized(17)를 반환하는 별도 게이트를 갖고 있지만, 신규 flat C 표면인 Stove_FetchRanking()에는 이 게이트가 없어요. 즉 이 함수는 17을 반환하지 않아요.

전체 목록: EStoveCommonResultCode

Memory Management

ObjectOwnerRelease
rankParams호출자Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)rankParams) 필수 (Stove_FetchRanking() 호출이 반환된 이후 바로 해제 가능)
콜백의 callbackResultSDK해제 금지. 콜백이 끝나면 무효처리돼요
콜백의 ranking(및 그 안의 각 순위 항목)SDK해제 금지. 콜백이 끝나면 무효처리돼요

Example

c
void OnFetchRankingFinished(const IStoveCallbackResult* callbackResult, const IStoveRanking* ranking)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    if (Stove_IStoveResult_IsSuccessful(result) && ranking != NULL)
    {
        uint32_t count = Stove_IStoveRanking_GetCount(ranking);
        for (uint32_t i = 0; i < count; ++i)
        {
            const IStoveRank* rank = Stove_IStoveRanking_GetAt(ranking, i);
            // 성공 시 로직을 구현해 주세요.
        }
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

IStoveFetchRankingParam* rankParams =
    (IStoveFetchRankingParam*)Stove_CreateParam(k_EStoveGameSupportTypeKind_FetchRankingParam);
Stove_IStoveFetchRankingParam_SetLeaderboardId(rankParams, L"WEEKLY_SCORE");
Stove_IStoveFetchRankingParam_SetPageIndex(rankParams, 1);
Stove_IStoveFetchRankingParam_SetPageSize(rankParams, 50);
Stove_IStoveFetchRankingParam_SetIncludeMyRank(rankParams, true);

Stove_FetchRanking(rankParams, OnFetchRankingFinished, NULL);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)rankParams);

Notes

  • 이 함수는 초기화 여부를 검사하지 않고 곧바로 하위 로직을 수행해요. 미초기화 상태에서 호출하면 ManagedException(254)으로 귀결될 수 있어요.
  • PageIndex는 1부터 시작해요.
  • PageSize는 1 이상 50 이하로 지정해야 해요.
  • IncludeMyRank를 true로 설정하면 조회 결과에 로그인한 사용자의 순위가 포함돼요.
  • 통계·업적 기능은 스토어 전용이에요.

See Also


Stove_FetchShopCategories

종류 함수 · 모듈 IAP · 버전 3.5.0

Description

상점에 등록된 카테고리 목록을 조회해요. 조회된 카테고리 목록은 onFinished 콜백으로 IStoveShopCategoryList 형태로 전달돼요.

Stove_FetchProducts 호출 시 카테고리 ID로 상품을 필터링할 수 있으므로, 상점 화면을 구성할 때는 이 함수로 먼저 카테고리 목록을 받아온 뒤 각 카테고리에 속한 상품을 조회하는 순서로 사용해요.

Declaration

c
void Stove_FetchShopCategories(const IStoveTypeBase* param, OnFetchShopCategoriesCallback onFinished, void* userData);

Parameters

NameTypeRequiredDescription
paramconst IStoveTypeBase*N예약된 매개변수예요. 현재 사용되지 않으므로 항상 nullptr을 전달해요.
onFinishedOnFetchShopCategoriesCallbackY카테고리 목록을 받을 콜백이에요.
userDatavoid*N콜백에 그대로 전달되는 사용자 데이터예요.

Returns

없음

이 함수의 메서드 코드는 k_EStoveIAPMethodCode_FetchShopCategories 예요.

Callback

c
typedef void(__cdecl* OnFetchShopCategoriesCallback)(const IStoveCallbackResult* callbackResult, const IStoveShopCategoryList* list);
NameTypeDescription
callbackResultconst IStoveCallbackResult*호출 결과예요.
listconst IStoveShopCategoryList*조회된 카테고리 목록이에요. Stove_IStoveShopCategoryList_GetCount() / Stove_IStoveShopCategoryList_GetAt()으로 순회해요.

콜백은 Stove_RunCallback()을 호출한 스레드에서 실행돼요. 호출 1건당 1회만 전달돼요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
17k_EStoveCommonResultCode_NotInitialized결제 기능이 초기화되지 않았어요.x
253k_EStoveCommonResultCode_UnmanagedException실행 중 관리되지 않는 예외가 발생했어요.O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 관리되는 예외가 발생했어요(로그인 토큰 등 내부 엔티티 누락 포함).O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

네트워크/서버 응답 오류는 하위 HTTP 계층에서 전달돼요.

전체 목록: EStoveCommonResultCode, EStoveResultCode

Memory Management

ObjectOwnerRelease
param호출자현재 사용되지 않는 예약 매개변수이므로 해제할 대상이 없어요.
콜백의 callbackResultSDK해제 금지. 콜백이 끝나면 무효처리돼요.
콜백의 list(및 그 안의 각 IStoveShopCategory)SDK해제 금지. 콜백이 끝나면 무효처리되며, 필요한 값은 콜백 안에서 복사해 두어야 해요.

Example

c
void __cdecl OnFetchShopCategoriesFinished(const IStoveCallbackResult* callbackResult, const IStoveShopCategoryList* list)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);
    if (Stove_IStoveResult_IsSuccessful(result))
    {
        // 성공 시 로직을 구현해 주세요.
        uint32_t count = Stove_IStoveShopCategoryList_GetCount(list);
        for (uint32_t i = 0; i < count; ++i)
        {
            const IStoveShopCategory* category = Stove_IStoveShopCategoryList_GetAt(list, i);
            const wchar_t* categoryId = Stove_IStoveShopCategory_GetCategoryId(category);
            const wchar_t* categoryName = Stove_IStoveShopCategory_GetCategoryName(category);
        }
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

// 호출
Stove_FetchShopCategories(nullptr, OnFetchShopCategoriesFinished, nullptr);

Notes

  • 이 함수는 비동기 함수이며 결과는 onFinished 콜백으로만 전달돼요.
  • param은 현재 사용되지 않는 예약 매개변수이므로 항상 nullptr을 전달해요.
  • 조회된 카테고리의 CategoryId는 Stove_FetchProducts 호출 시 카테고리 필터로 사용할 수 있어요.

See Also


Stove_FetchStat

종류 함수 · 모듈 GameSupport · 버전 3.5.0

Description

Stove_FetchStat()은 지정한 통계(Stat) ID의 현재 값을 조회하는 함수예요. 조회 결과는 onFinished 콜백으로 전달돼요.

통계·업적 기능은 별도의 초기화 절차를 두지 않고 SDK 초기화에 생명주기가 종속돼요. Stove_Initialize()가 성공한 이후에 호출해요.

Declaration

c
void Stove_FetchStat(const IStoveFetchStatParam* param, OnGetStatCallback onFinished, void* userData);

Parameters

NameTypeRequiredDescription
paramconst IStoveFetchStatParam*Y조회할 통계 ID를 담은 파라미터. Stove_CreateParam(k_EStoveGameSupportTypeKind_FetchStatParam)으로 생성해요
onFinishedOnGetStatCallbackY조회 결과를 받을 콜백
userDatavoid*N콜백에 그대로 전달되는 사용자 데이터

Returns

없음 (void)

이 함수의 메서드 코드는 k_EStoveGameSupportMethodCode_FetchStat 예요.

Callback

c
typedef void(__cdecl* OnGetStatCallback)(const IStoveCallbackResult* callbackResult, const IStoveStat* stat);
NameTypeDescription
callbackResultconst IStoveCallbackResult*호출 결과
statconst IStoveStat*조회된 통계 정보

이 콜백은 Stove_RunCallback()을 호출한 스레드에서 실행돼요. Stove_FetchStat() 호출 1건당 1회만 전달돼요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
5k_EStoveCommonResultCode_InvalidParamparam의 통계 ID(StatsId)가 빈 문자열x
253k_EStoveCommonResultCode_UnmanagedException처리 중 알 수 없는 예외 발생O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException처리 중 내부 예외 발생(엔티티 조회 실패 등)O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

HTTP 통신 실패에 해당하는 코드(HttpError=22, ResponseError=23, ResponseInvalidCode=24, ResponseValueIsNull=25, ResponseInvalidValueFormat=26, NetworkTransportError=249)는 이 함수가 직접 설정하지 않고 하위 통신 계층에서 전달돼요.

구 인터페이스(GameSupport_Stat)는 모듈이 초기화되지 않았을 때 NotInitialized(17)를 반환하는 별도 게이트를 갖고 있지만, 신규 flat C 표면인 Stove_FetchStat()에는 이 게이트가 없어요. 즉 이 함수는 17을 반환하지 않아요.

전체 목록: EStoveCommonResultCode

Memory Management

ObjectOwnerRelease
param호출자Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param) 필수 (Stove_FetchStat() 호출이 반환된 이후 바로 해제 가능)
콜백의 callbackResultSDK해제 금지. 콜백이 끝나면 무효처리돼요
콜백의 statSDK해제 금지. 콜백이 끝나면 무효처리돼요

Example

c
void OnFetchStatFinished(const IStoveCallbackResult* callbackResult, const IStoveStat* stat)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    if (Stove_IStoveResult_IsSuccessful(result) && stat != NULL)
    {
        int32_t currentValue = Stove_IStoveStat_GetCurrentValue(stat);

        // 성공 시 로직을 구현해 주세요.
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

IStoveFetchStatParam* param =
    (IStoveFetchStatParam*)Stove_CreateParam(k_EStoveGameSupportTypeKind_FetchStatParam);
Stove_IStoveFetchStatParam_SetStatsId(param, L"KILL_COUNT");

Stove_FetchStat(param, OnFetchStatFinished, NULL);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param);

Notes

  • 이 함수는 초기화 여부를 검사하지 않고 곧바로 하위 로직을 수행해요. 미초기화 상태에서 호출하면 ManagedException(254)으로 귀결될 수 있어요.
  • 통계 값을 변경하려면 Stove_SetStat을 사용해요.
  • param의 통계 ID 형식은 [A-Z0-9\-_]*$(대문자, 숫자, 밑줄, 하이픈)이에요.
  • 통계·업적 기능은 스토어 전용이에요.

See Also


Stove_FetchTermsAgreement

종류 함수 · 모듈 IAP · 버전 3.5.0

Description

사용자가 현재 약관에 동의했는지 조회해요. 이미 동의한 경우 onFinished로 전달되는 결과의 IsAgreed()가 true이며 Url은 빈 문자열이에요. 동의하지 않은 경우 param의 Operation(EStoveTermsOperation) 값에 따라 동작이 달라져요.

  • Default : onFinished로 전달되는 Url을 이용해 호출자가 직접 약관 페이지를 열어야 해요.
  • WithWebView : SDK가 Stove Webview로 약관 페이지를 직접 표시해요.

웹뷰가 아예 생성되지 않고 호출이 종료되는 모든 실패(미초기화, 예외 등)에서 onDestroy가 PopupNotCreated(33)로 1회 함께 호출돼요. 자세한 내용은 오류코드와 콜백 항목을 참고하세요.

Declaration

c
void Stove_FetchTermsAgreement(const IStoveFetchTermsAgreementParam* param,
                                OnFetchTermsAgreementCallback onFinished, OnIAPPopupDestroyCallback onDestroy,
                                void* userData1, void* userData2);

Parameters

NameTypeRequiredDescription
paramconst IStoveFetchTermsAgreementParam*Y약관 조회 동작과 웹뷰 배치 파라미터예요.
onFinishedOnFetchTermsAgreementCallbackY동의 여부와 약관 URL을 받을 콜백이에요.
onDestroyOnIAPPopupDestroyCallbackNSDK가 만든 팝업이 모두 닫혔을 때 호출되는 콜백이에요.
userData1void*NonFinished에 그대로 전달되는 사용자 데이터예요.
userData2void*NonDestroy에 그대로 전달되는 사용자 데이터예요.

Returns

없음

이 함수의 메서드 코드는 k_EStoveIAPMethodCode_FetchTermsAgreement 예요.

Callback

c
typedef void(__cdecl* OnFetchTermsAgreementCallback)(const IStoveCallbackResult* callbackResult, const IStoveTermsAgreementOutcome* outcome);

typedef void(__cdecl* OnIAPPopupDestroyCallback)(const IStoveCallbackResult* callbackResult, const IStoveTypeBase* reserved);
NameTypeDescription
callbackResultconst IStoveCallbackResult*호출 결과예요.
outcomeconst IStoveTermsAgreementOutcome*동의 여부와 약관 URL이에요. Stove_IStoveTermsAgreementOutcome_IsAgreed() / Stove_IStoveTermsAgreementOutcome_GetUrl()로 조회해요.
reservedconst IStoveTypeBase*예약된 매개변수예요. 현재 항상 nullptr이에요.

두 콜백 모두 Stove_RunCallback()을 호출한 스레드에서 실행돼요.

  • onFinished는 호출 1건당 1회만 전달돼요.
  • onDestroy는 이 호출로 생성된 팝업이 모두 닫힌 뒤 1회 전달돼요(Operation == WithWebView인 경우 해당). 팝업이 아예 생성되지 않고 호출이 종료된 경우에도 결과 코드 PopupNotCreated(33)로 1회 호출돼요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공(이미 동의한 경우도 포함)x
17k_EStoveCommonResultCode_NotInitialized결제 기능이 초기화되지 않았어요.x
60k_EStoveCommonResultCode_ViewUiNotInitializedOperation이 Default가 아니어서 약관 페이지를 웹뷰로 열어야 하는데, 웹뷰/팝업 UI 서브시스템이 초기화되지 않았어요.x
65k_EStoveCommonResultCode_WebviewCloseAllFail약관 웹뷰를 열기 전, 기존에 열려 있던 IAP 웹뷰를 모두 닫는 데 실패했어요.x
62k_EStoveCommonResultCode_WebviewCreateFail약관 웹뷰 생성 자체가 실패했어요.x
64k_EStoveCommonResultCode_WebviewCreateCookieFail언어(로케일) 쿠키 설정에 실패했어요.O구매를 위해서는 약관 동의가 필요합니다. 현재 약관 동의 화면을 불러오지 못했습니다. 다시 시도해 주세요. [확인]
63k_EStoveCommonResultCode_WebviewLoadUrlFail약관 웹뷰에서 약관 페이지 URL 로드에 실패했어요.x
66k_EStoveCommonResultCode_WebviewCloseFail웹뷰가 정상적으로 닫히는 과정에서 내부 닫기 처리가 실패했어요. onFinished가 아니라 onDestroy에 실려요.x
253k_EStoveCommonResultCode_UnmanagedException실행 중 관리되지 않는 예외가 발생했어요.O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 관리되는 예외가 발생했어요(로그인 토큰 등 내부 엔티티 누락 포함).O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
33k_EStoveCommonResultCode_PopupNotCreated팝업이 생성되지 않고 호출이 종료되었어요. onDestroy에만 전달돼요.x

네트워크/서버 응답 오류(약관 동의 조회 및 미동의 시 SSO 키 조회 실패 포함)는 하위 HTTP 계층에서 전달돼요.

전체 목록: EStoveCommonResultCode, EStoveResultCode

Memory Management

ObjectOwnerRelease
param호출자Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param) 필수. 호출이 반환된 뒤 해제해요.
콜백의 callbackResultSDK해제 금지. 콜백이 끝나면 무효처리돼요.
콜백의 outcomeSDK해제 금지. 콜백이 끝나면 무효처리되며, 필요한 값(예: Url)은 콜백 안에서 복사해 두어야 해요.

Example

c
void __cdecl OnFetchTermsAgreementFinished(const IStoveCallbackResult* callbackResult, const IStoveTermsAgreementOutcome* outcome)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);
    if (Stove_IStoveResult_IsSuccessful(result))
    {
        // 성공 시 로직을 구현해 주세요.
        if (!Stove_IStoveTermsAgreementOutcome_IsAgreed(outcome))
        {
            const wchar_t* url = Stove_IStoveTermsAgreementOutcome_GetUrl(outcome);
            // url 로 약관 페이지를 열어 주세요.
        }
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

void __cdecl OnFetchTermsAgreementPopupDestroyed(const IStoveCallbackResult* callbackResult, const IStoveTypeBase* reserved)
{
    // 약관 페이지 팝업이 모두 닫혔을 때 로직을 구현해 주세요.
}

// 호출
IStoveFetchTermsAgreementParam* param = (IStoveFetchTermsAgreementParam*)Stove_CreateParam(k_EStoveIAPTypeKind_FetchTermsAgreementParam);
Stove_IStoveFetchTermsAgreementParam_SetOperation(param, k_EStoveTermsOperation_Default);

Stove_FetchTermsAgreement(param, OnFetchTermsAgreementFinished, OnFetchTermsAgreementPopupDestroyed, nullptr, nullptr);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param);

Notes

  • 이 함수는 비동기 함수이며 결과는 onFinished 콜백으로만 전달돼요.
  • Operation == WithWebView를 사용하면 호출자가 약관 페이지의 UI를 직접 구현할 필요가 없어요.
  • WebView* 필드(웹뷰 위치·크기, IStoveWebViewLayoutParam 상속 멤버)는 Operation != Default일 때만 적용돼요.

See Also


Stove_GetAccessToken

종류 함수 · 모듈 Base · 버전 3.5.0

Description

현재 유효한 AccessToken을 조회해요. SDK가 내부적으로 토큰을 자동 갱신하여 항상 유효한 토큰을 제공해요.

Declaration

c
IStoveResult* Stove_GetAccessToken(wchar_t* outAccessToken, uint32_t length);

Parameters

NameTypeRequiredDescription
outAccessTokenwchar_t*YAccessToken 문자열을 받을 버퍼예요.
lengthuint32_tYoutAccessToken 버퍼의 길이예요.

Returns

TypeDescription
IStoveResult*호출 결과예요. Stove_IStoveResult_GetResultCode()가 0이면 성공이에요.

이 함수의 메서드 코드는 k_EStoveBaseMethodCode_GetAccessToken 예요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
5k_EStoveCommonResultCode_InvalidParamoutAccessToken이 nullptr이거나 length가 0이거나, 버퍼가 작아 값이 잘렸어요.x
16k_EStoveCommonResultCode_BaseNotInitialized초기화되지 않은 상태에서 호출했어요.x
19k_EStoveCommonResultCode_InvalidAccessTokenAccessToken이 유효하지 않아요.O로그인 세션이 만료되었습니다. 게임 종료 후 다시 실행해 주세요. [확인]
253k_EStoveCommonResultCode_UnmanagedException실행 중 알 수 없는 예외가 발생했어요.O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 예외가 발생했어요.O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

아래 코드를 받으면 반드시 게임을 종료해야 해요. 정상 진행이 불가능한 상태예요.

  • 19 k_EStoveCommonResultCode_InvalidAccessToken: 로그인 세션이 만료되어 재실행이 필요해요

전체 목록: EStoveCommonResultCode

Memory Management

ObjectOwnerRelease
outAccessToken호출자호출자가 할당한 버퍼예요. Destroy 대상이 아니에요
반환된 IStoveResult*호출자Stove_IStoveTypeBase_Destroy() 필수

Example

c
wchar_t accessToken[1024] = { 0 };
IStoveResult* result = Stove_GetAccessToken(accessToken, 1024);
if (Stove_IStoveResult_IsSuccessful(result))
{
    // 성공 시 로직을 구현해 주세요. accessToken을 사용해요.
}
else
{
    // 실패 시 로직을 구현해 주세요.
}

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result);

Notes

  • SDK가 내부적으로 토큰을 자동 갱신하므로, 이 함수는 항상 유효한 토큰을 반환해요.
  • 조회한 토큰을 게임에서 따로 보관해 두고 다시 쓰지 마세요. SDK 가 토큰을 주기적으로 갱신하므로 보관해 둔 값은 만료될 수 있어요. 토큰이 필요할 때마다 이 함수를 호출해 그때의 유효한 값을 받아 쓰세요.
  • 토큰이 갱신되는 시점에 별도로 알림을 받으려면 Stove_AccessTokenRenewed를 사용해요.

See Also


Stove_GetCloudSavingPath

종류 함수 · 모듈 Base · 버전 3.5.0

Description

클라우드 저장 경로를 조회하는 동기 함수예요.

SDK가 초기화된 이후에 호출해야 해요.

Declaration

c
IStoveResult* Stove_GetCloudSavingPath(wchar_t* outPath, uint32_t length);

Parameters

NameTypeRequiredDescription
outPathwchar_t*Y클라우드 저장 경로 문자열을 받을 버퍼예요. 호출자가 미리 할당해요.
lengthuint32_tYoutPath 버퍼의 길이(문자 수)예요.

Returns

TypeDescription
IStoveResult*호출 결과예요. Stove_IStoveResult_IsSuccessful(result)이면 성공이에요.

이 함수의 메서드 코드는 k_EStoveBaseMethodCode_GetCloudSavingPath 예요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
5k_EStoveCommonResultCode_InvalidParamoutPath가 nullptr이거나 length가 0, 또는 버퍼가 작아 경로 문자열이 잘림(STRUNCATE)x
16k_EStoveCommonResultCode_BaseNotInitializedSDK가 초기화되지 않음x
253k_EStoveCommonResultCode_UnmanagedException실행 중 알 수 없는 예외가 발생함O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 내부 예외가 발생함O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

전체 목록: EStoveCommonResultCode, EStoveResultCode

Memory Management

ObjectOwnerRelease
outPath호출자호출자가 할당한 버퍼예요. Destroy 대상이 아니에요.
반환된 IStoveResult*호출자Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result) 필수

Example

c
wchar_t cloudPath[512] = { 0 };
IStoveResult* result = Stove_GetCloudSavingPath(cloudPath, 512);
if (Stove_IStoveResult_IsSuccessful(result))
{
    // 성공 시 로직을 구현해 주세요. cloudPath에 클라우드 저장 경로가 담겨 있어요.
}
else
{
    // 실패 시 로직을 구현해 주세요.
}

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result);

Notes

  • 이 함수는 동기 함수이며 콜백을 받지 않아요.
  • 이 함수는 게임이 스토브에 출시된 이후에만 사용할 수 있어요. 스튜디오에서 테스트로 실행하는 동안에는 클라우드 저장 경로가 제공되지 않으므로, 개발 단계에서는 경로를 받을 수 없어요.
  • outPath 버퍼가 결과 문자열보다 작으면 문자열이 잘리고 InvalidParam(5)이 반환돼요. 충분히 큰 버퍼를 준비해요.

Stove_GetGds

종류 함수 · 모듈 Base · 버전 3.5.0

Description

로그인한 사용자의 GDS(국가 · 시간대) 정보를 조회해요.

Declaration

c
IStoveResult* Stove_GetGds(IStoveGds** outGds);

Parameters

NameTypeRequiredDescription
outGdsIStoveGds**YGDS 정보 포인터를 받을 변수예요. 사용 후 Destroy()를 호출해야 해요.

Returns

TypeDescription
IStoveResult*호출 결과예요. Stove_IStoveResult_GetResultCode()가 0이면 성공이에요.

이 함수의 메서드 코드는 k_EStoveBaseMethodCode_GetGds 예요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
5k_EStoveCommonResultCode_InvalidParamoutGds가 nullptr이에요.x
16k_EStoveCommonResultCode_BaseNotInitialized초기화되지 않은 상태에서 호출했어요.x
253k_EStoveCommonResultCode_UnmanagedException실행 중 알 수 없는 예외가 발생했어요.O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 예외가 발생했어요.O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

전체 목록: EStoveCommonResultCode

Memory Management

ObjectOwnerRelease
*outGdsSDK가 생성, 소유권은 호출자로 이전Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)gds) 필수
반환된 IStoveResult*호출자Stove_IStoveTypeBase_Destroy() 필수

Example

c
IStoveGds* gds = nullptr;
IStoveResult* result = Stove_GetGds(&gds);
if (Stove_IStoveResult_IsSuccessful(result))
{
    // 성공 시 로직을 구현해 주세요.
    const wchar_t* nation = Stove_IStoveGds_GetNation(gds);
    const wchar_t* timezone = Stove_IStoveGds_GetTimezone(gds);

    Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)gds);
}
else
{
    // 실패 시 로직을 구현해 주세요.
}

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result);

Notes

  • 국가 코드를 IP로 판별하지 못해 기본 국가 코드를 사용한 경우 Stove_IStoveGds_IsDefault()가 true를 반환해요.

See Also


Stove_GetSignin

종류 함수 · 모듈 Base · 버전 3.5.0

Description

로그인한 사용자의 가입(Signin) 정보를 조회해요.

Declaration

c
IStoveResult* Stove_GetSignin(IStoveSignin** outSignin);

Parameters

NameTypeRequiredDescription
outSigninIStoveSignin**Y가입 정보 포인터를 받을 변수예요. 사용 후 Destroy()를 호출해야 해요.

Returns

TypeDescription
IStoveResult*호출 결과예요. Stove_IStoveResult_GetResultCode()가 0이면 성공이에요.

이 함수의 메서드 코드는 k_EStoveBaseMethodCode_GetSignin 예요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
5k_EStoveCommonResultCode_InvalidParamoutSignin이 nullptr이에요.x
16k_EStoveCommonResultCode_BaseNotInitialized초기화되지 않은 상태에서 호출했어요.x
253k_EStoveCommonResultCode_UnmanagedException실행 중 알 수 없는 예외가 발생했어요.O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 예외가 발생했어요.O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

전체 목록: EStoveCommonResultCode

Memory Management

ObjectOwnerRelease
*outSigninSDK가 생성, 소유권은 호출자로 이전Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)signin) 필수
반환된 IStoveResult*호출자Stove_IStoveTypeBase_Destroy() 필수

Example

c
IStoveSignin* signin = nullptr;
IStoveResult* result = Stove_GetSignin(&signin);
if (Stove_IStoveResult_IsSuccessful(result))
{
    // 성공 시 로직을 구현해 주세요.
    bool personVerified = Stove_IStoveSignin_IsPersonVerified(signin);
    const wchar_t* providerCode = Stove_IStoveSignin_GetProviderCode(signin);

    Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)signin);
}
else
{
    // 실패 시 로직을 구현해 주세요.
}

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result);

Notes

  • 계정 유형(Stove_IStoveSignin_GetAccountType())은 숫자 코드로 제공돼요. 예: 2=Facebook, 3=Twitter, 6=Naver, 9=Google+, 11=스토브 PC 가입, 12=Apple, 13=LINE, 14=LINE Games, 15=Steam, 16=VTCO 등. 다만 공개된 규격이 값-의미 대응표를 고정해 명시하지 않으므로, IDP 종류(예: STEAM과 STEAM_SHADOW 구분)를 식별할 때는 Stove_IStoveSignin_GetProviderCode()를 사용해요.

See Also


Stove_GetUser

종류 함수 · 모듈 Base · 버전 3.5.0

Description

로그인한 사용자 정보를 조회해요.

Declaration

c
IStoveResult* Stove_GetUser(IStoveUser** outUser);

Parameters

NameTypeRequiredDescription
outUserIStoveUser**Y사용자 정보 포인터를 받을 변수예요. 사용 후 Destroy()를 호출해야 해요.

Returns

TypeDescription
IStoveResult*호출 결과예요. Stove_IStoveResult_GetResultCode()가 0이면 성공이에요.

이 함수의 메서드 코드는 k_EStoveBaseMethodCode_GetUser 예요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
5k_EStoveCommonResultCode_InvalidParamoutUser가 nullptr이에요.x
16k_EStoveCommonResultCode_BaseNotInitialized초기화되지 않은 상태에서 호출했어요.x
253k_EStoveCommonResultCode_UnmanagedException실행 중 알 수 없는 예외가 발생했어요.O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 예외가 발생했어요.O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

전체 목록: EStoveCommonResultCode

Memory Management

ObjectOwnerRelease
*outUserSDK가 생성, 소유권은 호출자로 이전Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)user) 필수
반환된 IStoveResult*호출자Stove_IStoveTypeBase_Destroy() 필수

Example

c
IStoveUser* user = nullptr;
IStoveResult* result = Stove_GetUser(&user);
if (Stove_IStoveResult_IsSuccessful(result))
{
    // 성공 시 로직을 구현해 주세요.
    const wchar_t* nickName = Stove_IStoveUser_GetNickName(user);
    uint64_t userId = Stove_IStoveUser_GetUserId(user);

    Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)user);
}
else
{
    // 실패 시 로직을 구현해 주세요.
}

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result);

Notes

See Also


Stove_GetVersion

종류 함수 · 모듈 Base · 버전 3.5.0

Description

SDK 버전 정보를 조회하는 동기 함수예요.

Declaration

c
IStoveResult* Stove_GetVersion(wchar_t* outVersion, uint32_t length);

Parameters

NameTypeRequiredDescription
outVersionwchar_t*Y버전 문자열을 받을 버퍼예요. 호출자가 미리 할당해요.
lengthuint32_tYoutVersion 버퍼의 길이(문자 수)예요.

Returns

TypeDescription
IStoveResult*호출 결과예요. Stove_IStoveResult_IsSuccessful(result)이면 성공이에요.

이 함수의 메서드 코드는 k_EStoveBaseMethodCode_BaseGetVersion 예요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
5k_EStoveCommonResultCode_InvalidParamoutVersion이 nullptr이거나 length가 0, 또는 버퍼가 작아 버전 문자열이 잘림(STRUNCATE)x
251k_EStoveCommonResultCode_PcsdkDllNotFound실행 파일 경로에서 DLL 경로를 찾지 못함x
253k_EStoveCommonResultCode_UnmanagedException실행 중 알 수 없는 예외가 발생함O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 내부 예외가 발생함O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

전체 목록: EStoveCommonResultCode, EStoveResultCode

Memory Management

ObjectOwnerRelease
outVersion호출자호출자가 할당한 버퍼예요. Destroy 대상이 아니에요.
반환된 IStoveResult*호출자Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result) 필수

Example

c
wchar_t version[64] = { 0 };
IStoveResult* result = Stove_GetVersion(version, 64);
if (Stove_IStoveResult_IsSuccessful(result))
{
    // 성공 시 로직을 구현해 주세요. version에 버전 문자열이 담겨 있어요.
}
else
{
    // 실패 시 로직을 구현해 주세요.
}

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result);

Notes

  • 이 함수는 동기 함수이며 콜백을 받지 않아요.

Stove_Initialize

종류 함수 · 모듈 Base · 버전 3.5.0

Description

SDK를 초기화해요. 단일바이너리(BaseSDK Consolidation) 통합 이후에는 이 함수가 View 모듈과 IAP 모듈의 초기화도 함께 처리해요.

SDK는 Stove_RestartAppIfNecessary()가 캐시해 둔 환경(Environment) · 게임 ID · 앱 키 값을 재사용해요. 여기에 더해 initParam에 메인 윈도우 핸들(SetMainWndHandle)이 설정되어 있으면 View 모듈이 초기화되고, 상점 키(SetShopKey)까지 설정되어 있으면 IAP 모듈도 함께 초기화돼요. initParam을 nullptr로 전달하면 SDK만 초기화해요.

실패 시 SDK가 일부만 초기화된 상태로 남을 수 있어요(예: SDK와 View는 초기화되었지만 IAP는 실패). 이런 경우 Stove_Uninitialize()를 호출한 뒤 깨끗한 상태에서 Stove_Initialize()를 다시 시도해야 해요. Uninitialize 없이 다시 호출하면 ALREADY_INITIALIZED가 반환되고 실패했던 모듈의 초기화는 재시도되지 않아요.

Declaration

c
IStoveResult* Stove_Initialize(const IStoveInitializeParam* initParam);

Parameters

NameTypeRequiredDescription
initParamIStoveInitializeParam*N초기화 정보예요. nullptr을 전달하면 SDK만 초기화해요.

Returns

TypeDescription
IStoveResult*호출 결과예요. Stove_IStoveResult_GetResultCode()가 0이면 성공이에요. Stove_IStoveResult_GetMethodCode()로 어느 모듈에서 실패했는지 유추할 수 있어요.

이 함수의 메서드 코드는 k_EStoveBaseMethodCode_BaseInitialize 예요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
5k_EStoveCommonResultCode_InvalidParam환경(environment) · 게임 ID · 앱 키 중 하나라도 비어 있어요(Stove_RestartAppIfNecessary() 호출 시 전달한 값을 확인해요).x
18k_EStoveCommonResultCode_AlreadyInitialized이미 초기화되어 있어요.x
304k_EStoveResultCode_NeedStoveLauncherStove_RestartAppIfNecessary()를 먼저 호출해 런처 연결을 완료해야 해요.O게임이 스토브 PC 클라이언트를 통해 실행되지 않아 종료됩니다.클라이언트에서 다시 게임을 실행해주세요.클라이언트 미설치 시 스토브 홈페이지에서 설치해주세요.[확인]
251k_EStoveCommonResultCode_PcsdkDllNotFound내부 버전 조회(GetVersion) 실패 결과가 그대로 전달되었어요.x
253k_EStoveCommonResultCode_UnmanagedException실행 중 알 수 없는 예외가 발생했어요.O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 예외가 발생했어요(필수 정보 파싱 실패 등 하위 계층 오류 포함).O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

아래 코드를 받으면 반드시 게임을 종료해야 해요. 정상 진행이 불가능한 상태예요.

  • 304 k_EStoveResultCode_NeedStoveLauncher: 스토브 PC 클라이언트를 통해 실행되지 않아 재실행이 필요해요

하위 계층(토큰 처리 로직)에서 k_EStoveCommonResultCode_Fail(1) 또는 k_EStoveResultCode_NotFoundRequiredInformation(302)이 전달될 수 있어요.

전체 목록: EStoveCommonResultCode, EStoveResultCode

Memory Management

ObjectOwnerRelease
initParam호출자전달했다면 Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)initParam) 필수
반환된 IStoveResult*호출자Stove_IStoveTypeBase_Destroy() 필수

Example

c
IStoveInitializeParam* initParam = (IStoveInitializeParam*)Stove_CreateParam(k_EStoveBaseTypeKind_InitializeParam);
Stove_IStoveInitializeParam_SetMainWndHandle(initParam, hWnd);
Stove_IStoveInitializeParam_SetShopKey(initParam, L"YOUR_SHOP_KEY");

IStoveResult* result = Stove_Initialize(initParam);
if (Stove_IStoveResult_IsSuccessful(result))
{
    // 성공 시 로직을 구현해 주세요.
}
else
{
    // 실패 시 로직을 구현해 주세요.
    // Stove_IStoveResult_GetMethodCode() / Stove_IStoveResult_GetResultCode()로 어느 모듈에서 실패했는지 확인해요.
}

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result);
Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)initParam);

Notes

  • initParam에 메인 윈도우 핸들을 설정하면 View 모듈이 함께 초기화되고, 상점 키까지 설정하면 IAP 모듈도 함께 초기화돼요.
  • 실패 후 재시도할 때는 반드시 Stove_Uninitialize()를 먼저 호출해야 해요.
  • Stove_RestartAppIfNecessary()를 먼저 호출해 두면 그때 캐시된 환경 · 게임 ID · 앱 키 값을 재사용해요.

See Also


Stove_OpenExternalUrl

종류 함수 · 모듈 Base · 버전 3.5.0

Description

외부 브라우저로 URL을 열어요. Onstove 관련 도메인(예: *.onstove.com)을 열 때는 SSO 처리를 함께 수행해요.

Declaration

c
void Stove_OpenExternalUrl(const wchar_t* url, OnOpenExternalUrlCallback onFinished, void* userData);

Parameters

NameTypeRequiredDescription
urlconst wchar_t*Y열고자 하는 URL이에요.
onFinishedOnOpenExternalUrlCallbackY결과를 받을 콜백이에요.
userDatavoid*N콜백에 그대로 전달되는 사용자 데이터예요.

Returns

없음

이 함수의 메서드 코드는 k_EStoveBaseMethodCode_OpenExternalUrl 예요.

Callback

c
typedef void(__cdecl* OnOpenExternalUrlCallback)(const IStoveCallbackResult* callbackResult, const IStoveTypeBase* reserved);
NameTypeDescription
callbackResultconst IStoveCallbackResult*호출 결과예요.
reservedconst IStoveTypeBase*향후 확장을 위해 인자 개수를 미리 맞춰 둔 예약 필드예요. 현재 SDK에서는 항상 nullptr이에요.

콜백은 Stove_RunCallback()(또는 Stove_RunCallbackWithTimeout())을 호출한 스레드에서 실행돼요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공(브라우저에서 URL 열기 성공)x
5k_EStoveCommonResultCode_InvalidParamonFinished가 nullptrx
16k_EStoveCommonResultCode_BaseNotInitializedSDK가 초기화되지 않음x
253k_EStoveCommonResultCode_UnmanagedException브라우저 실행에 실패했거나, 실행 중 알 수 없는 예외가 발생함O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 내부 예외가 발생함O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

Onstove 관련 도메인을 열 때 내부적으로 조회하는 SSO 키(simKey) 조회가 실패하면, 그 결과 코드가 하위 계층에서 그대로 전달돼요.

전체 목록: EStoveCommonResultCode, EStoveResultCode

Memory Management

ObjectOwnerRelease
url호출자문자열 인자예요. Destroy 대상이 아니에요.
콜백의 callbackResult, reservedSDK해제 금지. 콜백이 끝나면 무효처리돼요.

Example

c
void OnOpenExternalUrl(const IStoveCallbackResult* callbackResult, const IStoveTypeBase* reserved)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);
    if (Stove_IStoveResult_IsSuccessful(result))
    {
        // 성공 시 로직을 구현해 주세요.
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Stove_OpenExternalUrl(L"https://www.onstove.com", OnOpenExternalUrl, nullptr);

// 게임 루프에서 주기적으로 호출해야 콜백이 전달돼요.
Stove_RunCallback();

Notes

  • Onstove 관련 도메인(*.onstove.com 등)을 열 때는 SSO 처리가 함께 수행돼요.
  • 콜백의 reserved 인자는 현재 항상 nullptr이에요. if (reserved)로 향후 확장 여부를 확인할 수 있어요.

Stove_OverImmersionNotification

종류 함수 · 모듈 Base · 버전 3.5.0

Description

한국 과몰입 방지 규제 대상 사용자에게 매시간 알림을 콜백으로 전달해요. 한국 전용 API예요.

이 콜백은 1회성이 아니라 대상 사용자에게 매시간 반복해서 전달돼요.

Declaration

c
void Stove_OverImmersionNotification(const IStoveTypeBase* param, OnOverImmersionNotificationCallback onFinished, void* userData);

Parameters

NameTypeRequiredDescription
paramconst IStoveTypeBase*N예약된 인자로, 전용 TypeKind는 정의되어 있지 않아요.
onFinishedOnOverImmersionNotificationCallbackY결과를 받을 콜백이에요.
userDatavoid*N콜백에 그대로 전달되는 사용자 데이터예요.

Returns

없음

이 함수의 메서드 코드는 k_EStoveBaseMethodCode_OverImmersionNotification 예요.

Callback

c
typedef void(__cdecl* OnOverImmersionNotificationCallback)(const IStoveCallbackResult* callbackResult, const IStoveOverImmersionInfo* overImmersion);
NameTypeDescription
callbackResultconst IStoveCallbackResult*호출 결과예요.
overImmersionconst IStoveOverImmersionInfo*과몰입 방지 알림 정보예요. 경고 메시지(GetMsg()), 누적 게임 시간(GetElapsedHours(), 시간 단위), 메시지 노출 시간(GetExposureTime(), 초 단위)을 제공해요.

콜백은 Stove_RunCallback()(또는 Stove_RunCallbackWithTimeout())을 호출한 스레드에서 실행돼요. 대상 사용자에게 매시간 반복해서 전달돼요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
5k_EStoveCommonResultCode_InvalidParamonFinished가 nullptrx
16k_EStoveCommonResultCode_BaseNotInitializedSDK가 초기화되지 않음x
31k_EStoveCommonResultCode_NotSupportedCountry로그인 계정의 GDS 국가 코드가 한국(kr)이 아님x
253k_EStoveCommonResultCode_UnmanagedException실행 중 알 수 없는 예외가 발생함O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 내부 예외가 발생함O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

전체 목록: EStoveCommonResultCode, EStoveResultCode

Memory Management

ObjectOwnerRelease
param호출자전달했다면 Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param) 필수
콜백의 callbackResult, overImmersionSDK해제 금지. 콜백이 끝나면 무효처리돼요.

Example

c
void OnOverImmersionNotification(const IStoveCallbackResult* callbackResult, const IStoveOverImmersionInfo* overImmersion)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);
    if (Stove_IStoveResult_IsSuccessful(result))
    {
        // 성공 시 로직을 구현해 주세요.
        const wchar_t* msg = Stove_IStoveOverImmersionInfo_GetMsg(overImmersion);
        int32_t exposureTime = Stove_IStoveOverImmersionInfo_GetExposureTime(overImmersion);
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Stove_OverImmersionNotification(nullptr, OnOverImmersionNotification, nullptr);

// 게임 루프에서 주기적으로 호출해야 콜백이 전달돼요.
Stove_RunCallback();

Notes

  • 한국 전용 API예요.
  • 대상 사용자에게 매시간 반복해서 전달되는 콜백이에요. 1회성 콜백이 아니에요.

See Also


Stove_RestartAppIfNecessary

종류 함수 · 모듈 Base · 버전 3.5.0

Description

PCSDK가 스토브 런처를 거쳐 실행되었는지 확인해요. 런처를 거치지 않았다면 런처를 통해 앱을 재실행하고 현재 프로세스는 종료돼요.

이 함수는 Stove_Initialize()보다 먼저 호출해야 해요. initParam에 담긴 환경(Environment) · 게임 ID · 앱 키 값은 이후 Stove_Initialize() 호출 시 재사용돼요.

재실행이 필요한 경우 현재 프로세스가 종료되므로, 이 함수 호출 이후의 코드가 실행되지 않을 수 있어요.

Declaration

c
void Stove_RestartAppIfNecessary(const IStoveRestartAppIfNecessaryParam* initParam, OnRestartAppIfNecessaryCallback onFinished, void* userData);

Parameters

NameTypeRequiredDescription
initParamIStoveRestartAppIfNecessaryParam*Y환경(Environment) · 게임 ID · 앱 키 등 런처 확인에 필요한 정보예요.
onFinishedOnRestartAppIfNecessaryCallbackY결과를 받을 콜백이에요.
userDatavoid*N콜백에 그대로 전달되는 사용자 데이터예요.

Returns

없음

이 함수의 메서드 코드는 k_EStoveBaseMethodCode_RestartAppIfNecessaryAsync 예요.

Callback

c
typedef void(__cdecl* OnRestartAppIfNecessaryCallback)(const IStoveCallbackResult* callbackResult, const IStoveRestartAppIfNecessaryOutcome* outcome);
NameTypeDescription
callbackResultconst IStoveCallbackResult*호출 결과예요.
outcomeconst IStoveRestartAppIfNecessaryOutcome*재실행 필요 여부예요. Stove_IStoveRestartAppIfNecessaryOutcome_IsRestartRequired()로 조회해요.

콜백은 Stove_RunCallback()(또는 Stove_RunCallbackWithTimeout())을 호출한 스레드에서 실행돼요. 재실행이 필요한 경우에도 콜백은 전달돼요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공(IPC 상태가 정상 도달, 또는 직전 호출이 이미 완료된 상태 재확인)x
29k_EStoveCommonResultCode_AsyncOperationInProgress직전 비동기 재시작 요청이 아직 처리 중이에요.x
30k_EStoveCommonResultCode_BaseUninitialized대기 중 IPC 상태가 초기화되지 않은 상태로 전환되었어요.x
307k_EStoveResultCode_IpcConnectFailed런처와의 IPC 연결에 실패했어요.O게임이 스토브 PC 클라이언트를 통해 실행되지 않아 종료됩니다.클라이언트에서 다시 게임을 실행해주세요.클라이언트 미설치 시 스토브 홈페이지에서 설치해주세요.[확인]
308k_EStoveResultCode_IpcAesKeyNotReceived런처로부터 AES 키를 받지 못했어요.O게임이 스토브 PC 클라이언트를 통해 실행되지 않아 종료됩니다.클라이언트에서 다시 게임을 실행해주세요.클라이언트 미설치 시 스토브 홈페이지에서 설치해주세요.[확인]
309k_EStoveResultCode_IpcTimeout대기 시간(waitTimeMillisec)을 초과했어요.O게임이 스토브 PC 클라이언트를 통해 실행되지 않아 종료됩니다.클라이언트에서 다시 게임을 실행해주세요.클라이언트 미설치 시 스토브 홈페이지에서 설치해주세요.[확인]
253k_EStoveCommonResultCode_UnmanagedException실행 중 알 수 없는 예외가 발생했어요.O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 예외가 발생했어요.O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

아래 코드를 받으면 반드시 게임을 종료해야 해요. 정상 진행이 불가능한 상태예요.

  • 307 k_EStoveResultCode_IpcConnectFailed: 런처와의 연결에 실패해 재실행이 필요해요
  • 308 k_EStoveResultCode_IpcAesKeyNotReceived: 런처와의 통신 준비에 실패해 재실행이 필요해요
  • 309 k_EStoveResultCode_IpcTimeout: 런처와의 통신이 시간 초과되어 재실행이 필요해요

전체 목록: EStoveCommonResultCode, EStoveResultCode

Memory Management

ObjectOwnerRelease
initParam호출자Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)initParam) 필수
콜백의 callbackResult, outcomeSDK해제 금지. 콜백이 끝나면 무효처리돼요

Example

c
IStoveRestartAppIfNecessaryParam* initParam = (IStoveRestartAppIfNecessaryParam*)Stove_CreateParam(k_EStoveBaseTypeKind_RestartAppIfNecessaryParam);
Stove_IStoveRestartAppIfNecessaryParam_SetEnvironment(initParam, L"REAL");
Stove_IStoveRestartAppIfNecessaryParam_SetGameId(initParam, L"YOUR_GAME_ID");
Stove_IStoveRestartAppIfNecessaryParam_SetAppKey(initParam, L"YOUR_APP_KEY");

Stove_RestartAppIfNecessary(initParam, [](const IStoveCallbackResult* callbackResult, const IStoveRestartAppIfNecessaryOutcome* outcome)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);
    if (Stove_IStoveResult_IsSuccessful(result))
    {
        // 성공 시 로직을 구현해 주세요.
        if (!Stove_IStoveRestartAppIfNecessaryOutcome_IsRestartRequired(outcome))
        {
            // 재실행이 필요 없다면 이어서 Stove_Initialize()를 호출해요.
        }
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}, nullptr);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)initParam);

Notes

  • Stove_Initialize()보다 먼저 호출해야 해요.
  • 재실행이 필요하면 런처를 통해 앱이 다시 실행되고 현재 프로세스는 종료돼요.
  • 이 함수에서 사용한 환경 · 게임 ID · 앱 키 값은 Stove_Initialize()가 재사용해요.

See Also


Stove_RunCallback

종류 함수 · 모듈 Base · 버전 3.5.0

Description

비동기 API 호출의 결과(콜백 함수)를 처리(dispatch)해요. 게임의 UI(메인) 스레드에서 호출해야 해요.

SDK 전체의 비동기 API 콜백은 모두 이 함수(또는 Stove_RunCallbackWithTimeout)를 통해서만 전달돼요. SDK 내부 스레드가 아니라, 이 함수를 호출한 스레드에서 콜백이 실행돼요.

게임 루프(예: 매 프레임 또는 매 틱)에서 주기적으로 호출해야 해요. while(true) 형태로 이 함수만 반복 호출하는 방식으로 사용하지 않아요.

Declaration

c
void Stove_RunCallback();

Parameters

없음

Returns

없음

Error Codes

없음

Memory Management

이 함수는 별도의 객체를 생성하거나 반환하지 않아요.

Example

c
// 게임 루프 예시
while (isGameRunning)
{
    // ... 게임 로직 ...

    Stove_RunCallback();

    // ... 렌더링 등 나머지 루프 로직 ...
}

Notes

  • 모든 비동기 API의 콜백은 이 함수를 호출한 스레드에서 실행돼요.
  • 게임 루프 안에서 주기적으로 호출해야 콜백이 지연 없이 처리돼요.
  • 대기 시간을 지정하려면 Stove_RunCallbackWithTimeout을 사용해요.

See Also


Stove_RunCallbackWithTimeout

종류 함수 · 모듈 Base · 버전 3.5.0

Description

Stove_RunCallback의 타임아웃 버전이에요. timeoutMillisec으로 대기 시간을 지정할 수 있어요.

게임의 UI(메인) 스레드에서 호출해야 하며, 등록된 콜백은 이 함수를 호출한 스레드에서 실행돼요.

Declaration

c
void Stove_RunCallbackWithTimeout(uint32_t timeoutMillisec);

Parameters

NameTypeRequiredDescription
timeoutMillisecuint32_tY대기 시간(밀리초)예요.

Returns

없음

Error Codes

없음

Memory Management

이 함수는 별도의 객체를 생성하거나 반환하지 않아요.

Example

c
// 게임 루프 예시 (최대 10ms 대기)
while (isGameRunning)
{
    // ... 게임 로직 ...

    Stove_RunCallbackWithTimeout(10);

    // ... 렌더링 등 나머지 루프 로직 ...
}

Notes

  • 모든 비동기 API의 콜백은 이 함수를 호출한 스레드에서 실행돼요.
  • 일반적인 사용에는 Stove_RunCallback을 사용하고, 대기 시간 제어가 필요할 때 이 함수를 사용해요.

See Also


Stove_SendLog

종류 함수 · 모듈 Log · 버전 3.5.0

Description

로그 항목 하나를 STOVE 로그 백엔드로 전송해요. logSendParam 에 담은 값이 그대로 로그 항목이 되어 전송돼요.

로그 기능은 별도의 초기화·종료 API 를 두지 않아요. 수명 관리는 SDK 가 대신하므로, Stove_Initialize() 가 성공한 이후 바로 호출할 수 있어요.

onFinished 콜백은 로그가 로컬 DB 에 저장되면 즉시 SUCCESS 로 호출돼요. 실제 서버로의 HTTP 전송은 별도의 내부 재전송 경로에서 처리되며, 그 결과(성공/실패 모두)는 이 콜백에 절대 전달되지 않아요.

Declaration

c
void Stove_SendLog(const IStoveSendLogParam* logSendParam, OnSendLogCallback onFinished, void* userData);

Parameters

NameTypeRequiredDescription
logSendParamconst IStoveSendLogParam*Y전송할 로그 항목의 값이에요. Stove_CreateParam(k_EStoveLogTypeKind_SendLogParam) 으로 생성해요.
onFinishedOnSendLogCallbackY전송 결과를 전달받을 콜백이에요.
userDatavoid*N콜백에 그대로 전달되는 사용자 데이터예요.

Returns

없음

이 함수의 메서드 코드는 k_EStoveLogMethodCode_SendLog 예요.

Callback

c
typedef void(__cdecl* OnSendLogCallback)(const IStoveCallbackResult* callbackResult, const IStoveTypeBase* reserved);
NameTypeDescription
callbackResultconst IStoveCallbackResult*전송 호출 결과예요. 로컬 DB 저장 성공 여부만 반영하며, 실제 서버 전송 결과는 반영하지 않아요.
reservedconst IStoveTypeBase*향후 페이로드 확장을 위해 콜백의 인자 개수를 미리 맞춰 둔 예약 슬롯이에요. 현재 SDK 에서는 항상 nullptr 이에요. if (reserved) 로 값 존재 여부를 확인할 수 있어요.

콜백은 Stove_RunCallback() 을 호출한 스레드에서 실행돼요. Stove_SendLog() 호출 1회당, 로그 항목이 로컬 DB 에 기록(또는 기록 실패)된 시점에 1회 전달돼요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success로컬 DB 에 로그 레코드 삽입까지 성공했어요(실제 서버 전송 완료를 의미하지 않아요)x
5k_EStoveCommonResultCode_InvalidParamonFinished 가 nullptr 이거나, contents 가 비어있지 않은데 유효한 JSON 이 아니에요x
17k_EStoveCommonResultCode_NotInitializedSDK 가 초기화되지 않았어요x
44k_EStoveCommonResultCode_LocalDbWriteFailed로컬 DB 에 로그 레코드를 기록하는 데 실패했어요(구 이름: LOCAL_DB_BACKUP_LOG_FAILED)x
82k_EStoveCommonResultCode_PayloadSizeExceededUTF-8 로 인코딩한 로그 콘텐츠가 50KB 를 초과했어요(구 이름: LOG_SIZE_EXCEEDED)x
253k_EStoveCommonResultCode_UnmanagedException알 수 없는 예외가 발생했어요O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException처리된 예외가 발생했어요O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

k_EStoveCommonResultCode_InvalidParam(5) 은 구 LogSDK 전용 코드였던 INVALID_LOG_PARAMETER(85)가 폐지되고 범용 코드로 흡수된 것이에요.

이 콜백에는 절대 전달되지 않는 코드가 있어요. 실제 서버로의 HTTP 전송은 로컬 DB 저장이 끝난 뒤 별도의 내부 경로에서 처리되며, 그 경로의 실패는 게임 쪽에 별도로 통지되지 않도록 구현되어 있어, HttpError(22)·ResponseError(23)·ResponseValueIsNull(25)·NetworkTransportError(249)·UnmanagedException(253)·ManagedException(254, 요청 계층) 등 서버 통신 관련 실패는 onFinished 로 전달되지 않아요.

전체 목록: EStoveCommonResultCode, EStoveResultCode

Memory Management

ObjectOwnerRelease
logSendParam호출자Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)logSendParam) 필수. 호출이 반환된 뒤 바로 해제할 수 있어요.
콜백의 callbackResultSDK해제 금지. 콜백이 끝나면 무효처리돼요.
콜백의 reservedSDK현재 항상 nullptr 이에요. 값이 있더라도 해제 금지이며 콜백이 끝나면 무효처리돼요.

Example

c
IStoveSendLogParam* logSendParam = (IStoveSendLogParam*)Stove_CreateParam(k_EStoveLogTypeKind_SendLogParam);

Stove_IStoveSendLogParam_SetAuid(logSendParam, auid);
Stove_IStoveSendLogParam_SetCuid(logSendParam, cuid);
Stove_IStoveSendLogParam_SetContents(logSendParam, L"{\"event\":\"login\"}");

Stove_SendLog(logSendParam, OnSendLogFinished, nullptr);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)logSendParam);

// ...

void __cdecl OnSendLogFinished(const IStoveCallbackResult* callbackResult, const IStoveTypeBase* reserved)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    if (Stove_IStoveResult_IsSuccessful(result))
    {
        // 로컬 DB 저장이 성공했다는 의미예요. 실제 서버 전송 결과는 알 수 없어요.
        // 성공 시 로직을 구현해 주세요.
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

// 게임 루프 안에서 반복 호출해야 콜백이 실행돼요.
while (isGameRunning)
{
    Stove_RunCallback();
}

Notes

  • onFinished 콜백은 실제 서버 전송 결과를 반영하지 않아요. 로그가 로컬 DB 에 저장되는 즉시 SUCCESS 로 호출되며, 실제 HTTP 전송은 뒤이어 별도의 내부 재전송 경로에서 처리돼요. 이 경로의 실패는 사용자 콜백으로 전달되지 않으므로, 이 콜백의 성공 여부를 "서버에 로그가 도착했다"는 뜻으로 오해해서는 안 돼요.
  • 특정 로그 항목의 값을 모른다면 해당 필드는 채우지 않아도 돼요. 숫자 필드는 기본값 0, 문자열 필드는 빈 값/nullptr 로 남아요.
  • 로그 기능은 Stove_SendLog() 하나만 공개 API 로 제공하며, 초기화·종료는 SDK 가 대신해요.
  • 콜백의 reserved 인자는 항상 nullptr 인 예약 파라미터예요. 값이 채워지는 시점을 대비해 if (reserved) 형태로 방어적으로 다루는 것을 권장해요.
  • 로컬 DB 저장 실패(위 표의 k_EStoveCommonResultCode_LocalDbWriteFailed 등)를 제외하면 이 콜백은 사실상 항상 성공을 돌려줘요. 게임 로직을 이 콜백의 결과로 분기하도록 설계하지 않는 것을 권장해요.

See Also


Stove_SetGameProfile

종류 함수 · 모듈 Base · 버전 3.5.0

Description

게임 프로필 정보를 설정하는 동기 함수예요.

Declaration

c
IStoveResult* Stove_SetGameProfile(const IStoveSetGameProfileParam* gameProfileParams);

Parameters

NameTypeRequiredDescription
gameProfileParamsconst IStoveSetGameProfileParam*Y게임 프로필 정보예요. Stove_CreateParam(k_EStoveBaseTypeKind_SetGameProfileParam)으로 생성해요.

Returns

TypeDescription
IStoveResult*호출 결과예요. Stove_IStoveResult_IsSuccessful(result)이면 성공이에요.

이 함수의 메서드 코드는 k_EStoveBaseMethodCode_SetGameProfile 예요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
5k_EStoveCommonResultCode_InvalidParamgameProfileParams가 nullptrx
16k_EStoveCommonResultCode_BaseNotInitializedSDK가 초기화되지 않음x
253k_EStoveCommonResultCode_UnmanagedException실행 중 알 수 없는 예외가 발생함O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 내부 예외가 발생함O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

전체 목록: EStoveCommonResultCode, EStoveResultCode

Memory Management

ObjectOwnerRelease
gameProfileParams호출자Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)gameProfileParams) 필수
반환된 IStoveResult*호출자Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result) 필수

Example

c
IStoveSetGameProfileParam* gameProfileParams = (IStoveSetGameProfileParam*)Stove_CreateParam(k_EStoveBaseTypeKind_SetGameProfileParam);
Stove_IStoveSetGameProfileParam_SetWorldId(gameProfileParams, L"world_01");
Stove_IStoveSetGameProfileParam_SetCharacterNo(gameProfileParams, 12345);

IStoveResult* result = Stove_SetGameProfile(gameProfileParams);
if (Stove_IStoveResult_IsSuccessful(result))
{
    // 성공 시 로직을 구현해 주세요.
}
else
{
    // 실패 시 로직을 구현해 주세요.
}

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result);
Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)gameProfileParams);

Notes

  • IStoveSetGameProfileParam::GetCharacterNo()는 월드 내 캐릭터 번호예요. 예전 StoveGameProfileParams에서 이 필드를 "worldId Length"로 표기한 것은 문서상의 오기였어요.

See Also


Stove_SetLanguage

종류 함수 · 모듈 Base · 버전 3.5.0

Description

PCSDK가 사용할 언어를 설정하는 동기 함수예요.

Declaration

c
IStoveResult* Stove_SetLanguage(const wchar_t* language);

Parameters

NameTypeRequiredDescription
languageconst wchar_t*Y언어 정보 문자열이에요.

Returns

TypeDescription
IStoveResult*호출 결과예요. Stove_IStoveResult_IsSuccessful(result)이면 성공이에요.

이 함수의 메서드 코드는 k_EStoveBaseMethodCode_SetLanguage 예요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
5k_EStoveCommonResultCode_InvalidParamlanguage가 nullptr이거나, 지원하지 않는 언어 코드임x
16k_EStoveCommonResultCode_BaseNotInitializedSDK가 초기화되지 않음x
253k_EStoveCommonResultCode_UnmanagedException실행 중 알 수 없는 예외가 발생함O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 내부 예외가 발생함O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

지원하지 않는 언어 코드일 때의 InvalidParam(5)은 하위 계층(LanguageActor)에서 설정돼요.

전체 목록: EStoveCommonResultCode, EStoveResultCode

Memory Management

ObjectOwnerRelease
language호출자문자열 인자예요. Destroy 대상이 아니에요.
반환된 IStoveResult*호출자Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result) 필수

Example

c
IStoveResult* result = Stove_SetLanguage(L"ko");
if (Stove_IStoveResult_IsSuccessful(result))
{
    // 성공 시 로직을 구현해 주세요.
}
else
{
    // 실패 시 로직을 구현해 주세요.
}

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result);

Notes

  • 이 함수는 동기 함수이며 콜백을 받지 않아요.

Stove_SetStat

종류 함수 · 모듈 GameSupport · 버전 3.5.0

Description

Stove_SetStat()은 지정한 통계(Stat)의 값을 새 값으로 수정하는 함수예요. 수정 결과는 onFinished 콜백으로 전달돼요.

통계·업적 기능은 별도의 초기화 절차를 두지 않고 SDK 초기화에 생명주기가 종속돼요. Stove_Initialize()가 성공한 이후에 호출해요.

Declaration

c
void Stove_SetStat(const IStoveSetStatParam* param, OnSetStatCallback onFinished, void* userData);

Parameters

NameTypeRequiredDescription
paramconst IStoveSetStatParam*Y수정할 통계 ID와 새 값을 담은 파라미터. Stove_CreateParam(k_EStoveGameSupportTypeKind_SetStatParam)으로 생성해요
onFinishedOnSetStatCallbackY수정 결과를 받을 콜백
userDatavoid*N콜백에 그대로 전달되는 사용자 데이터

Returns

없음 (void)

이 함수의 메서드 코드는 k_EStoveGameSupportMethodCode_SetStat 예요.

Callback

c
typedef void(__cdecl* OnSetStatCallback)(const IStoveCallbackResult* callbackResult, const IStoveSetStatOutcome* statOutcome);
NameTypeDescription
callbackResultconst IStoveCallbackResult*호출 결과
statOutcomeconst IStoveSetStatOutcome*수정 결과 정보

이 콜백은 Stove_RunCallback()을 호출한 스레드에서 실행돼요. Stove_SetStat() 호출 1건당 1회만 전달돼요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
5k_EStoveCommonResultCode_InvalidParamparam의 통계 ID(StatsId)가 빈 문자열x
253k_EStoveCommonResultCode_UnmanagedException처리 중 알 수 없는 예외 발생O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException처리 중 내부 예외 발생(엔티티 조회 실패 등)O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

HTTP 통신 실패에 해당하는 코드(HttpError=22, ResponseError=23, ResponseInvalidCode=24, ResponseValueIsNull=25, ResponseInvalidValueFormat=26, NetworkTransportError=249)는 이 함수가 직접 설정하지 않고 하위 통신 계층에서 전달돼요.

구 인터페이스(GameSupport_ModifyStat)는 모듈이 초기화되지 않았을 때 NotInitialized(17)를 반환하는 별도 게이트를 갖고 있지만, 신규 flat C 표면인 Stove_SetStat()에는 이 게이트가 없어요. 즉 이 함수는 17을 반환하지 않아요.

전체 목록: EStoveCommonResultCode

Memory Management

ObjectOwnerRelease
param호출자Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param) 필수 (Stove_SetStat() 호출이 반환된 이후 바로 해제 가능)
콜백의 callbackResultSDK해제 금지. 콜백이 끝나면 무효처리돼요
콜백의 statOutcomeSDK해제 금지. 콜백이 끝나면 무효처리돼요

Example

c
void OnSetStatFinished(const IStoveCallbackResult* callbackResult, const IStoveSetStatOutcome* statOutcome)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

    if (Stove_IStoveResult_IsSuccessful(result) && statOutcome != NULL && Stove_IStoveSetStatOutcome_IsUpdated(statOutcome))
    {
        int32_t currentValue = Stove_IStoveSetStatOutcome_GetCurrentValue(statOutcome);

        // 성공 시 로직을 구현해 주세요.
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

IStoveSetStatParam* param =
    (IStoveSetStatParam*)Stove_CreateParam(k_EStoveGameSupportTypeKind_SetStatParam);
Stove_IStoveSetStatParam_SetStatsId(param, L"KILL_COUNT");
Stove_IStoveSetStatParam_SetStatValue(param, 10);

Stove_SetStat(param, OnSetStatFinished, NULL);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param);

Notes

  • 이 함수는 초기화 여부를 검사하지 않고 곧바로 하위 로직을 수행해요. 미초기화 상태에서 호출하면 ManagedException(254)으로 귀결될 수 있어요.
  • StatValue 는 기존 값에 더해지는 증가분이나 차감되는 값이 아니라, 통계 값을 이 값으로 그대로 대체(설정)해요. 예를 들어 현재 값이 10일 때 StatValue에 5를 넣으면 결과 값은 15가 아니라 5가 돼요. 값을 누적하려면 호출 전에 Stove_FetchStat으로 현재 값을 조회해 더한 뒤 전달해야 해요.
  • 통계 값을 조회하려면 Stove_FetchStat을 사용해요.
  • 실제로 값이 갱신되었는지는 콜백 결과 코드가 아니라 IStoveSetStatOutcome::IsUpdated()로 확인해야 해요.
  • 같은 값을 다시 설정하면 호출은 성공하지만 결과의 IsUpdated()가 false로 와요. 오류가 아니에요.
  • param의 통계 ID 형식은 [A-Z0-9\-_]*$(대문자, 숫자, 밑줄, 하이픈)이에요.
  • 통계·업적 기능은 스토어 전용이에요.
  • 설정하려는 값이 int32 범위를 넘으면 값이 2147483647로 잘려요. 이때도 호출은 성공하며 IStoveSetStatOutcome::IsUpdated()는 true예요.
  • 값이 잘렸는지는 IStoveSetStatOutcome::GetErrorMessage()에 integer overflow가 담기는지로 확인해요.

See Also


Stove_ShutdownNotification

종류 함수 · 모듈 Base · 버전 3.5.0

Description

셧다운 적용 대상 사용자에게 셧다운 알림을 콜백으로 전달해요.

이 API는 한국 전용이 아니에요. 셧다운 정책이 적용된 계정이라면 해외 사용자에게도 동작해요.

Declaration

c
void Stove_ShutdownNotification(const IStoveTypeBase* param, OnShutdownNotificationCallback onFinished, void* userData);

Parameters

NameTypeRequiredDescription
paramconst IStoveTypeBase*N예약된 인자로, 전용 TypeKind는 정의되어 있지 않아요.
onFinishedOnShutdownNotificationCallbackY결과를 받을 콜백이에요.
userDatavoid*N콜백에 그대로 전달되는 사용자 데이터예요.

Returns

없음

이 함수의 메서드 코드는 k_EStoveBaseMethodCode_ShutdownNotification 예요.

Callback

c
typedef void(__cdecl* OnShutdownNotificationCallback)(const IStoveCallbackResult* callbackResult, const IStoveShutdownInfo* shutdown);
NameTypeDescription
callbackResultconst IStoveCallbackResult*호출 결과예요.
shutdownconst IStoveShutdownInfo*셧다운 알림 정보예요. 알림 메시지(GetMsg()), 메시지 노출 시간(GetExposureTime(), 초 단위), 셧다운까지 남은 시간(GetInadvanceMinutes(), 분 단위)을 제공해요.

콜백은 Stove_RunCallback()(또는 Stove_RunCallbackWithTimeout())을 호출한 스레드에서 실행돼요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
5k_EStoveCommonResultCode_InvalidParamonFinished가 nullptrx
16k_EStoveCommonResultCode_BaseNotInitializedSDK가 초기화되지 않음x
253k_EStoveCommonResultCode_UnmanagedException실행 중 알 수 없는 예외가 발생함O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 내부 예외가 발생함O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

이 API는 국가 제한(NotSupportedCountry) 조건이 없어요. 셧다운 적용 계정이면 해외에서도 동일하게 동작해요.

전체 목록: EStoveCommonResultCode, EStoveResultCode

Memory Management

ObjectOwnerRelease
param호출자전달했다면 Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param) 필수
콜백의 callbackResult, shutdownSDK해제 금지. 콜백이 끝나면 무효처리돼요.

Example

c
void OnShutdownNotification(const IStoveCallbackResult* callbackResult, const IStoveShutdownInfo* shutdown)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);
    if (Stove_IStoveResult_IsSuccessful(result))
    {
        // 성공 시 로직을 구현해 주세요.
        const wchar_t* msg = Stove_IStoveShutdownInfo_GetMsg(shutdown);
        int32_t inadvanceMinutes = Stove_IStoveShutdownInfo_GetInadvanceMinutes(shutdown);
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Stove_ShutdownNotification(nullptr, OnShutdownNotification, nullptr);

// 게임 루프에서 주기적으로 호출해야 콜백이 전달돼요.
Stove_RunCallback();

Notes

  • 한국 전용 API가 아니에요. 셧다운 정책이 적용된 계정이면 해외에서도 동작해요.
  • 이 콜백은 1회성이 아니에요. 한 번 등록해 두면, 서버가 내려준 사전 안내 시점(예: 셧다운 30분 전, 10분 전 등)마다 그리고 실제 셧다운 시각이 되었을 때 각각 한 번씩, 서버가 지정한 안내 횟수만큼 반복 호출돼요.

See Also


Stove_StartPurchase

종류 함수 · 모듈 IAP · 버전 3.5.0

Description

params로 전달한 주문 상품 목록에 대해 구매 절차를 시작해요. 진행 방식은 params에 담긴 IStovePurchaseParam의 Operation(EStovePurchaseOperation) 값에 따라 달라져요.

  • Default : Stove Webview를 사용하지 않아요. onFinished로 전달되는 결과에서 일회성 결제 URL을 받아 호출자가 직접 결제 페이지를 열어야 하며, 결제 후에는 Stove_ConfirmPurchase를 호출해 구매를 확정해야 해요.
  • WithWebView : Stove 결제 페이지를 Stove Webview 안에서 열어요. 이 경우에도 결제가 끝나면 호출자가 Stove_ConfirmPurchase를 호출해 구매를 확정해야 해요.
  • WithWebViewAndConfirmResult : Stove 결제 페이지를 Stove Webview 안에서 열고, 결제 성공 시 SDK가 자동으로 Stove_ConfirmPurchase를 호출하여 확정된 구매 결과를 onFinished로 돌려줘요. 이 경우 호출자가 별도로 Stove_ConfirmPurchase를 호출할 필요가 없어요.

웹뷰가 아예 생성되지 않고 호출이 종료되는 모든 실패(미초기화, 파라미터 검증 실패, 예외 등)에서 onDestroy가 PopupNotCreated(33)로 1회 함께 호출돼요. 자세한 내용은 오류코드와 콜백 항목을 참고하세요.

Declaration

c
void Stove_StartPurchase(const IStoveStartPurchaseParam* params,
                          OnStartPurchaseCallback onFinished, OnIAPPopupDestroyCallback onDestroy,
                          void* userData1, void* userData2);

Parameters

NameTypeRequiredDescription
paramsconst IStoveStartPurchaseParam*Y주문 상품 목록과 구매 동작 파라미터예요.
onFinishedOnStartPurchaseCallbackY구매 결과를 받을 콜백이에요.
onDestroyOnIAPPopupDestroyCallbackNSDK가 만든 팝업이 모두 닫혔을 때 호출되는 콜백이에요.
userData1void*NonFinished에 그대로 전달되는 사용자 데이터예요.
userData2void*NonDestroy에 그대로 전달되는 사용자 데이터예요.

Returns

없음

이 함수의 메서드 코드는 k_EStoveIAPMethodCode_StartPurchase 예요.

Callback

c
typedef void(__cdecl* OnStartPurchaseCallback)(const IStoveCallbackResult* callbackResult, const IStoveStartPurchaseOutcome* outcome);

typedef void(__cdecl* OnIAPPopupDestroyCallback)(const IStoveCallbackResult* callbackResult, const IStoveTypeBase* reserved);
NameTypeDescription
callbackResultconst IStoveCallbackResult*호출 결과예요.
outcomeconst IStoveStartPurchaseOutcome*구매 결과예요(옛 인터페이스의 IStovePurchaseResult가 이 이름으로 바뀌었어요). 어떤 필드가 채워지는지는 Operation 값에 따라 달라요(개요 참고).
reservedconst IStoveTypeBase*예약된 매개변수예요. 현재 항상 nullptr이에요.

두 콜백 모두 Stove_RunCallback()을 호출한 스레드에서 실행돼요.

  • onFinished는 호출 1건당 1회만 전달돼요.
  • onDestroy는 이 호출로 생성된 팝업이 모두 닫힌 뒤 1회 전달돼요. 팝업이 아예 생성되지 않고 호출이 종료된 경우에도 결과 코드 PopupNotCreated(33)로 1회 호출돼요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
17k_EStoveCommonResultCode_NotInitialized결제 기능이 초기화되지 않았어요.x
60k_EStoveCommonResultCode_ViewUiNotInitializedOperation이 Default가 아니어서 결제 웹뷰를 열어야 하는데, 웹뷰/팝업 UI 서브시스템이 초기화되지 않았어요.x
65k_EStoveCommonResultCode_WebviewCloseAllFail새 결제 웹뷰를 열기 전, 기존에 열려 있던 IAP 웹뷰를 모두 닫는 데 실패했어요.x
62k_EStoveCommonResultCode_WebviewCreateFail결제 웹뷰 생성 자체가 실패했어요.x
63k_EStoveCommonResultCode_WebviewLoadUrlFail결제 웹뷰에서 결제 페이지 URL 로드에 실패했어요.x
34k_EStoveCommonResultCode_WebviewClosedBeforeCompleteWithWebViewAndConfirmResult 동선에서 결제 완료 통지를 받기 전에 웹뷰가 닫혔어요(사용자 취소 등).O구매가 정상적으로 완료되지 않았습니다. 다시 시도해 주세요. [확인]
66k_EStoveCommonResultCode_WebviewCloseFail웹뷰가 정상적으로 닫히는 과정에서 내부 닫기 처리가 실패했어요. onFinished가 아니라 onDestroy에 실려요.x
80k_EStoveCommonResultCode_ParameterLengthExceededServiceTxnNo가 50자, 또는 ExtraData가 500자를 초과했어요.O결제 정보가 유효하지 않아 결제를 진행할 수 없습니다. 다시 시도해 주세요. [확인]
81k_EStoveCommonResultCode_InvalidJsonStringExtraData가 비어 있지 않은데 JSON 형식이 아니에요.O결제 정보가 유효하지 않아 결제를 진행할 수 없습니다. 다시 시도해 주세요. [확인]
503k_EStoveResultCode_InvalidOrderProductInformation주문 상품 중 수량이 0 이하이거나 판매가(SalePrice)가 음수인 항목이 있어요.O결제 정보가 유효하지 않아 결제를 진행할 수 없습니다. 다시 시도해 주세요. [확인]
252k_EStoveCommonResultCode_NotImplementedIStovePurchaseParam의 Operation 값이 알려진 값(Default/WithWebView/WithWebViewAndConfirmResult)이 아니에요.x
253k_EStoveCommonResultCode_UnmanagedException실행 중 관리되지 않는 예외가 발생했어요.O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 관리되는 예외가 발생했어요(로그인 토큰 등 내부 엔티티 누락 포함).O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
33k_EStoveCommonResultCode_PopupNotCreated팝업이 생성되지 않고 호출이 종료되었어요. onDestroy에만 전달돼요.x

네트워크/서버 응답 오류는 하위 HTTP 계층에서 전달돼요.

Operation == WithWebViewAndConfirmResult인 경우, 결제 성공 후 SDK가 자동으로 Stove_ConfirmPurchase를 호출해요. 이때 확정이 실패하면 그 결과 코드가 그대로 이 함수의 onFinished에 전달될 수 있어요. Stove_ConfirmPurchase 문서의 오류코드도 함께 참고하세요.

전체 목록: EStoveCommonResultCode, EStoveResultCode

Memory Management

ObjectOwnerRelease
params호출자Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)params) 필수. 호출이 반환된 뒤 해제해요.
params에 담긴 각 IStoveOrderProductParam호출자호출자가 소유권을 유지하며, 호출이 반환된 뒤 각각 Destroy() 해야 해요.
params에 담긴 IStovePurchaseParam호출자호출자가 소유권을 유지하며, 호출이 반환된 뒤 Destroy() 해야 해요.
콜백의 callbackResultSDK해제 금지. 콜백이 끝나면 무효처리돼요.
콜백의 outcomeSDK해제 금지. 콜백이 끝나면 무효처리되며, 필요한 값은 콜백 안에서 복사해 두어야 해요.

Example

c
void __cdecl OnStartPurchaseFinished(const IStoveCallbackResult* callbackResult, const IStoveStartPurchaseOutcome* outcome)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);
    if (Stove_IStoveResult_IsSuccessful(result))
    {
        // 성공 시 로직을 구현해 주세요.
        // Operation == Default 인 경우 TempPaymentUrl 로 결제 페이지를 열고,
        // 결제 완료 후 Stove_ConfirmPurchase() 를 호출해 구매를 확정해야 해요.
        int64_t txnMasterNo = Stove_IStoveStartPurchaseOutcome_GetTxnMasterNo(outcome);
        const wchar_t* tempPaymentUrl = Stove_IStoveStartPurchaseOutcome_GetTempPaymentUrl(outcome);
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

void __cdecl OnStartPurchasePopupDestroyed(const IStoveCallbackResult* callbackResult, const IStoveTypeBase* reserved)
{
    // 구매 과정에서 열린 팝업이 모두 닫혔을 때 로직을 구현해 주세요.
    // 팝업이 생성되지 않았던 경우(PopupNotCreated, 33)도 이 콜백으로 전달되며 무시해도 안전해요.
}

// 호출
IStoveOrderProductParam* orderProduct = (IStoveOrderProductParam*)Stove_CreateParam(k_EStoveIAPTypeKind_OrderProductParam);
Stove_IStoveOrderProductParam_SetProductId(orderProduct, productId);
Stove_IStoveOrderProductParam_SetSalePrice(orderProduct, salePrice);
Stove_IStoveOrderProductParam_SetQuantity(orderProduct, 1);

IStovePurchaseParam* purchaseParam = (IStovePurchaseParam*)Stove_CreateParam(k_EStoveIAPTypeKind_PurchaseParam);
Stove_IStovePurchaseParam_SetOperation(purchaseParam, k_EStovePurchaseOperation_Default);

IStoveOrderProductParam* orderProducts[] = { orderProduct };
IStoveStartPurchaseParam* params = (IStoveStartPurchaseParam*)Stove_CreateParam(k_EStoveIAPTypeKind_StartPurchaseParam);
Stove_IStoveStartPurchaseParam_SetProducts(params, orderProducts, 1);
Stove_IStoveStartPurchaseParam_SetPurchaseParam(params, purchaseParam);

Stove_StartPurchase(params, OnStartPurchaseFinished, OnStartPurchasePopupDestroyed, nullptr, nullptr);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)params);
Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)purchaseParam);
Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)orderProduct);

Notes

  • 이 함수는 비동기 함수이며 결과는 onFinished 콜백으로만 전달돼요.
  • Operation이 Default 또는 WithWebView로 시작한 구매는 반드시 Stove_ConfirmPurchase를 호출해 확정해야 해요. WithWebViewAndConfirmResult는 SDK가 자동으로 확정을 처리해요.
  • outcome의 PurchaseProgress(EStovePurchaseProgress) 값으로 결제창을 직접 띄워야 하는지 판단할 수 있어요.
  • 옛 인터페이스에서는 params·상품·옵션 객체를 생성할 때 값 이름에 밑줄이 없었고(k_EStoveIAPTypeKindStartPurchaseParam), 결과 타입 이름도 IStovePurchaseResult였어요. 현재는 각각 k_EStoveIAPTypeKind_StartPurchaseParam, IStoveStartPurchaseOutcome으로 바뀌었어요.
  • 스팀런처 동선과 스토브런처 동선을 구분하는 파라미터나 옵션은 없어요. 스팀 기반으로 실행했을 때 결제창(스토브런처 기능)이 뜰지 스팀 오버레이가 뜰지를 개발사가 설정하는 곳도 없으며, 외부플랫폼연동모듈 초기화 때 넘긴 스팀 유저 아이디(SteamUserId)가 있으면 SDK가 자동으로 스팀 결제 동선(스팀 오버레이)으로 처리해요. 자세한 내용은 결제 가이드의 스팀 결제 절을 참고하세요.

See Also


Stove_Uninitialize

종류 함수 · 모듈 Base · 버전 3.5.0

Description

SDK를 정리(종료)해요. Stove_Initialize()와 짝을 이루는 함수예요.

함수 이름은 대문자 I가 아니라 소문자 i를 쓰는 Stove_Uninitialize예요. 구 인터페이스의 Base_UnInitialize(대문자 I)와 표기가 달라요.

3.5.3 부터 SDK 를 종료할 때 아직 보고하지 않은 게임 이용시간을 바로 서버로 보내요. 그래서 이 함수는 전송 응답을 최대 3초까지 기다릴 수 있어요.

Declaration

c
IStoveResult* Stove_Uninitialize();

Parameters

없음

Returns

TypeDescription
IStoveResult*호출 결과예요. Stove_IStoveResult_GetResultCode()가 0이면 성공이에요.

이 함수의 메서드 코드는 k_EStoveBaseMethodCode_BaseUninitialize 예요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
16k_EStoveCommonResultCode_BaseNotInitialized아직 초기화되지 않은 상태에서 호출했어요.x
253k_EStoveCommonResultCode_UnmanagedException실행 중 알 수 없는 예외가 발생했어요.O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 예외가 발생했어요.O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

전체 목록: EStoveCommonResultCode

Memory Management

ObjectOwnerRelease
반환된 IStoveResult*호출자Stove_IStoveTypeBase_Destroy() 필수

Example

c
IStoveResult* result = Stove_Uninitialize();
if (Stove_IStoveResult_IsSuccessful(result))
{
    // 성공 시 로직을 구현해 주세요.
}
else
{
    // 실패 시 로직을 구현해 주세요.
}

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)result);

Notes

  • Stove_Initialize()와 짝을 이루는 종료 함수예요.
  • 실패로 일부 모듈만 초기화된 상태를 정리하고 Stove_Initialize()를 다시 시도할 때도 이 함수를 사용해요.
  • BASE_NOT_INITIALIZED가 반환되어도 내부 정리 루틴은 계속 진행돼요(로그만 남기고 종료 처리를 이어감).

See Also


Stove_VietnamAgeRatingNotification

종류 함수 · 모듈 Base · 버전 3.5.0

Description

베트남 연령 등급 안내 정보를 콜백으로 전달해요. 베트남 전용 API예요.

이 콜백은 1회성이 아니에요. 함수를 한 번만 호출해 두면 오버레이를 표시하거나 숨겨야 할 때마다 전달돼요. 화면을 그릴 수 있는 시점 이후에 호출해야 해요.

Declaration

c
void Stove_VietnamAgeRatingNotification(const IStoveTypeBase* param, OnVietnamAgeRatingNotificationCallback onFinished, void* userData);

Parameters

NameTypeRequiredDescription
paramconst IStoveTypeBase*N예약된 인자로, 전용 TypeKind는 정의되어 있지 않아요.
onFinishedOnVietnamAgeRatingNotificationCallbackY결과를 받을 콜백이에요.
userDatavoid*N콜백에 그대로 전달되는 사용자 데이터예요.

Returns

없음

이 함수의 메서드 코드는 k_EStoveBaseMethodCode_VietnamAgeRatingNotification 예요.

Callback

c
typedef void(__cdecl* OnVietnamAgeRatingNotificationCallback)(const IStoveCallbackResult* callbackResult, const IStoveVietnamAgeRatingInfo* ageRatingInfo);
NameTypeDescription
callbackResultconst IStoveCallbackResult*호출 결과예요.
ageRatingInfoconst IStoveVietnamAgeRatingInfo*연령 등급 오버레이 정보예요. 오버레이 표시 상태(GetOverlayMode()), 오버레이 색상 종류(GetOverlayType(), 0=Black·1=White), 오버레이 크기(GetOverlayScale(), 0.0 ~ 1.0), 오버레이 투명도(GetOverlayOpacity(), 0.0 ~ 1.0), 게임 등급(GetAgeRating(), 0=전체이용가·12=12세·16=16세·18=18세), 안내 메시지(GetMsg()), 표시 위치 X·Y(GetDisplayPositionX()/GetDisplayPositionY(), 화면 좌상단 기준 0.0 ~ 1.0), 폰트 선택용 언어 코드(GetLanguage())를 제공해요.

콜백은 Stove_RunCallback()(또는 Stove_RunCallbackWithTimeout())을 호출한 스레드에서 실행돼요. 1회성 콜백이며, 렌더링이 가능한 시점 이후에 호출해야 해요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
5k_EStoveCommonResultCode_InvalidParamonFinished가 nullptrx
16k_EStoveCommonResultCode_BaseNotInitializedSDK가 초기화되지 않음x
31k_EStoveCommonResultCode_NotSupportedCountry로그인 계정의 GDS 국가 코드가 베트남(vn)이 아님x
253k_EStoveCommonResultCode_UnmanagedException실행 중 알 수 없는 예외가 발생함O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 내부 예외가 발생함O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

전체 목록: EStoveCommonResultCode, EStoveResultCode

Memory Management

ObjectOwnerRelease
param호출자전달했다면 Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param) 필수
콜백의 callbackResult, ageRatingInfoSDK해제 금지. 콜백이 끝나면 무효처리돼요.

Example

c
void OnVietnamAgeRatingNotification(const IStoveCallbackResult* callbackResult, const IStoveVietnamAgeRatingInfo* ageRatingInfo)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);
    if (Stove_IStoveResult_IsSuccessful(result))
    {
        // 성공 시 로직을 구현해 주세요.
        int32_t overlayMode = Stove_IStoveVietnamAgeRatingInfo_GetOverlayMode(ageRatingInfo);
        const wchar_t* msg = Stove_IStoveVietnamAgeRatingInfo_GetMsg(ageRatingInfo);
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

// 렌더링이 가능한 시점 이후에 1회 호출해요.
Stove_VietnamAgeRatingNotification(nullptr, OnVietnamAgeRatingNotification, nullptr);

// 게임 루프에서 주기적으로 호출해야 콜백이 전달돼요.
Stove_RunCallback();

Notes

  • 베트남 전용 API예요.
  • 1회성 콜백이며, 렌더링이 가능한 시점 이후에 호출해야 해요.

See Also


Stove_VietnamOverimmersionNotification

종류 함수 · 모듈 Base · 버전 3.5.0

Description

베트남 과몰입 방지 안내 정보를 콜백으로 전달해요. 베트남 전용 API예요.

이 콜백은 1회성이 아니에요. 함수를 한 번만 호출해 두면 서버가 정한 주기마다 반복해서 전달되고, 게임을 시작한 직후(경과 0분)에도 한 번 전달돼요. 첫 안내를 놓치지 않으려면 화면을 그릴 수 있는 시점 이후에 호출해야 해요.

Declaration

c
void Stove_VietnamOverimmersionNotification(const IStoveTypeBase* param, OnVietnamOverimmersionNotificationCallback onFinished, void* userData);

Parameters

NameTypeRequiredDescription
paramconst IStoveTypeBase*N예약된 인자로, 전용 TypeKind는 정의되어 있지 않아요.
onFinishedOnVietnamOverimmersionNotificationCallbackY결과를 받을 콜백이에요.
userDatavoid*N콜백에 그대로 전달되는 사용자 데이터예요.

Returns

없음

이 함수의 메서드 코드는 k_EStoveBaseMethodCode_VietnamOverimmersionNotification 예요.

Callback

c
typedef void(__cdecl* OnVietnamOverimmersionNotificationCallback)(const IStoveCallbackResult* callbackResult, const IStoveVietnamOverimmersionInfo* overimmersionInfo);
NameTypeDescription
callbackResultconst IStoveCallbackResult*호출 결과예요.
overimmersionInfoconst IStoveVietnamOverimmersionInfo*과몰입 방지 오버레이 정보예요. 오버레이 표시 상태(GetOverlayMode()), 오버레이 색상 종류(GetOverlayType(), 0=Black·1=White), 오버레이 크기(GetOverlayScale(), 0.0 ~ 1.0), 오버레이 투명도(GetOverlayOpacity(), 0.0 ~ 1.0), 게임 등급(GetAgeRating(), 0=전체이용가·12=12세·16=16세·18=18세), 경고 메시지(GetMsg()), 서식 태그(<b>, <color=#RRGGBBAA> 등)가 포함된 서식 메시지(GetStyledMsg()), 누적 게임 시간(GetElapsedMinutes(), 분 단위), 메시지 노출 시간(GetExposureTime(), 초 단위), 확장 애니메이션 시간(GetExpandAnimationTime(), 초 단위), 표시 위치 X·Y(GetDisplayPositionX()/GetDisplayPositionY(), 화면 좌상단 기준 0.0 ~ 1.0), 폰트 선택용 언어 코드(GetLanguage())를 제공해요.

콜백은 Stove_RunCallback()(또는 Stove_RunCallbackWithTimeout())을 호출한 스레드에서 실행돼요. 1회성 콜백이며, 렌더링이 가능한 시점 이후에 호출해야 해요.

Error Codes

CodeNameDescriptionShow to UserIn-Game Message
0k_EStoveCommonResultCode_Success성공x
5k_EStoveCommonResultCode_InvalidParamonFinished가 nullptrx
16k_EStoveCommonResultCode_BaseNotInitializedSDK가 초기화되지 않음x
31k_EStoveCommonResultCode_NotSupportedCountry로그인 계정의 GDS 국가 코드가 베트남(vn)이 아님x
253k_EStoveCommonResultCode_UnmanagedException실행 중 알 수 없는 예외가 발생함O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]
254k_EStoveCommonResultCode_ManagedException실행 중 내부 예외가 발생함O일시적으로 문제가 발생했습니다. 다시 시도해 주세요. [확인]

전체 목록: EStoveCommonResultCode, EStoveResultCode

Memory Management

ObjectOwnerRelease
param호출자전달했다면 Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param) 필수
콜백의 callbackResult, overimmersionInfoSDK해제 금지. 콜백이 끝나면 무효처리돼요.

Example

c
void OnVietnamOverimmersionNotification(const IStoveCallbackResult* callbackResult, const IStoveVietnamOverimmersionInfo* overimmersionInfo)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);
    if (Stove_IStoveResult_IsSuccessful(result))
    {
        // 성공 시 로직을 구현해 주세요.
        const wchar_t* styledMsg = Stove_IStoveVietnamOverimmersionInfo_GetStyledMsg(overimmersionInfo);
        int32_t elapsedMinutes = Stove_IStoveVietnamOverimmersionInfo_GetElapsedMinutes(overimmersionInfo);
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

// 렌더링이 가능한 시점 이후에 1회 호출해요.
Stove_VietnamOverimmersionNotification(nullptr, OnVietnamOverimmersionNotification, nullptr);

// 게임 루프에서 주기적으로 호출해야 콜백이 전달돼요.
Stove_RunCallback();

Notes

  • 베트남 전용 API예요.
  • 1회성 콜백이며, 렌더링이 가능한 시점 이후에 호출해야 해요.

See Also