PC SDK unity 레퍼런스

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

Contents

기본 연동 안내

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

Description

이 가이드의 C# API 는 .NET (Mono / IL2CPP) 환경에서 SDK 의 모든 기능을 호출하기 위한 매니지드 래퍼예요. 내부적으로는 P/Invoke 를 통해 Native DLL 의 C flat 함수를 호출하지만, 호출자는 매니지드 타입(readonly struct, struct, enum, delegate) 만 다루면 돼요.

호환성: C# 7.3 (.NET Framework 4.6, Unity 2019 Mono) 이상.

Declaration Forms

모든 타입은 Stove.PCSDK.V3 네임스페이스 아래에 정의되며, 모듈마다 static partial class (Base, IAP, Log, PCBang, View) 가 존재해요. 동일 클래스 안에 메서드 · 구조체 · 콜백 delegate · 열거형이 함께 선언돼요. GamingServices 모듈은 신규 인터페이스에서 제공하지 않아요.

using Stove.PCSDK.V3;

// 또는 모듈별로 정적 import:
using static Stove.PCSDK.V3.Base;
using static Stove.PCSDK.V3.IAP;

using static 을 사용하면 클래스 접두사 없이 Stove_Initialize() 처럼 직접 호출할 수 있어요.

Naming Rules

Memory Lifetime

본 가이드의 모든 타입은 매니지드 (C#) 타입이며 GC 가 관리해요. Native API 처럼 Destroy() 를 명시적으로 호출할 필요가 없어요.

Initialization Order

1. IStoveRestartAppIfNecessaryParam 구조체를 생성하고 Environment, GameId, AppKey, WaitTimeMilliSec, LaunchStoveLauncher, PlatformName 을 설정해요. (IStoveRestartAppIfNecessaryParam)
2. Stove_RestartAppIfNecessary(restartParam, onFinished) 를 호출해요 — 비동기. 콜백은 Stove_RunCallback() 이 호출되는 시점에 디스패치돼요.
3. 게임 메인 루프(메인/UI 스레드)에서 매 프레임 Stove_RunCallback() 을 호출하기 시작해요. Stove_RestartAppIfNecessary() 호출 직후부터 이 루프가 돌아야 위 (2)의 콜백이 디스패치되어 (4)의 초기화로 이어져요.
4. 콜백의 outcome.IsRestartRequired == false 분기에서 IStoveInitializeParam 구조체를 생성해요. View 를 함께 사용하려면 MainWndHandle, IAP 를 함께 사용하려면 ShopKey 도 설정해요. (IsRestartRequired == true 면 SDK 가 런처를 통해 재실행을 처리하므로 현재 프로세스는 종료됨. IStoveInitializeParam)
5. 같은 분기에서 Stove_Initialize(initParam) 를 호출해요 — 동기, IStoveResult 를 즉시 반환해요. result.IsSuccessful 로 성공 여부를 확인해요.
6. 종료 시 Stove_Uninitialize() 를 호출해요.

using Stove.PCSDK.V3;
using static Stove.PCSDK.V3.Base;

// 1) 런처 확인 / 재실행 파라미터 구조체 생성 및 설정
var restartParam = new IStoveRestartAppIfNecessaryParam
{
    Environment        = "LIVE",          // "QA" / "SANDBOX" / "LIVE"
    GameId             = "my_game_id",
    AppKey             = "my_app_key",
    WaitTimeMilliSec   = 5000,
    LaunchStoveLauncher = true,
    PlatformName       = "stove",
};

// 2) 런처 실행 확인 (비동기). 콜백은 Stove_RunCallback() 이 호출되는 시점에 디스패치됩니다.
Stove_RestartAppIfNecessary(restartParam, (callbackResult, outcome) =>
{
    if (outcome.IsRestartRequired)
        return;  // SDK 가 런처를 통해 재실행 처리, 현재 프로세스는 종료됨

    // 4) SDK 초기화 (동기). initParam 의 MainWndHandle/ShopKey 설정에 따라 View·IAP 도 함께 초기화
    var initParam = new IStoveInitializeParam
    {
        // View 를 함께 사용하려면 MainWndHandle, IAP 를 함께 사용하려면 ShopKey 도 설정
        // MainWndHandle = myWindowHandle,
        // ShopKey       = "my_shop_key",
    };

    var result = Stove_Initialize(initParam);
    if (result.IsSuccessful)
    {
        // 초기화 완료, SDK 사용 가능
    }
    else
    {
        // 실패 처리: result.ResultCode, result.ExceptionMessage
    }
});

// 3) 매 프레임 / 매 tick 에서 콜백 실행 (메인 / UI 스레드)
//    Stove_RestartAppIfNecessary() 호출 직후부터 이 루프가 돌아야 위 (2)의 콜백이 디스패치되어 (4) 초기화로 이어집니다.
void OnUpdate()
{
    Stove_RunCallback();
}

// 5) 종료 시
Stove_Uninitialize();

Callback Execution Rules

• 모든 비동기 메서드의 콜백은 Stove_RunCallback() 또는 Stove_RunCallbackWithTimeout(timeoutMillisec) 가 호출되는 스레드(메인 / UI 스레드) 에서 실행돼요. SDK 내부 스레드가 아니에요.
• 콜백 시그니처는 delegate void On<Action>Callback(IStoveCallbackResult callbackResult, ...) 형태이며, 성공 여부는 callbackResult.Result.IsSuccessful 로 판정해요.
• 1회성 콜백(Stove_VietnamAgeRatingNotification, Stove_VietnamOverimmersionNotification 등) 은 렌더링이 가능한 시점 이후에 호출되어야 해요. 게임 시작 후 첫 프레임이 그려진 뒤 등록 / 호출하세요.
• 반복 호출 콜백(Stove_AccessTokenRenewed, Stove_OverImmersionNotification 등) 에 등록한 delegate 는 SDK 가 종료되거나 등록이 해제될 때까지 참조돼요. 캡처한 객체의 수명에 주의하세요.
• 1회성 비동기 메서드의 onFinished 콜백은 필수 매개변수예요. 지정하지 않으면 k_EStoveCommonResultCode_InvalidParam(5) 이 발생해요.

Common Interface

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

• IStoveResult — 동기 메서드의 호출 결과예요. 메서드 코드, 결과 코드, 매니지드 예외 메시지를 담는 불변 구조체예요.
• IStoveCallbackResult — 비동기 콜백으로 전달되는 결과예요. IStoveResult 와 외부 에러 정보(HTTP 코드 등) 를 함께 담아요.

Notes

• Stove_RestartAppIfNecessary() 는 반드시 Stove_Initialize() 보다 먼저 호출해야 하며, 그 콜백을 받으려면 호출 직후부터 Stove_RunCallback() 을 게임 루프에서 돌리고 있어야 해요.
• Stove_Initialize() 는 동기 메서드라 콜백을 받지 않지만, Stove_RestartAppIfNecessary() 의 콜백 안(outcome.IsRestartRequired == false 분기)에서 호출해야 해요.
• 본 API 의 비동기 메서드는 userData 매개변수를 받지 않아요. 콜백 안에서 사용할 컨텍스트는 람다 캡처로 전달하세요.

See Also

EStoveBaseMethodCode

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

Description

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

Declaration

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

    k_EStoveBaseMethodCode_Max = 0x7fffffff
}

Enum Values

Lifecycle / Versioning

Public APIs

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

기타

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

Example

using static Stove.PCSDK.V3.Base;

IStoveResult result = Stove_Initialize();

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

Notes

• 96번대 이후의 Internal 메서드 코드는 재생시간 보고, 서버 설정, 토큰 처리 등 SDK 내부 동작에 사용되며 게임에서 직접 호출하는 API 와 대응하지 않아요.
• 115~119번의 Private 게터는 이름에 Internal 이 없어 표에 포함했지만, 다른 SDK 모듈에만 노출되는 비공개 API 이며 게임에는 제공되지 않아요.
• IStoveResult.MethodCode 는 uint 타입이므로 이 열거형 값과 비교할 때는 (uint)EStoveBaseMethodCode.k_... 로 형변환해요.
• 이전 형상에서는 값 이름에 밑줄이 없었어요(k_EStoveBaseMethodCodeBaseInitialize). 현재 소스는 k_EStoveBaseMethodCode_BaseInitialize 처럼 열거형 이름과 값 이름 사이에 밑줄이 들어가요.

Changelog

See Also

• IStoveResult
• EStoveCommonResultCode
• EStoveResultCode

EStoveBaseTypeKind

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

Description

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

C# 인터페이스에는 Stove_CreateParam() 에 대응하는 공개 함수가 없어요. IStoveInitializeParam, IStoveSetGameProfileParam 같은 파라미터 구조체는 게임 코드가 new IStoveXxx { ... } 로 직접 생성하며, 이 열거형은 내부 marshaling(네이티브 DLL 과의 상호운용) 과정에서 SDK 내부적으로만 사용돼요.

값 범위는 0 ~ 999 예요.

Declaration

public enum EStoveBaseTypeKind
{
    k_EStoveBaseTypeKind_Invalid = -1,
    k_EStoveBaseTypeKind_Base = 0,
    // ... 이하 열거값 표 참조
    k_EStoveBaseTypeKind_SetGameProfileParam = 502,

    k_EStoveBaseTypeKind_Max = 0x7fffffff,
}

Enum Values

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

Parameter types (내부적으로 파라미터 marshaling 에 사용)

Example

// C# 게임 코드는 이 열거형을 직접 다루지 않습니다.
// 파라미터는 아래와 같이 값 타입을 직접 생성해서 사용합니다.
IStoveSetGameProfileParam gameProfileParam = new IStoveSetGameProfileParam
{
    WorldId = "world_01",
    CharacterNo = 123456789L,
};

Notes

• 신규 flat C 인터페이스에서는 이 열거형을 Stove_CreateParam() 호출에 직접 사용하지만, C# 인터페이스는 대응하는 공개 생성 함수가 없어 게임 코드에서 이 열거형을 참조할 일이 거의 없어요.
• 값 500(k_EStoveBaseTypeKind_RestartAppIfNecessaryParam)이 신설되고 InitializeParam / SetGameProfileParam 이 501/502 로 한 칸씩 밀리는 등, 이전 형상(InitializeParam=500, GameProfileParams=501) 과 번호가 달라졌어요.
• StoveOverImmersionInfo(7), StoveShutdownInfo(10) 는 이전 형상에서 StoveOverImmersion, StoveShutdown 이라는 이름이었어요.

Changelog

See Also

• IStoveInitializeParam
• IStoveRestartAppIfNecessaryParam
• IStoveSetGameProfileParam

EStoveCommonResultCode

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

Description

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

모듈별 대역으로 재배치된 전용 코드는 EStoveResultCode(300~503)를 참조하세요.

Declaration

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

    k_EStoveCommonResultCode_Max = 0x7fffffff
}

Enum Values

일반 결과

설정/파라미터 검증 실패

초기화 상태 오류

토큰/엔티티 오류

HTTP/응답 오류

기타 상태

Local DB 실패 (모든 Stove SDK 모듈 공통)

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

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

네트워크 전송 실패

시스템/런타임 실패

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

• 19 k_EStoveCommonResultCode_InvalidAccessToken — 로그인 세션 만료로 게임 종료 후 재실행이 필요해요

Example

using static Stove.PCSDK.V3.Base;

IStoveResult result = Stove_Uninitialize();

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

Notes

• 모든 SDK API 및 다른 SDK 모듈이 공통으로 사용하는 결과 코드예요.
• 모듈별 대역으로 재배치된 전용 코드는 EStoveResultCode(300~503)로 정의되며, 번호가 이 열거형과 겹치지 않아요.
• 단일 바이너리 통합으로 대역이 크게 늘었어요. 이전 형상에서는 이 열거형이 32번대까지만 정의되어 있었지만, 현재는 웹뷰/팝업 UI 코드(60 ~ 68), 파라미터/페이로드 검증 코드(80 ~ 82) 등이 새로 이 열거형에 흡수되어 0 ~ 255 전 구간에 값이 분포해요.
• k_EStoveCommonResultCode_PopupNotCreated(33)는 내부 정리 전용이며 사용자 delegate 로 전달되지 않지만, 이름에 Internal 이 포함되어 있지 않아 표에는 포함했어요.

Changelog

See Also

• EStoveResultCode
• IStoveResult
• IStoveCallbackResult

EStoveDiscountType

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

Description

IStoveProduct.DiscountType 으로 반환되는 값이에요. IStoveProduct.DiscountTypeValue 의 값을 퍼센트로 해석할지, 정액으로 해석할지를 결정해요.

Declaration

public enum EStoveDiscountType
{
    k_EStoveDiscountType_None = 0,
    k_EStoveDiscountType_FixedRate = 1,
    k_EStoveDiscountType_FlatRate = 2,

    k_EStoveDiscountType_Max = 0x7fffffff
}

Enum Values

Example

if (product.DiscountType == EStoveDiscountType.k_EStoveDiscountType_FixedRate)
{
    // product.DiscountTypeValue 를 퍼센트로 해석하는 로직을 구현해 주세요.
}

Notes

• IStoveProduct.IsDiscounted 가 true 인 상품에서만 이 값이 유효해요.

See Also

• Stove_FetchProducts
• IStoveProduct

EStoveIAPMethodCode

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

Description

IStoveResult.MethodCode 로 조회하며, 어떤 결제 API 가 이 결과를 만들었는지 식별해요. 로깅이나 오류 처리 분기에 사용해요.

값은 IAP 모듈 블록(2000번대) 안에서 순번으로 부여돼요.

Declaration

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

Enum Values

Example

if (callbackResult.Result.MethodCode == (uint)EStoveIAPMethodCode.k_EStoveIAPMethodCode_StartPurchase)
{
    // Stove_StartPurchase() 호출에서 발생한 결과입니다.
}

Notes

• 모듈별 EStoveIAPResultCode 는 삭제되었어요. 결과 코드는 공통(EStoveCommonResultCode)과 모듈별(EStoveResultCode) 열거형으로 통합되었어요.
• IStoveResult.MethodCode 는 uint 타입이므로 비교 시 형변환이 필요해요.
• 단일 바이너리 통합 이전에 있던 Initialize / Uninitialize / GetVersion 등 라이프사이클 코드는 Base 쪽 열거형으로 옮겨졌어요.

See Also

• EStoveResultCode
• EStoveCommonResultCode

EStoveIAPTypeKind

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

Description

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

C# 인터페이스에서는 파라미터가 일반 struct(IStoveFetchProductsParam 등)로 제공되므로 호출자가 이 값을 직접 사용할 일은 없어요. Interop 계층이 네이티브 파라미터 객체를 생성할 때 내부적으로 이 값을 사용해요.

값의 범위는 2000~2999 예요. 이 중 2000번대는 SDK 가 콜백으로 전달하는 결과/데이터 타입이고, 2500번대는 파라미터 타입이에요. 값이 20개를 넘어 성격별로 나누어 정리했어요.

Declaration

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

Enum Values

결과 / 데이터 타입 (SDK 가 콜백으로 전달)

파라미터 타입 (호출자가 Stove_CreateParam 으로 생성)

VoidedPurchase · PaymentParam 관련 번호는 내부 전용으로 전환되어 표에서 제외했어요. VoidedPurchasesEx · FetchVoidedPurchasesExParam 관련 번호(2007, 2508)는 환불 조회 기능 자체가 소스에서 삭제되어 예약 번호로만 남아 있어요. v2 관리형 API 에는 VoidedPurchase 계열 타입이 제공되지 않아요.

Example

// C# 인터페이스에서는 이 값을 직접 사용하지 않으며,
// 아래와 같이 대응하는 struct 를 바로 생성해 사용합니다.
var fetchProductsParam = new IStoveFetchProductsParam { CategoryId = "", PageIndex = 1, PageSize = 20 };

Notes

• Base, IAP 등 모듈별 TypeKind 열거형은 서로 겹치지 않는 정수 범위를 사용해요.
• 2000번대(결과/데이터 타입)는 호출자가 직접 생성하지 않으며, 콜백으로 전달되는 값의 타입으로만 나타나요.
• k_EStoveIAPTypeKind_StartPurchaseOutcome 은 구 인터페이스의 IStovePurchaseResult 에 대응해요. 이름이 바뀌었어요.

See Also

• Stove_FetchProducts
• Stove_StartPurchase

EStoveLocale

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

Description

PCSDK UI 언어 선택자예요. k_EStoveLocale_System 은 사용자의 OS 언어를 따라요.

[Obsolete] 로 표시된 Stove_SetLanguage(EStoveLocale language) 오버로드에서 사용해요. 이 오버로드는 내부적으로 값을 문자열로 변환해 Stove_SetLanguageEx(string language) 와 동일한 네이티브 API 를 호출해요.

이 열거형을 사용하는 Stove_SetLanguage(EStoveLocale) 오버로드는 [Obsolete("Use Stove_SetLanguageEx(string language) instead.")] 로 표시되어 있어요. 신규 코드는 문자열을 받는 Stove_SetLanguageEx(string) 를 사용해야 해요.

Declaration

public enum EStoveLocale
{
    k_EStoveLocale_Invalid = -1,

    k_EStoveLocale_System = 0,
    k_EStoveLocale_En = 1,
    k_EStoveLocale_Ko = 2,
    k_EStoveLocale_Ja = 3,
    k_EStoveLocale_ZhCn = 4,
    k_EStoveLocale_ZhTw = 5,
    k_EStoveLocale_De = 6,
    k_EStoveLocale_Fr = 7,
    k_EStoveLocale_Es = 8,
    k_EStoveLocale_Pt = 9,
    k_EStoveLocale_Th = 10,
    k_EStoveLocale_Vi = 11,

    k_EStoveLocale_Max = 0x7fffffff
}

Enum Values

Example

using static Stove.PCSDK.V3.Base;

// 신규 코드는 Stove_SetLanguageEx(string) 를 사용해야 합니다.
IStoveResult result = Stove_SetLanguageEx("ko");

Notes

• EStoveLocale 은 C# 인터페이스에만 있는 열거형이에요. 신규 flat C 인터페이스에는 대응하는 열거형이 없으며, 언어 설정은 문자열(const wchar_t*) 하나만 받는 Stove_SetLanguage() 로 제공돼요.
• C# 소스(BaseAPIV2.cs)의 LocaleToString() 은 이 열거형 값을 소문자 문자열로 변환해요. 매핑 규칙은 '_' → '-'(예: k_EStoveLocale_ZhCn → "zh-cn")이에요.
• k_EStoveLocale_Invalid, k_EStoveLocale_Max 는 변환 시 모두 "system" 으로 처리돼요.
• 이 열거형을 사용하는 Stove_SetLanguage(EStoveLocale) API 자체가 [Obsolete] 이며, 신규 코드는 Stove_SetLanguageEx(string) 를 사용해야 해요.

Changelog

See Also

• 없음

EStoveLogMethodCode

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

Description

IStoveResult 를 만든 로그 기능의 API 가 무엇인지 식별하는 값이에요. IStoveResult.MethodCode 로 조회할 수 있으며, 로그 기록이나 오류 처리 분기에 사용해요.

이 열거형이 쓰는 정수 범위는 6000 ~ 6999 예요.

Declaration

public enum EStoveLogMethodCode
{
    k_EStoveLogMethodCode_Invalid = -1,
    k_EStoveLogMethodCode_SendLog = 6000,
    k_EStoveLogMethodCode_Max = 0x7fffffff
}

Enum Values

Example

using static Stove.PCSDK.V3.Log;

void OnSendLogCallback(IStoveCallbackResult callbackResult)
{
    uint methodCode = callbackResult.Result.MethodCode; // k_EStoveLogMethodCode_SendLog
}

Notes

• 로그 기능은 공개 API 가 Stove_SendLog 하나뿐이므로 MethodCode 값도 하나예요.
• 이전 인터페이스에 있던 모듈별 결과 코드 열거형 EStoveLogResultCode 는 삭제되었어요. 실패 원인은 IStoveResult.ResultCode 로 확인하며, 값은 모듈별 EStoveResultCode 또는 공통 EStoveCommonResultCode 에 정의되어 있어요.

See Also

• Stove_SendLog

EStoveLogTypeKind

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

Description

로그 기능이 다루는 파라미터 구조체의 구체적인 타입을 식별하는 값이에요.

이 열거형이 쓰는 정수 범위는 6000 ~ 6999 예요.

Declaration

public enum EStoveLogTypeKind
{
    k_EStoveLogTypeKind_Invalid = -1,
    k_EStoveLogTypeKind_SendLogParam = 6500,
    k_EStoveLogTypeKind_Max = 0x7fffffff
}

Enum Values

Example

// C# 인터페이스는 IStoveSendLogParam 을 직접 생성해 사용하며,
// 이 열거형 값을 API 호출에 직접 전달하지 않습니다.

Notes

• 로그 기능이 정의하는 파라미터 타입은 IStoveSendLogParam 하나뿐이며, 결과/데이터 타입은 없어요(콜백은 IStoveCallbackResult 만 전달해요).
• 6000~6999 범위는 Log 전용으로 예약되어 있어 다른 모듈의 TypeKind 값과 겹치지 않아요.

See Also

• IStoveSendLogParam
• Stove_SendLog

EStoveOverlayMode

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

Description

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

IStoveVietnamAgeRatingInfo.OverlayMode, IStoveVietnamOverimmersionInfo.OverlayMode 로 조회해요(두 프로퍼티 모두 int 타입이며, 이 열거형 값을 담아요).

Declaration

public enum EStoveOverlayMode
{
    k_EStoveOverlayMode_Invalid = -1,

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

    k_EStoveOverlayMode_Max = 0x7fffffff
}

Enum Values

Example

using static Stove.PCSDK.V3.Base;

void OnVietnamAgeRatingNotificationCallback(IStoveCallbackResult callbackResult, IStoveVietnamAgeRatingInfo ageRatingInfo)
{
    if (ageRatingInfo.OverlayMode == (int)EStoveOverlayMode.k_EStoveOverlayMode_Show)
    {
        // 오버레이를 표시하는 로직을 구현해 주세요.
    }
}

Notes

• k_EStoveOverlayMode_Expanded 는 베트남 과몰입 방지 고지(IStoveVietnamOverimmersionInfo)에서만 사용되는 값이에요.
• OverlayMode 프로퍼티는 int 타입이므로 이 열거형 값과 비교할 때는 (int)EStoveOverlayMode.k_... 로 형변환해요.
• 이전 형상에서는 값 이름에 밑줄이 없었어요(k_EStoveOverlayModeInvalid). 현재 소스는 k_EStoveOverlayMode_Invalid 처럼 열거형 이름과 값 이름 사이에 밑줄이 들어가요.

Changelog

See Also

• IStoveVietnamAgeRatingInfo
• IStoveVietnamOverimmersionInfo

EStovePCBangMethodCode

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

Description

IStoveResult 를 만든 PC방 기능의 API 가 무엇인지 식별하는 값이에요. IStoveResult.MethodCode 로 조회할 수 있으며, 로그 기록이나 오류 처리 분기에 사용해요.

이 열거형이 쓰는 정수 범위는 3000 ~ 3999 이며, 공개 API 순서대로 순차 부여돼요.

Declaration

public 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
}

Enum Values

Example

using static Stove.PCSDK.V3.PCBang;

void OnRefreshPCBangBenefitCallback(IStoveCallbackResult callbackResult, IStovePCBangBenefitInfo benefitInfo)
{
    uint methodCode = callbackResult.Result.MethodCode; // k_EStovePCBangMethodCode_RefreshBenefit
}

Notes

• k_EStovePCBangMethodCode_Login 과 k_EStovePCBangMethodCode_RefreshBenefit 은 모두 Stove_PCBangLogin 한 번의 호출에서 나오지만, 서로 다른 콜백(onUserLogin / onRefreshBenefit)에 대응하는 별도 코드예요. onRefreshBenefit 은 4분 주기로 반복 호출되며, 유료·무료 상태 모두에서 호출돼요.
• 이전 인터페이스의 CheckUserStatus API 는 Stove_PCBangCheckStatus 로 이름이 바뀌었어요.
• 이 열거형에는 결과 코드가 없어요. 실패 원인은 IStoveResult.ResultCode 로 확인하며, 값은 모듈별 EStoveResultCode 또는 공통 EStoveCommonResultCode 에 정의되어 있어요. PC방 기능 전용 결과 코드 열거형은 없어요.

See Also

• Stove_PCBangLogin
• Stove_PCBangLogout
• Stove_PCBangCheckStatus

EStovePCBangPremium

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

Description

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

이 열거형에는 별도의 성공/실패 판정용 코드가 없어요. k_EStovePCBangPremium_Error 는 서버 오류·판단 불가 상태를 나타내는 값이며, 호출 자체의 성공 여부는 IStoveCallbackResult.Result.IsSuccessful 로 별도 확인해요.

Declaration

public enum EStovePCBangPremium
{
    k_EStovePCBangPremium_Error = -1,
    k_EStovePCBangPremium_Premium = 1,
    k_EStovePCBangPremium_Free = 2,
    k_EStovePCBangPremium_FreeOther = 3,
    k_EStovePCBangPremium_Max = 0x7fffffff
}

Enum Values

Example

using static Stove.PCSDK.V3.PCBang;

void OnPCBangLoginCallback(IStoveCallbackResult callbackResult, IStovePCBangLoginOutcome loginOutcome)
{
    if (callbackResult.Result.IsSuccessful)
    {
        if (loginOutcome.PremiumCheck == EStovePCBangPremium.k_EStovePCBangPremium_Premium)
        {
            // 프리미엄 혜택 로직을 구현해 주세요.
        }
    }
}

Notes

• 이 값은 IStovePCBangLoginOutcome, IStovePCBangBenefitInfo, IStovePCBangStatus 세 구조체가 공통으로 반환해요.
• 혜택 갱신 콜백(onRefreshBenefit)은 4분 주기로 반복 호출되며, k_EStovePCBangPremium_Premium(유료) 뿐 아니라 k_EStovePCBangPremium_Free(무료) 상태에서도 호출돼요.

See Also

• IStovePCBangLoginOutcome
• IStovePCBangBenefitInfo
• IStovePCBangStatus

EStovePCBangTypeKind

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

Description

PC방 기능의 비동기 콜백으로 전달되는 결과/데이터 구조체 각각의 구체적인 타입을 식별하는 값이에요. C# 인터페이스에서는 콜백이 이미 구체 타입(IStovePCBangLoginOutcome 등)의 구조체로 데이터를 전달하므로, 이 값을 조회하는 별도의 접근자는 제공되지 않아요.

이 열거형이 쓰는 정수 범위는 3000 ~ 3999 예요.

Declaration

public enum EStovePCBangTypeKind
{
    k_EStovePCBangTypeKind_Invalid = -1,
    k_EStovePCBangTypeKind_StovePCBangLoginOutcome = 3000,
    k_EStovePCBangTypeKind_StovePCBangBenefitInfo = 3001,
    k_EStovePCBangTypeKind_StovePCBangStatus = 3002,
    k_EStovePCBangTypeKind_Max = 0x7fffffff
}

Enum Values

Example

// C# 인터페이스는 각 구조체(IStovePCBangLoginOutcome 등)를 직접 생성하지 않고
// SDK 가 콜백으로 돌려주므로, 이 열거형 값을 API 호출에 직접 사용하지 않습니다.

Notes

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

See Also

• IStovePCBangLoginOutcome
• IStovePCBangBenefitInfo
• IStovePCBangStatus

EStoveProductTypeCode

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

Description

IStoveProduct.ProductTypeCode 로 반환되는 값이에요. 상품이 어떤 종류인지를 나타내요.

Declaration

public enum EStoveProductTypeCode
{
    k_EStoveProductTypeCode_None = 0,
    k_EStoveProductTypeCode_IndiePackageGameItem = 1,
    k_EStoveProductTypeCode_InGameItem = 2,
    k_EStoveProductTypeCode_PackageItem = 3,

    k_EStoveProductTypeCode_Max = 0x7fffffff
}

Enum Values

Example

if (product.ProductTypeCode == EStoveProductTypeCode.k_EStoveProductTypeCode_InGameItem)
{
    // 인게임 아이템인 경우의 로직을 구현해 주세요.
}

Notes

• Stove_FetchProducts 로 조회한 각 상품의 종류를 구분할 때 사용해요.

See Also

• Stove_FetchProducts
• IStoveProduct

EStovePurchaseLimitTypeCode

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

Description

IStoveProduct.PurchaseLimitTypeCode 로 반환되는 값이에요. 구매 횟수 제한이 계정 단위인지 캐릭터 단위인지, 또는 제한이 없는지를 나타내요.

Declaration

public enum EStovePurchaseLimitTypeCode
{
    k_EStovePurchaseLimitTypeCode_None = 0,
    k_EStovePurchaseLimitTypeCode_Unlimited = 1,
    k_EStovePurchaseLimitTypeCode_Member = 2,
    k_EStovePurchaseLimitTypeCode_Character = 3,

    k_EStovePurchaseLimitTypeCode_Max = 0x7fffffff
}

Enum Values

Example

if (product.PurchaseLimitTypeCode == EStovePurchaseLimitTypeCode.k_EStovePurchaseLimitTypeCode_Member)
{
    // product.PurchaseLimitCount 로 계정 단위 구매 제한 횟수를 확인하는 로직을 구현해 주세요.
}

Notes

• Member 인 경우 IStoveProduct.MemberQuantity, Character 인 경우 IStoveProduct.GuidQuantity 값과 함께 사용해 남은 구매 가능 횟수를 계산해요.

See Also

• Stove_FetchProducts
• IStoveProduct

EStovePurchaseOperation

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

Description

IStovePurchaseParam.Operation 에 설정하며, Stove_StartPurchase 가 결제 페이지를 어떻게 열고 구매 확정을 누가 처리하는지를 결정해요.

Declaration

public enum EStovePurchaseOperation
{
    k_EStovePurchaseOperation_Default = 0,
    k_EStovePurchaseOperation_WithWebView = 1,
    k_EStovePurchaseOperation_WithWebViewAndConfirmResult = 2,

    k_EStovePurchaseOperation_Max = 0x7fffffff
}

Enum Values

Example

var purchaseParam = new IStovePurchaseParam
{
    Operation = EStovePurchaseOperation.k_EStovePurchaseOperation_WithWebViewAndConfirmResult
};

Notes

• WebView* 관련 필드(위치·크기·표시 모드)는 Operation != Default 일 때만 적용돼요.
• Operation 값에 따라 Stove_StartPurchase 의 콜백 결과(IStoveStartPurchaseOutcome)에서 어떤 필드가 채워지는지가 달라져요.

See Also

• Stove_StartPurchase
• Stove_ConfirmPurchase
• IStoveStartPurchaseOutcome
• EStovePurchaseProgress

EStovePurchaseProgress

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

Description

IStoveStartPurchaseOutcome.PurchaseProgress 로 반환되는 값이에요. Stove_StartPurchase 결과를 받은 뒤, 호출자가 결제창을 직접 열어야 하는지 판단하는 데 사용해요.

Declaration

public enum EStovePurchaseProgress
{
    k_EStovePurchaseProgress_None = 0,
    k_EStovePurchaseProgress_NeedPaymentWindow = 1,
    k_EStovePurchaseProgress_NotNeedPaymentWindow = 2,

    k_EStovePurchaseProgress_Max = 0x7fffffff
}

Enum Values

Example

if (outcome.PurchaseProgress == EStovePurchaseProgress.k_EStovePurchaseProgress_NeedPaymentWindow)
{
    string url = outcome.TempPaymentUrl;
    // url 로 결제창을 열어 주세요.
}

Notes

• k_EStovePurchaseOperation_Default 로 구매를 시작한 경우 일반적으로 NeedPaymentWindow 가 반환돼요.

See Also

• Stove_StartPurchase
• IStoveStartPurchaseOutcome
• EStovePurchaseOperation

EStoveResultCode

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

Description

전역 결과 코드 사전에서, 백의 자리(카테고리)로 대역을 나눈 모듈별 결과 코드예요. IStoveResult.ResultCode 로 조회해요. 3xx 는 Base(언어/GDS/런처/토큰/IPC), 4xx 는 웹뷰/팝업 UI(현재는 EStoveCommonResultCode 60~68 로 흡수되어 이 열거형에는 값이 없어요), 5xx 는 IAP 주문/결제 정보예요(503 만 남아 있어요).

단일 바이너리 구조에서는 모듈별로 결과 코드를 따로 두는 것이 의미가 없어, 여러 모듈에서 같은 의미로 쓰이던 코드를 이 열거형 하나로 통합했어요. 어느 모듈에서 발생한 결과인지는 MethodCode(모듈 블록 = 코드 / 1000)로 구분할 수 있어요. 모듈 공통 결과 코드(0~299)는 EStoveCommonResultCode 를 참조하세요.

이전 형상의 EStoveBaseResultCode(80~89번대)는 삭제되었어요. 같은 의미의 코드는 이 열거형(300번대)으로 옮겨졌어요.

Declaration

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

    k_EStoveResultCode_Max = 0x7fffffff
}

Enum Values

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

4xx — 웹뷰/팝업 UI (예약, 현재 값 없음)

5xx — IAP 주문/결제 정보

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

• 304 k_EStoveResultCode_NeedStoveLauncher — 게임 종료 후 재실행이 필요해요
• 307 k_EStoveResultCode_IpcConnectFailed — 게임 종료 후 재실행이 필요해요
• 308 k_EStoveResultCode_IpcAesKeyNotReceived — 게임 종료 후 재실행이 필요해요
• 309 k_EStoveResultCode_IpcTimeout — 게임 종료 후 재실행이 필요해요

Example

using static Stove.PCSDK.V3.Base;

IStoveResult result = Stove_SetLanguageEx("ko");

if (result.ResultCode == (uint)EStoveResultCode.k_EStoveResultCode_LanguageNotSet)
{
    // 언어 미설정 오류에 대한 로직을 구현해 주세요.
}

Notes

• 모듈별 대역(백의 자리)으로 재배치된 결과 코드예요. 현재 공개된 값은 Base(3xx)와 IAP(503) 뿐이며, 4xx 와 5xx 의 나머지 값은 EStoveCommonResultCode 로 흡수되었어요.
• 이전 형상의 EStoveBaseResultCode(80~89번대, Base 전용)는 삭제되었고, 같은 의미의 코드가 이 열거형의 300번대로 옮겨졌어요. 옛 문서를 참조하던 개발자는 이 열거형으로 이전해야 해요.
• IStoveResult.ResultCode 는 uint 타입이므로 이 열거형 값과 비교할 때는 (uint)EStoveResultCode.k_... 로 형변환해요.

Changelog

See Also

• EStoveCommonResultCode
• IStoveResult

EStoveTermsOperation

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

Description

IStoveFetchTermsAgreementParam.Operation 에 설정하며, 사용자가 아직 약관에 동의하지 않았을 때 Stove_FetchTermsAgreement 가 약관 페이지를 어떻게 노출할지를 결정해요.

Declaration

public enum EStoveTermsOperation
{
    k_EStoveTermsOperation_Default = 0,
    k_EStoveTermsOperation_WithWebView = 1,

    k_EStoveTermsOperation_Max = 0x7fffffff
}

Enum Values

Example

var termsParam = new IStoveFetchTermsAgreementParam
{
    Operation = EStoveTermsOperation.k_EStoveTermsOperation_WithWebView
};

Notes

• WebView* 관련 필드(위치·크기·표시 모드)는 Operation != Default 일 때만 적용돼요.

See Also

• Stove_FetchTermsAgreement
• IStoveFetchTermsAgreementParam
• IStoveTermsAgreementOutcome

EStoveViewMethodCode

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

Description

IStoveResult 를 만든 어느 팝업 API 인지 식별하는 값이에요. IStoveResult.MethodCode 로 조회할 수 있으며, 로그 기록이나 오류 처리 분기에 사용해요.

이 열거형이 쓰는 정수 범위는 1000 ~ 1999 이며, 팝업 API 는 1000대, 팝업 관리·유틸리티 API 는 그 이후 번호를 순차로 사용해요.

Declaration

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

Enum Values

Example

using static Stove.PCSDK.V3.View;

void OnViewPopupCallback(IStoveCallbackResult callbackResult)
{
    uint methodCode = callbackResult.Result.MethodCode; // k_EStoveViewMethodCode_AutoPopup 등
}

Notes

• 이전 인터페이스에 있던 모듈별 결과 코드 열거형 EStoveViewResultCode 는 삭제되었어요. 실패 원인은 IStoveResult.ResultCode 로 확인하며, 값은 모듈별 EStoveResultCode 또는 공통 EStoveCommonResultCode 에 정의되어 있어요.
• 팝업을 모두 닫는 Stove_CloseAllPopups() 는 Base 소속 함수이므로, 이 열거형이 아니라 Base 의 MethodCode 값을 가져요.
• 값 번호는 모듈별 블록으로 나뉘어 있어 다른 모듈의 MethodCode 와 겹치지 않아요. 어느 모듈의 결과인지는 IStoveResult.SDKName 으로도 확인할 수 있어요.
• 같은 팝업이라도 구 인터페이스와 값이 달라요. 구 인터페이스(View_AutoPopup 등)는 81 · 83 · 85 · 87 · 91 · 160 을 그대로 돌려주고, 신규 인터페이스는 이 열거형의 1000 번대 값을 돌려줘요. 두 벌을 함께 쓰는 동안에는 로그 집계 기준을 벌마다 나누어 두세요.

See Also

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

EStoveViewTypeKind

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

Description

팝업 기능이 다루는 파라미터 구조체와 콜백 전달 구조체 각각의 구체적인 타입을 식별하는 값이에요. C# API 는 이 값을 직접 다루지 않고 구조체를 그대로 생성해 전달하지만, 값의 범위와 대응 관계를 알아두면 로깅·디버깅에 참고할 수 있어요.

이 열거형이 쓰는 정수 범위는 1000 ~ 1999 예요. 다른 모듈의 TypeKind 값과 번호가 겹치지 않아요.

Declaration

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

Enum Values

Example

// C# 인터페이스는 각 구조체(IStovePopupParam 등)를 직접 생성해 사용하며,
// 이 열거형 값을 API 호출에 직접 전달하지 않습니다.
var popupParam = new IStovePopupParam
{
    WebViewMode = EStoveWebViewMode.k_EStoveWebViewMode_Internal
};

Notes

• 1500~1503 은 호출자가 만들어 API 에 전달하는 파라미터 구조체, 1504 는 SDK 가 콜백으로 돌려주는 구조체에 대응해요.
• View 팝업 파라미터는 API 마다 사용하는 타입이 달라요. Stove_AutoPopup/Stove_NewsPopup/Stove_CouponPopup 은 IStovePopupParam, Stove_ManualPopup 은 IStoveManualPopupParam, Stove_VerifyIdentificationPopup 은 IStoveVerifyIdentificationPopupParam 을 사용해요.

See Also

• IStoveSetPopupDisallowedParam
• IStovePopupParam
• IStoveManualPopupParam
• IStoveVerifyIdentificationPopupParam

EStoveWebViewMode

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

Description

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

Declaration

public enum EStoveWebViewMode
{
    k_EStoveWebViewMode_Invalid = -1,

    k_EStoveWebViewMode_External = 0,
    k_EStoveWebViewMode_Internal = 1,

    k_EStoveWebViewMode_Max = 0x7fffffff
}

Enum Values

Example

EStoveWebViewMode webViewMode = EStoveWebViewMode.k_EStoveWebViewMode_Internal;

Notes

• 팝업, 결제 기능에서 팝업 표시 방식을 지정할 때 사용하는 값이에요. SDK 자체 API 에는 이 값을 직접 받는 함수가 없어요.
• 이전 형상에서는 값 이름에 밑줄이 없었어요(k_EStoveWebViewModeInvalid). 현재 소스는 k_EStoveWebViewMode_Invalid 처럼 열거형 이름과 값 이름 사이에 밑줄이 들어가요.

Changelog

See Also

• 없음

IStoveAccessToken

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

Description

Stove_AccessTokenRenewed() 를 등록했을 때 전달되는 콜백의 토큰 구조체예요.

AccessToken 값과 남은 유효시간을 담아요. readonly struct(값 타입)이므로 GC 가 처리하며 별도로 해제할 필요가 없어요.

Declaration

public readonly struct IStoveAccessToken
{
    public string AccessToken { get; }
    public int ExpireIn { get; }
}

Members

Example

using static Stove.PCSDK.V3.Base;

void OnAccessTokenRenewedCallback(IStoveCallbackResult callbackResult, IStoveAccessToken token)
{
    if (callbackResult.Result.IsSuccessful)
    {
        string accessToken = token.AccessToken;
        int expireIn = token.ExpireIn;
        // 성공 시 로직을 구현해 주세요.
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Stove_AccessTokenRenewed(OnAccessTokenRenewedCallback);

Notes

• Stove_AccessTokenRenewed() 를 등록한 뒤, AccessToken 이 SDK 내부에서 자동으로 갱신될 때마다 이 콜백이 호출돼요.
• 이전 형상에서는 이 타입의 이름이 IStoveToken 이었어요. 현재 소스(BaseTypesV2.cs)에는 IStoveToken 이 존재하지 않고 IStoveAccessToken 으로만 정의되어 있어요.

See Also

• Stove_AccessTokenRenewed
• Stove_GetAccessToken
• IStoveCallbackResult

IStoveCallbackResult

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

Description

비동기 콜백에 전달되는 결과예요. IStoveResult 를 감싸고, 오류 상세 메시지와 외부 오류 값을 함께 담아요.

Stove_AccessTokenRenewed(), Stove_OverImmersionNotification() 등 콜백 기반 비동기 API 의 첫 번째 콜백 인자로 전달돼요. readonly struct(값 타입)이므로 GC 가 처리하며 별도로 해제할 필요가 없어요.

Result 와 함께 전달되는 값들은 콜백 호출 시점에만 유효해요.

Declaration

public readonly struct IStoveCallbackResult
{
    public IStoveResult Result { get; }
    public string ErrorMessage { get; }
    public int ExternalError { get; }
}

Members

Example

using static Stove.PCSDK.V3.Base;

void OnAccessTokenRenewedCallback(IStoveCallbackResult callbackResult, IStoveAccessToken token)
{
    if (callbackResult.Result.IsSuccessful)
    {
        // 성공 시 로직을 구현해 주세요.
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Stove_AccessTokenRenewed(OnAccessTokenRenewedCallback);

Notes

• 모든 SDK 비동기 콜백(OnAccessTokenRenewedCallback, OnOverImmersionNotificationCallback 등)의 첫 번째 인자로 전달돼요.
• 콜백은 Stove_RunCallback() 을 호출한 스레드에서 실행돼요.
• 신규 flat C 인터페이스의 IStoveCallbackResult 에는 호출 시 전달한 userData(void*) 를 돌려주는 필드가 있지만, C# 버전에는 대응하는 필드가 없어요. C# 콜백은 delegate 가 클로저로 컨텍스트를 캡처하므로 별도의 userData 포인터가 필요하지 않아요.
• WithManagedExceptionMsgAndCode() 는 C# 래퍼가 콜백 마샬링 등에서 발생한 예외를 MANAGED_EXCEPTION(254) 결과로 변환할 때 쓰는 내부 보조 메서드예요. 게임 코드가 직접 호출할 일은 거의 없어요.

See Also

• Stove_RunCallback
• IStoveResult

IStoveChargeInfo

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

Description

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

SDK 가 값을 채워서 콜백으로 전달하는 읽기 전용 구조체(readonly struct)이에요. 호출자가 직접 만들지 않아요. 값 타입이므로 콜백이 끝난 뒤에도 값을 그대로 복사해 보관해 사용할 수 있으며, 별도로 해제할 필요가 없어요.

Declaration

public readonly struct IStoveChargeInfo
{
    public double ChargeDeductVal { get; }
    public double ChargeDisplayDeductVal { get; }
    public int ChargeType { get; }
    public string ChargeTypeName { get; }
}

Members

Example

using static Stove.PCSDK.V3.IAP;

void OnConfirmPurchaseCallback(IStoveCallbackResult callbackResult, IStoveConfirmPurchaseOutcome outcome)
{
    if (callbackResult.Result.IsSuccessful && outcome.IsConfirmed)
    {
        foreach (var chargeInfo in outcome.ChargeInfos)
        {
            double deductVal = chargeInfo.ChargeDeductVal;
            string typeName = chargeInfo.ChargeTypeName;

            // 필요한 값만 사용해 영수증 화면을 구성해 주세요.
        }
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Notes

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

See Also

• Stove_ConfirmPurchase
• IStoveConfirmPurchaseOutcome
• IStoveStartPurchaseOutcome
• IStovePurchasedProduct

IStoveConfirmPurchaseOutcome

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

Description

Stove_ConfirmPurchase 호출 결과로 OnConfirmPurchaseCallback 콜백에 전달돼요.

SDK 가 값을 채워서 콜백으로 전달하는 읽기 전용 구조체(readonly struct)이에요. 호출자가 직접 만들지 않아요. 값 타입이므로 콜백이 끝난 뒤에도 값을 그대로 복사해 보관해 사용할 수 있으며, 별도로 해제할 필요가 없어요.

Declaration

public readonly struct IStoveConfirmPurchaseOutcome
{
    public bool IsConfirmed { get; }
    public IStovePurchasedProduct[] PurchasedProducts { get; }
    public IStoveChargeInfo[] ChargeInfos { get; }
}

Members

Example

using static Stove.PCSDK.V3.IAP;

void OnConfirmPurchaseCallback(IStoveCallbackResult callbackResult, IStoveConfirmPurchaseOutcome outcome)
{
    if (callbackResult.Result.IsSuccessful && outcome.IsConfirmed)
    {
        foreach (var product in outcome.PurchasedProducts)
        {
            // 구매된 상품을 지급해 주세요.
        }
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Notes

• Stove_ConfirmPurchase 의 출력으로만 전달돼요.
• IsConfirmed 가 false 이면 PurchasedProducts / ChargeInfos 가 비어 있을 수 있어요.

See Also

• Stove_ConfirmPurchase
• Stove_StartPurchase
• IStoveStartPurchaseOutcome

IStoveConfirmPurchaseParam

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

Description

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

일반 C# 구조체(struct)이며 생성 함수를 쓰지 않아요. 게임 코드가 new IStoveConfirmPurchaseParam { ... } 형태로 직접 만들어 값을 채운 뒤 호출에 전달해요. 값 타입이므로 별도로 해제할 필요가 없어요.

Declaration

public struct IStoveConfirmPurchaseParam
{
    public long TxnMasterNo { get; set; }
}

Members

Example

using static Stove.PCSDK.V3.IAP;

var confirmParam = new IStoveConfirmPurchaseParam
{
    TxnMasterNo = txnMasterNo
};

Stove_ConfirmPurchase(confirmParam, OnConfirmPurchaseCallback);

Notes

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

See Also

• Stove_ConfirmPurchase
• Stove_StartPurchase
• IStoveStartPurchaseOutcome

IStoveFetchProductsParam

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

Description

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

일반 C# 구조체(struct)이며 생성 함수를 쓰지 않아요. 게임 코드가 new IStoveFetchProductsParam { ... } 형태로 직접 만들어 값을 채운 뒤 호출에 전달해요. 값 타입이므로 별도로 해제할 필요가 없어요.

Declaration

public struct IStoveFetchProductsParam
{
    public string CategoryId { get; set; }
    public uint PageIndex { get; set; }
    public uint PageSize { get; set; }
}

Members

Example

using static Stove.PCSDK.V3.IAP;

var fetchProductsParam = new IStoveFetchProductsParam
{
    CategoryId = "",
    PageIndex = 1,
    PageSize = 20
};

Stove_FetchProducts(fetchProductsParam, OnFetchProductsCallback);

Notes

• CategoryId 는 IStoveShopCategory.CategoryId 에서 얻은 값을 전달해요.

See Also

• Stove_FetchProducts
• IStoveShopCategory
• IStoveProduct

IStoveFetchTermsAgreementParam

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

Description

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

일반 C# 구조체(struct)이며 생성 함수를 쓰지 않아요. 게임 코드가 new IStoveFetchTermsAgreementParam { ... } 형태로 직접 만들어 값을 채운 뒤 호출에 전달해요. 값 타입이므로 별도로 해제할 필요가 없어요.

Declaration

public struct IStoveFetchTermsAgreementParam
{
    public EStoveTermsOperation Operation { get; set; }
    public EStoveWebViewMode WebViewMode { get; set; }
    public int WebViewPosX { get; set; }
    public int WebViewPosY { get; set; }
    public int WebViewWidth { get; set; }
    public int WebViewHeight { get; set; }
}

Members

Example

using static Stove.PCSDK.V3.IAP;

var termsParam = new IStoveFetchTermsAgreementParam
{
    Operation = EStoveTermsOperation.k_EStoveTermsOperation_WithWebView
};

Stove_FetchTermsAgreement(termsParam, OnFetchTermsAgreementCallback, null);

Notes

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

See Also

• Stove_FetchTermsAgreement
• IStoveTermsAgreementOutcome
• EStoveTermsOperation

IStoveGds

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

Description

Stove_GetGds() 호출 시 ref 파라미터로 전달받는 국가/규제/시간대/언어 정보 구조체예요.

로그인한 사용자의 IP 기반 국가 코드를 기본으로 제공하며, IP 로 국가를 판별할 수 없을 때는 기본 국가 코드로 대체돼요(IsDefault 로 구분). readonly struct(값 타입)이므로 GC 가 처리하며 별도로 해제할 필요가 없어요.

Declaration

public readonly struct IStoveGds
{
    public bool IsDefault { get; }
    public string Nation { get; }
    public string Regulation { get; }
    public string Timezone { get; }
    public int UtcOffset { get; }
    public string Lang { get; }
}

Members

Example

using static Stove.PCSDK.V3.Base;

IStoveGds gds = default;
IStoveResult result = Stove_GetGds(ref gds);

if (result.IsSuccessful)
{
    string nation = gds.Nation;
    string timezone = gds.Timezone;
    // 성공 시 로직을 구현해 주세요.
}
else
{
    // 실패 시 로직을 구현해 주세요.
}

Notes

• Stove_Initialize() 로 초기화가 끝난 뒤 호출해야 유효한 값을 받을 수 있어요.
• Stove_GetGds(ref IStoveGds gds) 는 ref 파라미터로 값을 돌려주며, 반환값은 IStoveResult 이에요.

See Also

• Stove_GetGds
• IStoveUser
• IStoveSignin

IStoveInitializeParam

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

Description

Stove_Initialize(IStoveInitializeParam) 오버로드 호출에 사용하는 파라미터예요. ShopKey, MainWndHandle 두 필드만 가지며, 단일 바이너리 통합 이후 SDK 초기화와 동시에 View/IAP 모듈을 함께 초기화하기 위해 존재해요.

일반 struct(값 타입)이며 각 필드가 get/set 프로퍼티로 노출돼요. 신규 flat C 인터페이스와 달리 게임 코드가 생성 함수 없이 new IStoveInitializeParam { ... } 형태로 직접 만들어 값을 채워요.

MainWndHandle 이 0 이 아니면 View 모듈이 초기화되고, ShopKey 가 비어 있지 않으면서 동시에 MainWndHandle 도 0 이 아니면 IAP 모듈이 함께 초기화돼요(둘 다 만족해야 IAP 가 초기화돼요). MainWndHandle 은 게임의 메인 윈도우가 실제로 생성된 뒤에만 유효한 값이에요.

Declaration

public struct IStoveInitializeParam
{
    public string ShopKey { get; set; }
    public IntPtr MainWndHandle { get; set; }
}

Members

Example

using static Stove.PCSDK.V3.Base;

IStoveInitializeParam initParam = new IStoveInitializeParam
{
    ShopKey = "YOUR_SHOP_KEY",
    MainWndHandle = hWnd,
};

IStoveResult result = Stove_Initialize(initParam);

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

Notes

• 이전 형상에서는 Environment / GameId / AppKey 필드가 이 구조체에 포함되어 있었어요. 현재 소스(BaseTypesV2.cs)에서는 이 세 필드가 빠지고 IStoveRestartAppIfNecessaryParam 으로 옮겨졌어요. SDK 는 Stove_RestartAppIfNecessary() 에서 캐시한 값을 Stove_Initialize() 에서 재사용해요.
• 파라미터 없는 Stove_Initialize() 오버로드는 SDK 만 초기화하며 View/IAP 는 초기화하지 않아요.
• 신규 flat C 인터페이스는 Stove_CreateParam(k_EStoveBaseTypeKind_InitializeParam) 으로 생성한 뒤 Destroy() 로 해제해야 하지만, C# 에서는 이 구조체를 값 타입으로 직접 생성·초기화하며 생성/해제 함수를 호출하지 않아요.

See Also

• Stove_Initialize
• Stove_RestartAppIfNecessary
• IStoveRestartAppIfNecessaryParam

IStoveInventoryItem

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

Description

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

SDK 가 값을 채워서 콜백으로 전달하는 읽기 전용 구조체(readonly struct)이에요. 호출자가 직접 만들지 않아요. 값 타입이므로 콜백이 끝난 뒤에도 값을 그대로 복사해 보관해 사용할 수 있으며, 별도로 해제할 필요가 없어요.

Declaration

public readonly struct IStoveInventoryItem
{
    public long TxnMasterNo { get; }
    public long TxnDetailNo { get; }
    public long ProductId { get; }
    public string InserviceItemId { get; }
    public string ProductName { get; }
    public int Quantity { get; }
    public string ThumbnailUrl { get; }
}

Members

Example

using static Stove.PCSDK.V3.IAP;

void OnFetchInventoryCallback(IStoveCallbackResult callbackResult, IStoveInventoryList list)
{
    if (callbackResult.Result.IsSuccessful)
    {
        foreach (var item in list)
        {
            long productId = item.ProductId;
            int quantity = item.Quantity;

            // 필요한 값만 사용해 화면을 구성해 주세요.
        }
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Notes

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

See Also

• Stove_FetchInventory
• IStoveInventoryList
• IStoveProduct

IStoveInventoryList

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

Description

Stove_FetchInventory 호출 결과로 OnFetchInventoryCallback 콜백에 전달되는 IStoveInventoryItem 목록 래퍼예요. IReadOnlyList<IStoveInventoryItem> 를 구현하여 foreach 로 순회할 수 있어요.

SDK 가 소유한 읽기 전용 구조체(readonly struct)이며, 콜백이 실행되는 동안에만 유효해요. 호출자가 직접 만들지 않아요. 콜백 밖에서 보관하려면 항목 값을 복사해 두어야 해요.

readonly struct(값 타입)이므로 GC 가 처리하며 별도로 해제할 필요가 없어요.

Declaration

public readonly struct IStoveInventoryList : IReadOnlyList<IStoveInventoryItem>
{
    // 멤버는 아래 멤버 표를 참고하십시오.
}

Members

Example

using static Stove.PCSDK.V3.IAP;

void OnFetchInventoryCallback(IStoveCallbackResult callbackResult, IStoveInventoryList list)
{
    if (callbackResult.Result.IsSuccessful)
    {
        foreach (var item in list)
        {
            long productId = item.ProductId;
            // 필요한 값만 사용해 화면을 구성해 주세요.
        }
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Notes

• Stove_FetchInventory 의 출력으로만 전달돼요.
• 콜백이 끝나면 무효처리되므로, 콜백 밖에서 계속 사용할 값은 미리 복사해 두어야 해요.
• 박싱 없는 열거자(StoveReadOnlyArrayEnumerator<T>)를 사용해 foreach 사용 시에도 힙 할당이 발생하지 않아요.

See Also

• Stove_FetchInventory
• IStoveInventoryItem

IStoveManualPopupParam

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

Description

Stove_ManualPopup 호출 시 넘기는 파라미터예요. 웹뷰 표시 모드와, 표시할 팝업 콘텐츠를 고르는 리소스 키를 지정해요.

호출자가 만들어 API 에 값으로 전달해요. 별도로 해제할 필요가 없어요(값 타입).

Declaration

public struct IStoveManualPopupParam
{
    public EStoveWebViewMode WebViewMode { get; set; }
    public string ResourceKey { get; set; }
}

Members

Example

using static Stove.PCSDK.V3.View;

void OnViewPopupCallback(IStoveCallbackResult callbackResult)
{
    if (callbackResult.Result.IsSuccessful)
    {
        // 성공 시 로직을 구현해 주세요.
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

void OnViewPopupDestroyCallback(IStoveCallbackResult callbackResult)
{
    // 팝업의 네이티브 리소스가 해제되었을 때 호출됩니다.
}

var manualPopupParam = new IStoveManualPopupParam
{
    WebViewMode = EStoveWebViewMode.k_EStoveWebViewMode_Internal,
    ResourceKey = "YOUR_RESOURCE_KEY"
};
Stove_ManualPopup(manualPopupParam, OnViewPopupCallback, OnViewPopupDestroyCallback);

Notes

• Auto/News/Coupon 팝업은 이 타입이 아니라 IStovePopupParam 을 사용해요(ResourceKey 없음).

See Also

• Stove_ManualPopup
• IStovePopupParam

IStoveOrderProductParam

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

Description

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

일반 C# 구조체(struct)이며 생성 함수를 쓰지 않아요. 게임 코드가 new IStoveOrderProductParam { ... } 형태로 직접 만들어 값을 채운 뒤 사용해요. 값 타입이므로 별도로 해제할 필요가 없어요.

Declaration

public struct IStoveOrderProductParam
{
    public long ProductId { get; set; }
    public double SalePrice { get; set; }
    public int Quantity { get; set; }
}

Members

Example

using static Stove.PCSDK.V3.IAP;

var orderProduct = new IStoveOrderProductParam
{
    ProductId = productId,
    SalePrice = salePrice,
    Quantity = 1
};

var startPurchaseParam = new IStoveStartPurchaseParam
{
    Products = new[] { orderProduct },
    // PurchaseParam 등 나머지 필드는 IStoveStartPurchaseParam 문서를 참고해 채워 주세요.
};

Stove_StartPurchase(startPurchaseParam, OnStartPurchaseCallback, null);

Notes

• SalePrice 는 IStoveProduct 의 SalePrice 값을 그대로 사용해 주세요. 값이 다르면 서버에서 가격 불일치로 처리될 수 있어요.

See Also

• Stove_StartPurchase
• IStoveStartPurchaseParam
• IStoveProduct

IStoveOverImmersionInfo

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

Description

Stove_OverImmersionNotification() 콜백으로 전달되는 과몰입 방지 알림 구조체예요. 한국 전용 API 예요.

경고 메시지와 게임 누적 이용 시간, 메시지 노출 시간을 담아요. readonly struct(값 타입)이므로 GC 가 처리하며 별도로 해제할 필요가 없어요.

Declaration

public readonly struct IStoveOverImmersionInfo
{
    public string Msg { get; }
    public int ElapsedHours { get; }
    public int ExposureTime { get; }
}

Members

Example

using static Stove.PCSDK.V3.Base;

void OnOverImmersionNotificationCallback(IStoveCallbackResult callbackResult, IStoveOverImmersionInfo overImmersion)
{
    if (callbackResult.Result.IsSuccessful)
    {
        string msg = overImmersion.Msg;
        int exposureTime = overImmersion.ExposureTime;
        // 성공 시 로직을 구현해 주세요. (msg 를 exposureTime 초 동안 노출)
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Stove_OverImmersionNotification(OnOverImmersionNotificationCallback);

Notes

• 한국 전용 API 이며, 렌더링이 가능한 시점 이후에 호출해야 해요.
• ElapsedHours 단위는 시간(hour)이에요. 분 단위인 IStoveVietnamOverimmersionInfo.ElapsedMinutes 와 혼동하지 않도록 주의해요.
• 이전 형상에서는 이 타입의 이름이 IStoveOverImmersion 이었고 시간 필드 이름도 ElapsedTime 이었어요. 현재 소스(BaseTypesV2.cs)는 타입명 IStoveOverImmersionInfo, 필드명 ElapsedHours 로 바뀌었어요.

See Also

• Stove_OverImmersionNotification
• IStoveShutdownInfo
• IStoveVietnamOverimmersionInfo

IStovePCBangBenefitInfo

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

Description

Stove_PCBangLogin 의 로그인이 성공한 뒤, onRefreshBenefit 콜백에 주기적으로 전달되는 갱신된 혜택 정보예요.

SDK 가 생성해 콜백으로 전달하는 값이에요. 호출자가 직접 만들지 않아요. 매니지드 값이므로 콜백이 끝난 뒤에도 그대로 보관해 사용할 수 있어요.

4분 주기로 반복 호출돼요. 1회성 콜백이 아니므로, 등록 이후 매 4분마다 실행될 것을 감안해 콜백을 구현해야 해요.

Declaration

public readonly struct IStovePCBangBenefitInfo
{
    public EStovePCBangPremium PremiumCheck { get; }
    public int RemainTime { get; }
}

Members

Example

using static Stove.PCSDK.V3.PCBang;

void OnPCBangLoginCallback(IStoveCallbackResult callbackResult, IStovePCBangLoginOutcome loginOutcome)
{
    // 최초 로그인 완료 시 1회 호출됩니다.
}

void OnRefreshPCBangBenefitCallback(IStoveCallbackResult callbackResult, IStovePCBangBenefitInfo benefitInfo)
{
    if (callbackResult.Result.IsSuccessful)
    {
        // 성공 시 로직을 구현해 주세요.
        int remainTime = benefitInfo.RemainTime;
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

Stove_PCBangLogin(OnPCBangLoginCallback, OnRefreshPCBangBenefitCallback);

Notes

• 옛(v1) 이름은 StovePCRefreshUserBenefits 이에요.
• 이 콜백은 4분 주기로 반복 호출되며, 유료(Premium)·무료(Free) 상태 모두에서 호출돼요. 프리미엄 상태일 때만 호출되는 것이 아니에요.
• Stove_PCBangLogout 을 호출하면 이 콜백의 반복 등록이 해제돼요.

See Also

• IStovePCBangLoginOutcome
• EStovePCBangPremium
• Stove_PCBangLogin
• Stove_PCBangLogout

IStovePCBangLoginOutcome

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

Description

Stove_PCBangLogin 의 최초 로그인이 완료되었을 때 onUserLogin 콜백에 전달되는 값이에요.

SDK 가 생성해 콜백으로 전달하는 값이에요. 호출자가 직접 만들지 않아요.

readonly struct(값 타입)이므로 GC 가 처리하며 별도로 해제할 필요가 없어요. 콜백이 끝난 뒤에도 값을 그대로 보관해 사용할 수 있어요.

Declaration

public readonly struct IStovePCBangLoginOutcome
{
    public EStovePCBangPremium PremiumCheck { get; }
    public int Psn { get; }
    public int RemainTime { get; }
}

Members

Example

using static Stove.PCSDK.V3.PCBang;

void OnPCBangLoginCallback(IStoveCallbackResult callbackResult, IStovePCBangLoginOutcome loginOutcome)
{
    if (callbackResult.Result.IsSuccessful)
    {
        // 성공 시 로직을 구현해 주세요.
        int remainTime = loginOutcome.RemainTime;
    }
    else
    {
        // 실패 시 로직을 구현해 주세요.
    }
}

void OnRefreshPCBangBenefitCallback(IStoveCallbackResult callbackResult, IStovePCBangBenefitInfo benefitInfo)
{
    // 4분 주기로 반복 호출됩니다.
}

Stove_PCBangLogin(OnPCBangLoginCallback, OnRefreshPCBangBenefitCallback);

Notes

• 옛(v1) 이름은 StovePCBangUserLogin 이에요.
• 최초 로그인 이후에는 이 값이 아니라 IStovePCBangBenefitInfo 가 4분 주기로 갱신되어 전달돼요.

See Also

• IStovePCBangBenefitInfo
• EStovePCBangPremium
• Stove_PCBangLogin

IStovePCBangStatus

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

Description

Stove_PCBangCheckStatus 호출 결과로 전달되는, 현재 PC방 상황과 사용자가 이용 가능한 상품(entitlement) 정보예요.

SDK 가 생성해 콜백으로 전달하는 값이에요. 호출자가 직접 만들지 않아요.

readonly struct(값 타입)이므로 GC 가 처리하며 별도로 해제할 필요가 없어요. 콜백이 끝난 뒤에도 값을 그대로 보관해 사용할 수 있어요.

Declaration

public readonly struct IStovePCBangStatus
{
    public EStovePCBangPremium PremiumCheck { get; }
    public int Psn { get; }
    public int ProductCode { get; }
}