실제 적용 흐름이 궁금하신가요?

이용 시나리오 / 점검·업데이트 확인하기

점검/업데이트

이해하기

스토브 SDK가 제공하는 점검/업데이트 기능을 이용하면 게임서버 점검을 설정·해제하거나 게임 버전을 관리하여 업데이트를 제어할 수 있어요.
스토브 SDK는 이용자의 앱(클라이언트) 안에서 동작해요. 앱을 켤 때 점검 중이거나 새 업데이트가 나왔다면 이용자에게 안내 팝업을 보여줘요.
다만, 스토브 기능 이외에 게임서버에서 직접 관리해야 하는 부분이 포함되어 있어 함께 구현이 필요해요.

기능 제공 주체

점검/업데이트 기능은 스토브(SDK)와 게임(CP사)이 역할을 나누어 제공해요.

모바일 플랫폼 점검 시 주의사항

• 모바일 플랫폼의 특성상 점검 시 이용자에게는 다양한 예외 상황이 발생할 수 있어요.
  • 점검 설정·이용자 Kick 시 서버와의 통신이 없는 구간에 위치하는 경우 (예: 로비화면, 싱글 플레이 진행 중)
  • 점검 시작 전 앱을 백그라운드에 내려놓았던 경우 — 점검 시작 전 앱 백그라운드 → 점검 중 앱 포그라운드 접속 등의 상황이 발생할 수 있어요.
  • 물리적으로 네트워크가 끊기는 구간에 위치하는 경우 (예: 비행모드, 지하철)

• 서버 기반의 점검·업데이트 기능이 없거나 처리가 되어 있지 않으면 아래와 같은 문제가 발생할 수 있어요.
  • 이용자 Kick이 되지 않은 일부 이용자가 점검 중 게임에 접근/Play 하는 문제 발생
  • 앱 실행 시에만 리소스 업데이트를 체크하여 일부 이용자들이 리소스 업데이트를 받지 못하는 상황

• 위와 같은 문제를 방지하기 위해 게임서버에서는 다음 항목을 반드시 구현해야 해요.
  • 게임서버 점검 설정 (진입 차단)
  • 서버 기반의 이용자 Kick 구현
  • 앱 업데이트 버전 / 업데이트 옵션
  • 리소스 업데이트 버전 / 업데이트 옵션

연동 가이드

사전 준비

기본 연동 구조

스토브 SDK 초기화(initialize) 시 점검·업데이트 여부를 확인해 상황에 맞는 안내 팝업을 자동으로 노출해요. 스토브가 제공하는 팝업은 이용자 안내용 단순 팝업이며, 게임 내 점검 안내·이용자 Kick·입력 차단과 서버 레벨 점검은 게임에서 별도로 구현해야 해요.

점검·업데이트 흐름

이용자가 게임에 진입할 때 스토브 SDK와 게임서버가 순서대로 점검·업데이트를 판단하는 전체 순서예요.

앞 단계(①～⑤)는 스토브 SDK가 플랫폼 차원에서, 뒤 단계(⑥～⑨)는 게임서버가 게임 차원에서 처리해요.

전체 흐름에서 점검 또는 업데이트가 실제로 발생했을 때, 각 상황을 어떻게 처리하는지 나눠 정리했어요.

앱(클라이언트)·리소스(CDN) 업데이트가 존재하는 경우의 흐름이에요. 업데이트 점검 시 Kick 처리가 되지 않은 이용자가 게임에 접근하거나, 점검 없이 앱·리소스 업데이트만 적용하는 상황에 해당해요.

개발하기

SDK 연동

SDK 초기화(initialize) 결과로 점검 또는 앱 업데이트 상태가 감지되면, OperationUI.handleResult를 호출해 SDK가 제공하는 안내 UI를 노출하고 이후 게임 흐름을 제어해요.

사전 준비

• AuthUI 모듈 의존성: OperationUI는 AuthUI 모듈에 포함돼요. 프로젝트(Android build.gradle, iOS Podfile/SPM, Unity/Unreal 패키지)에 AuthUI 의존성이 추가돼 있는지 확인하세요.
• 파트너스 설정 완료: 파트너스에서 서비스 점검과 업데이트 관리를 미리 설정하세요. 클라이언트는 initialize 응답으로 이 설정을 받아 화면을 분기해요.
• 호출 컨텍스트: handleResult는 화면을 띄우기 위해 살아있는 Activity(Android) / UIViewController(iOS)가 필요해요. 호출 시점에 해당 컨텍스트가 finish/dismiss 되지 않았는지 확인 후 호출하세요.
• 게임서버 측 구현: SDK 점검 정보는 최초 initialize 시점에만 응답하므로, 게임서버 진입 차단·이용자 Kick·리소스 버전 검증은 별도로 구현하세요. (자세한 내용은 트러블슈팅 참고)

개발 흐름

1. 게임 시작 시 Auth.initialize(Android) / [SGSAuth initialize:](iOS) / Auth.Initialize(Unity·Unreal)를 호출하세요.
2. 콜백으로 받은 Result(errorCode 포함)를 그대로 OperationUI.handleResult(activity, result) { ... }에 전달하세요.
3. OperationUI가 errorCode를 분기해 적절한 화면을 자동으로 노출해요.
   • Auth.MaintenanceError (30003) → 점검 안내 화면
   • Auth.AppUpdateError (30004) → 앱 업데이트 안내 화면 (필수/선택 옵션에 따라 동작 분기)
   • 그 외 권한·계정 관련 에러 → 해당 안내 화면 (제재, 휴면, 탈퇴 등)
4. 이용자 인터랙션(확인/업데이트 이동/앱 종료)이 끝나면 listener 콜백이 호출돼요. 콜백 안에서 handled.isSuccessful() 여부로 게임 진입(로그인 → 캐릭터 선택 → 로비) 흐름을 이어가세요.
5. Auth.initialize 자체가 점검·업데이트가 아닌 사유(네트워크 오류 등)로 실패한 경우 재시도 로직을 별도로 구현하세요.

트러블슈팅

샘플 코드

using Stove.Auth;
using Stove.AuthUI;

Auth.Initialize(initRequest, (Result result) => {
    OperationUI.HandleResult(activity, result, (Result handled) => {
        if (handled.IsSuccessful()) {
            // 게임 진입 흐름 진행 (로그인 → 캐릭터 선택 → 로비)
        } else {
            // 사용자가 종료/취소 선택 → 앱 종료 처리
        }
    });
});

자주 묻는 질문