PC SDK native 레퍼런스

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

Contents

기본 연동 안내

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

Description

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

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

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

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

Declaration Forms

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

• 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++ 메서드를 호출해요.

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

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

Naming Rules

Memory Lifetime

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

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

// 예: 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);

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

// 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++ 메서드 직접 호출:

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. View 를 함께 사용하려면 SetMainWndHandle(), IAP 를 함께 사용하려면 SetShopKey() 설정
   3. Stove_Initialize(initParam) 호출 — 동기, IStoveResult* 즉시 반환. 설정된 값에 따라 View·IAP 모듈도 함께 초기화됨
6. 반환된 IStoveResult* 결과코드가 0(성공) 이면 사용 가능. 사용 후 Destroy
7. 게임이 실행되는 동안 Stove_RunCallback() 루프를 계속 유지 (메인 스레드)
8. 종료 시 Stove_Uninitialize() 호출 (반환 IStoveResult* Destroy 필수)
9. restartParam, initParam 은 각각 사용이 끝난 뒤(콜백 완료 후 / Stove_Initialize() 반환 후) Stove_IStoveTypeBase_Destroy() 로 해제

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)) 로 다시 꺼내요.

메모리 수명 :

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) — 사용 안 함

Common Interface

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

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

Notes

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

See Also

EStoveBaseMethodCode

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

Description

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

Declaration

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

    k_EStoveBaseMethodCode_Max = 0x7fffffff
} EStoveBaseMethodCode;

Enum Values

Lifecycle / Versioning

Public APIs

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

기타

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

Example

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

See Also

• IStoveResult
• EStoveCommonResultCode
• EStoveResultCode

EStoveBaseTypeKind

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

Description

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

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

Declaration

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 가 반환하거나 콜백으로 전달)

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

Example

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

See Also

• Stove_CreateParam

EStoveCommonResultCode

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

Description

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

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

Declaration

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

    k_EStoveCommonResultCode_Max = 0x7fffffff
} EStoveCommonResultCode;

Enum Values

일반 결과

설정/파라미터 검증 실패

초기화 상태 오류

토큰/엔티티 오류

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

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

HTTP/응답 오류

기타 상태

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

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

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

네트워크 전송 실패

시스템/런타임 실패

Example

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

See Also

• EStoveResultCode
• IStoveResult
• IStoveCallbackResult

EStoveDiscountType

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

Description

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

Declaration

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

Enum Values

Example

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

• IStoveProduct::DiscountTypeValue 의 단위는 이 값에 따라 달라져요.

See Also

• IStoveProduct

EStoveIAPMethodCode

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

Description

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

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

Declaration

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

Enum Values

Example

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

• IStoveResult
• EStoveResultCode
• EStoveCommonResultCode

EStoveIAPTypeKind

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

Description

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

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

Declaration

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

Enum Values

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

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

Example

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

Notes

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

See Also

• Stove_CreateParam
• Stove_FetchProducts
• Stove_StartPurchase

EStoveLogMethodCode

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

Description

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

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

Declaration

typedef enum EStoveLogMethodCode
{
    k_EStoveLogMethodCode_Invalid = -1,

    k_EStoveLogMethodCode_SendLog = 6000,

    k_EStoveLogMethodCode_Max = 0x7fffffff
} EStoveLogMethodCode;

Enum Values

Example

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

• Stove_SendLog

EStoveLogTypeKind

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

Description

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

Declaration

typedef enum EStoveLogTypeKind
{
    k_EStoveLogTypeKind_Invalid = -1,

    k_EStoveLogTypeKind_SendLogParam = 6500,

    k_EStoveLogTypeKind_Max = 0x7fffffff
} EStoveLogTypeKind;

Enum Values

Example

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

Notes

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

See Also

• IStoveSendLogParam
• Stove_SendLog

EStoveOverlayMode

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

Description

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

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

Declaration

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

Example

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

See Also

• IStoveVietnamAgeRatingInfo
• IStoveVietnamOverimmersionInfo

EStovePCBangMethodCode

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

Description

IStoveResult::GetMethodCode() 로 조회되는 값으로, 어떤 PC방 함수가 해당 결과를 생성했는지 식별해요. 로깅이나 오류 라우팅에 사용할 수 있어요.

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

Declaration

typedef enum EStovePCBangMethodCode
{
    k_EStovePCBangMethodCode_Invalid = -1,

    k_EStovePCBangMethodCode_Login = 3000,
    k_EStovePCBangMethodCode_Logout = 3001,
    k_EStovePCBangMethodCode_CheckStatus = 3002,
    k_EStovePCBangMethodCode_RefreshBenefit = 3003,

    k_EStovePCBangMethodCode_Max = 0x7fffffff
} EStovePCBangMethodCode;

Enum Values

Example

IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

if (Stove_IStoveResult_GetMethodCode(result) == k_EStovePCBangMethodCode_Login)
{
    // Stove_PCBangLogin() 의 최초 로그인 결과입니다.
}

Notes

• k_EStovePCBangMethodCode_RefreshBenefit 은 Stove_PCBangLogin 의 onRefreshBenefit 콜백 결과에 대응하는 코드예요. 이 콜백은 로그인 성공 후 4분 주기로 반복 전달되며, 유료(Premium)·무료(Free) 상태 모두에서 계속 호출돼요. Login 코드(최초 로그인, 1회성)와는 발생 시점·횟수가 달라요.

See Also

• Stove_PCBangLogin
• Stove_PCBangLogout
• Stove_PCBangCheckStatus

EStovePCBangPremium

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

Description

로그인한 사용자의 PC방 프리미엄(유료) 이용 상태를 나타내는 값이에요. IStovePCBangLoginOutcome::GetPremiumCheck(), IStovePCBangBenefitInfo::GetPremiumCheck(), IStovePCBangStatus::GetPremiumCheck() 가 이 값을 반환해요.

이 열거형에는 별도의 성공/실패 판정용 코드가 없어요. k_EStovePCBangPremium_Error 는 서버 오류·판단 불가 상태를 나타내는 값이며, 결과 성공 여부는 Stove_IStoveResult_GetResultCode() 값이 0인지로 별도 확인해요.

Declaration

typedef enum EStovePCBangPremium
{
    k_EStovePCBangPremium_Error = -1,
    k_EStovePCBangPremium_Premium = 1,
    k_EStovePCBangPremium_Free = 2,
    k_EStovePCBangPremium_FreeOther = 3,

    k_EStovePCBangPremium_Max = 0x7fffffff
} EStovePCBangPremium;

Enum Values

Example

void __cdecl OnUserLogin(const IStoveCallbackResult* callbackResult, const IStovePCBangLoginOutcome* loginOutcome)
{
    IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);
    if (Stove_IStoveResult_GetResultCode(result) == 0)
    {
        int32_t premium = Stove_IStovePCBangLoginOutcome_GetPremiumCheck(loginOutcome);
        if (premium == k_EStovePCBangPremium_Premium)
        {
            // 프리미엄 혜택 로직을 구현해 주세요.
        }
    }
}

Notes

• 이 값은 IStovePCBangLoginOutcome, IStovePCBangBenefitInfo, IStovePCBangStatus 세 구조체가 공통으로 반환해요.
• PC방 혜택 갱신(Stove_PCBangLogin 의 onRefreshBenefit 콜백)은 4분 주기로 반복 호출되며, Premium·Free 상태 모두에서 계속 호출돼요. 갱신 응답이 정상적으로 도착했지만 그 값이 FreeOther 인 경우에는 반복이 멈춰요. 반면 네트워크 등의 이유로 갱신 요청 자체가 실패한 회차는 반복을 멈추지 않고 다음 주기에 다시 시도해요.

See Also

• IStovePCBangLoginOutcome
• IStovePCBangBenefitInfo
• IStovePCBangStatus

EStovePCBangTypeKind

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

Description

IStoveTypeBase::GetTypeKind() 로 조회되는 값으로, PCBang 비동기 콜백을 통해 전달되는 결과/데이터 객체의 런타임 타입을 식별하는 데 사용돼요.

값 범위는 3000 ~ 3999 로 예약되어 있어요.

Declaration

typedef enum EStovePCBangTypeKind
{
    k_EStovePCBangTypeKind_Invalid = -1,

    k_EStovePCBangTypeKind_StovePCBangLoginOutcome = 3000,
    k_EStovePCBangTypeKind_StovePCBangBenefitInfo = 3001,
    k_EStovePCBangTypeKind_StovePCBangStatus = 3002,

    k_EStovePCBangTypeKind_Max = 0x7fffffff
} EStovePCBangTypeKind;

Enum Values

Example

void __cdecl OnUserLogin(const IStoveCallbackResult* callbackResult, const IStovePCBangLoginOutcome* loginOutcome)
{
    if (Stove_IStoveTypeBase_GetTypeKind((const IStoveTypeBase*)loginOutcome) == k_EStovePCBangTypeKind_StovePCBangLoginOutcome)
    {
        // loginOutcome 을 IStovePCBangLoginOutcome 으로 사용합니다.
    }
}

Notes

• 이 열거형에 포함된 값은 모두 PC방 기능이 콜백으로 전달하는 결과/데이터 타입이며, 호출자가 생성하는 입력 파라미터 타입은 없어요.
• 3000~3999 범위는 PC방 기능 전용으로 예약되어 있어 다른 모듈의 TypeKind 값과 겹치지 않아요.

See Also

• IStovePCBangLoginOutcome
• IStovePCBangBenefitInfo
• IStovePCBangStatus

EStoveProductTypeCode

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

Description

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

Declaration

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

Example

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

Notes

• IStoveProduct::ProductTypeCode 값을 해석할 때 사용해요.

See Also

• IStoveProduct

EStovePurchaseLimitTypeCode

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

Description

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

Declaration

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

Example

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

Notes

• IStoveProduct::PurchaseLimitCount 를 해석할 때 이 값을 함께 사용해요.

See Also

• IStoveProduct

EStovePurchaseOperation

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

Description

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

Declaration

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

Enum Values

Example

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

Notes

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

See Also

• IStovePurchaseParam
• Stove_StartPurchase
• IStoveStartPurchaseOutcome

EStovePurchaseProgress

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

Description

IStoveStartPurchaseOutcome 의 PurchaseProgress 로 반환돼요.

Declaration

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

Enum Values

Example

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

Notes

• NeedPaymentWindow 일 때는 IStoveStartPurchaseOutcome::TempPaymentUrl 을 사용해 결제 창을 열고, 결제 후 Stove_ConfirmPurchase 로 구매를 확정해야 해요.

See Also

• IStoveStartPurchaseOutcome
• Stove_StartPurchase

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

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

    k_EStoveResultCode_Max = 0x7fffffff
} EStoveResultCode;

Enum Values

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

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

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

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

5xx — IAP 구매 / 페이로드

Example

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

See Also

• EStoveCommonResultCode
• IStoveResult

EStoveTermsOperation

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

Description

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

Declaration

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

Enum Values

Example

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

• IStoveFetchTermsAgreementParam
• Stove_FetchTermsAgreement
• IStoveTermsAgreementOutcome

EStoveViewMethodCode

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

Description

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

이 열거형의 값 범위는 1000 ~ 1999 (모듈 블록) 이며, 팝업 API 들이 연속해서 번호를 써요.

Declaration

typedef enum EStoveViewMethodCode
{
    k_EStoveViewMethodCode_Invalid = -1,
    k_EStoveViewMethodCode_AutoPopup = 1000,
    // ... 이하 열거값 표 참조
    k_EStoveViewMethodCode_SetPopupDisallowed = 1005,
    k_EStoveViewMethodCode_Max = 0x7fffffff
} EStoveViewMethodCode;

Enum Values

Example

IStoveResult* result = Stove_IStoveCallbackResult_GetResult(callbackResult);

if (Stove_IStoveResult_GetMethodCode(result) == k_EStoveViewMethodCode_ManualPopup)
{
    // Stove_ManualPopup() 호출의 결과인 경우 로직을 구현해 주세요.
}

Notes

• 값 범위(1000~1999)는 다른 모듈의 MethodCode 값과 겹치지 않아요.
• Stove_CloseAllPopups() 는 View 뿐 아니라 IAP 팝업까지 함께 닫는 BaseSDK 소속 통합 함수이며, 이 열거형에 대응하는 값을 갖지 않아요.
• 같은 팝업이라도 구 인터페이스와 값이 달라요. 구 인터페이스(View_AutoPopup 등)는 81 · 83 · 85 · 87 · 91 · 160 을 그대로 돌려주고, 신규 인터페이스는 이 열거형의 1000 번대 값을 돌려줘요. 두 벌을 함께 쓰는 동안에는 로그 집계 기준을 벌마다 나누어 두세요.

Changelog

See Also

• Stove_AutoPopup
• Stove_ManualPopup
• Stove_NewsPopup
• Stove_CouponPopup
• Stove_VerifyIdentificationPopup
• Stove_SetPopupDisallowed

EStoveViewTypeKind

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

Description

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

이 열거형의 값 범위는 1000 ~ 1999 예요. 파라미터 타입은 1500대, 콜백으로 전달되는 페이로드 타입은 1504 하나예요. 값 범위가 다른 모듈의 TypeKind 열거형과 겹치지 않으므로 Stove_CreateParam() 하나로 모든 모듈의 파라미터를 생성할 수 있어요.

Declaration

typedef enum EStoveViewTypeKind
{
    k_EStoveViewTypeKind_Invalid = -1,
    k_EStoveViewTypeKind_SetPopupDisallowedParam = 1500,
    // ... 이하 열거값 표 참조
    k_EStoveViewTypeKind_VerifyIdentificationPopupDestroyInfo = 1504,
    k_EStoveViewTypeKind_Max = 0x7fffffff
} EStoveViewTypeKind;

Enum Values

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

Callback payload types (SDK 가 생성해 콜백으로 전달)

Example

IStovePopupParam* param =
    (IStovePopupParam*)Stove_CreateParam(k_EStoveViewTypeKind_PopupParam);

// param 사용 후
Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param);

Notes

• 파라미터 타입(1500~1503)은 Stove_CreateParam() 인자로 사용해요. 콜백 페이로드 타입(1504)은 SDK 가 만들어 전달하므로 직접 생성하지 않아요.
• 값 범위(1000~1999)는 다른 모듈의 EStove<Module>TypeKind 값과 겹치지 않아요.

Changelog

See Also

• Stove_CreateParam
• IStoveSetPopupDisallowedParam
• IStovePopupParam

EStoveWebViewMode

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

Description

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

Declaration

typedef enum EStoveWebViewMode
{
    k_EStoveWebViewMode_Invalid = -1,

    k_EStoveWebViewMode_External = 0,
    k_EStoveWebViewMode_Internal = 1,

    k_EStoveWebViewMode_Max = 0x7fffffff
} EStoveWebViewMode;

Enum Values

Example

int32_t webViewMode = k_EStoveWebViewMode_Internal;

Notes

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

Changelog

See Also

• 없음

IStoveAccessToken

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

Description

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

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

Declaration

typedef struct IStoveAccessToken IStoveAccessToken;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용합니다.

Members

Memory Management

Example

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

• Stove_AccessTokenRenewed
• Stove_GetAccessToken

IStoveCallbackResult

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

Description

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

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

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

Declaration

typedef struct IStoveCallbackResult IStoveCallbackResult;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용합니다.

Members

Memory Management

Example

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

• Stove_RunCallback
• IStoveResult

IStoveChargeInfo

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

Description

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

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

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

Declaration

typedef struct IStoveChargeInfo IStoveChargeInfo;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용합니다.

Members

Memory Management

Example

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

    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

• IStoveStartPurchaseOutcome 의 ChargeInfoAt() 과 IStoveConfirmPurchaseOutcome 의 ChargeInfoAt() 양쪽에서 전달돼요.
• 한 번의 구매에 여러 결제 수단이 함께 사용된 경우, 배열에 결제 수단별로 항목이 나뉘어 담겨요.

See Also

• IStoveStartPurchaseOutcome
• IStoveConfirmPurchaseOutcome
• IStovePurchasedProduct

IStoveConfirmPurchaseOutcome

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

Description

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

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

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

Declaration

typedef struct IStoveConfirmPurchaseOutcome IStoveConfirmPurchaseOutcome;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용합니다.

Members

Memory Management

Example

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

    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

• Stove_ConfirmPurchase
• IStoveStartPurchaseOutcome
• IStovePurchasedProduct
• IStoveChargeInfo

IStoveConfirmPurchaseParam

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

Description

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

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

Declaration

typedef struct IStoveConfirmPurchaseParam IStoveConfirmPurchaseParam;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용합니다.

Members

Memory Management

Example

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

• Stove_ConfirmPurchase
• Stove_StartPurchase
• IStoveStartPurchaseOutcome

IStoveFetchProductsParam

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

Description

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

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

Declaration

typedef struct IStoveFetchProductsParam IStoveFetchProductsParam;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용합니다.

Members

Memory Management

Example

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

• Stove_FetchProducts
• IStoveProductList
• IStoveShopCategory

IStoveFetchTermsAgreementParam

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

Description

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

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

Declaration

typedef struct IStoveFetchTermsAgreementParam IStoveFetchTermsAgreementParam;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용합니다.

Members

Memory Management

Example

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

• Stove_FetchTermsAgreement
• IStoveWebViewLayoutParam
• IStoveTermsAgreementOutcome

IStoveGds

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

Description

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

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

Declaration

typedef struct IStoveGds IStoveGds;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용합니다.

Members

Memory Management

Example

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

• Stove_GetGds

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

typedef struct IStoveInitializeParam IStoveInitializeParam;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용합니다.

Members

Memory Management

Example

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

• Stove_Initialize
• Stove_CreateParam
• IStoveRestartAppIfNecessaryParam

IStoveInventoryItem

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

Description

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

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

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

Declaration

typedef struct IStoveInventoryItem IStoveInventoryItem;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용합니다.

Members

Memory Management

Example

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

• Stove_FetchInventory
• IStoveInventoryList
• IStoveProduct

IStoveInventoryList

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

Description

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

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

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

Declaration

typedef struct IStoveInventoryList IStoveInventoryList;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용합니다.

Members

Memory Management

Example

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

• Stove_FetchInventory
• IStoveInventoryItem

IStoveManualPopupParam

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

Description

IStoveManualPopupParam 은 수동 팝업(Manual Popup) 을 표시할 때 사용하는 파라미터 타입이에요. ResourceKey 로 어떤 팝업 콘텐츠를 표시할지 지정해요. Stove_ManualPopup 의 입력으로 사용해요.

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

Declaration

typedef struct IStoveManualPopupParam IStoveManualPopupParam;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용합니다.

Members

Memory Management

Example

IStoveManualPopupParam* param =
    (IStoveManualPopupParam*)Stove_CreateParam(k_EStoveViewTypeKind_ManualPopupParam);
Stove_IStoveManualPopupParam_SetWebViewMode(param, k_EStoveWebViewMode_Internal);
Stove_IStoveManualPopupParam_SetResourceKey(param, L"EVENT_BANNER_01");

Stove_ManualPopup(param, OnPopupFinished, OnPopupDestroyed, NULL, NULL);

Stove_IStoveTypeBase_Destroy((IStoveTypeBase*)param);

Notes

• ResourceKey 를 설정하지 않으면 어떤 팝업 콘텐츠를 표시할지 결정할 수 없어요.

See Also

• Stove_ManualPopup
• EStoveWebViewMode

IStoveOrderProductParam

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

Description

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

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

Declaration

typedef struct IStoveOrderProductParam IStoveOrderProductParam;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용합니다.

Members

Memory Management

Example

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);

Notes

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

See Also

• Stove_StartPurchase
• IStoveStartPurchaseParam
• IStoveProduct

IStoveOverImmersionInfo

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

Description

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

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

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

Declaration

typedef struct IStoveOverImmersionInfo IStoveOverImmersionInfo;
// 멤버 접근은 아래 멤버 표의 접근 함수를 사용합니다.