Skip to content
스토브
마지막 업데이트

게임 정보

Mobile

이해하기


SDK 모듈 버전 정보란?

현재 게임 앱(빌드)에 적용된 SDK 모듈의 버전 정보를 조회하는 기능이에요.
Base, Auth, View, Push 등 각 SDK 모듈의 버전 정보를 JSON 형태로 받을 수 있어요.
주로 디버깅, QA, 버전 불일치 확인 등 개발·운영 과정에서 활용돼요.

반환 모듈 정보 예시

반환 형태는 아래와 같이 각 모듈명과 버전 문자열로 구성된 JSON이에요.

모듈명 설명
Base 스토브 SDK Base 모듈 버전.
Log 로그 모듈 버전.
Auth 인증 모듈 버전.
AuthUI 인증 UI 모듈 버전.
IAP 인앱 결제 모듈 버전.
IAPGoogle Google 인앱 결제 모듈 버전.
Push 푸시 모듈 버전.
View View(팝업) 모듈 버전.
AuthFacebook Facebook 인증 모듈 버전.
AuthGoogle Google 인증 모듈 버전.
AuthTwitter Twitter 인증 모듈 버전.

개발하기


SDK 버전 정보 얻기

Log.getSDKVersions API로 현재 게임 앱에 적용된 SDK 모듈 버전 정보를 조회할 수 있어요. 반환 값은 모듈명 → 버전 문자열의 JSON 형태예요.

호출 시점 — SDK 초기화 이후
Log.getSDKVersions는 SDK가 initialize 단계에서 로컬 저장소(SharedPreferences/UserDefaults)에 캐시해 둔 모듈 버전 정보를 동기로 읽어 반환해요. 콜백·에러 코드 없이 즉시 반환되며, 초기화 전에 호출하면 빈 객체({})를 받게 되니 반드시 initialize 완료 콜백 이후에 호출하세요. 결과가 비어 있다면 호출 시점이 초기화 전이거나 SDK 의존성이 누락된 상태이므로, initialize 시점 점검과 모듈 의존성(build.gradle / Podfile / 패키지 설정)을 다시 확인하세요.


csharp
public void GetVersions()
{
    Dictionary<string, object> version = Log.GetSDKVersions();
}

모듈 정보 응답 예시

json
{
    "Base": "2.4.0",
    "Log": "2.4.0",
    "Auth": "2.4.2",
    "AuthUI": "2.4.2",
    "IAP": "2.4.0",
    "IAPGoogle": "2.4.0",
    "Push": "2.4.0",
    "View": "2.4.0",
    "AuthFacebook": "2.4.0",
    "AuthGoogle": "2.4.0",
    "AuthTwitter": "2.4.0"
}

자주 묻는 질문



Q1. SDK 버전 정보는 언제 호출할 수 있나요?
A. 별도의 초기화 완료 조건 없이 SDK가 게임 앱에 적용된 상태라면 어느 시점에서든 호출할 수 있어요.
Q2. 반환되는 모듈 목록은 항상 동일한가요?
A. 게임 앱에 실제로 적용된 SDK 모듈 기준으로 반환돼요.
적용되지 않은 모듈(예: AuthFacebook을 사용하지 않는 경우)은 목록에 포함되지 않을 수 있어요.
Q3. 인게임 설정 화면에 SDK 버전 정보를 노출하려면 어떻게 하나요?
A. Log.getSDKVersions()로 반환된 JSON 오브젝트에서 원하는 모듈명을 키로 버전 문자열을 조회한 후, 게임 내 설정 UI에 직접 바인딩하면 돼요.
예를 들어 Base 키로 조회하면 SDK Base 모듈의 버전 문자열을 얻을 수 있어요.

PC

이해하기


PC SDK 버전 정보란?

현재 게임 앱(빌드)에 적용된 PC SDK의 버전 문자열을 조회하는 기능이에요.
주로 디버깅, QA, 버전 불일치 확인 등 개발·운영 과정에서 활용돼요.

모바일은 모듈별 버전을 JSON 형태로 반환하는 것과 달리, PC는 단일 버전 문자열을 반환해요.

개발하기


PC SDK 버전 정보 얻기

BaseSDK의 버전 조회 API(Base_GetVersion)로 현재 연동된 PC SDK 버전 문자열을 조회할 수 있어요. 호출자가 전달한 버퍼(문자열)에 버전 문자열을 채워 동기로 즉시 반환해요.

동기 API 이며 콜백 없이 즉시 반환돼요. BaseSDK 초기화(Base_Initialize) 이후에 호출하세요.


cpp
#include "BaseSDK.h"

using namespace Stove::PCSDK;
using namespace Stove::PCSDK::Base;

// 버전 문자열을 받을 버퍼 준비
wchar_t buffer[1024] = { 0, };

// Base_GetVersion 호출 (동기)
auto result = Base_GetVersion(buffer, 1024);
if (result.IsSuccessful())
{
    // 성공: buffer 에 PC SDK 버전 문자열이 채워져요.
}
else
{
    // 실패 시 로직을 구현해 주세요.
}

자주 묻는 질문



Q1. PC SDK 버전도 모바일처럼 모듈별로 반환되나요?
A. 아니요. PC SDK는 BaseSDK 기준 단일 버전 문자열을 반환해요. 모듈별 JSON을 반환하는 모바일 Log.getSDKVersions와 다른 점이에요.
Q2. PC SDK 버전 조회는 언제 호출할 수 있나요?
A. BaseSDK 초기화(Base_Initialize)가 완료된 이후에 호출하세요. 동기 API라 콜백 없이 즉시 결과를 반환해요.



직접 문의하고 싶으신가요? stove.developers@smilegate.com