게임시간 선택제

이해하기

게임시간 선택제(셧다운제)는 19세 미만 청소년의 게임 이용 시간을 보호자가 선택·제한할 수 있도록 마련된 제도예요.
스토브 플랫폼은 이용 등급이 19세 미만인 게임에 대해 이 기능을 지원해요.

스토브 PC SDK는 Base SDK 콜백으로 게임 종료까지 남은 시간·알림 메시지·메시지 노출 시간을 전달해요.
게임에서는 이 정보를 활용해 인게임 알림을 노출하고, 0분 도달 시 게임을 자연스럽게 종료해야 해요.

적용 환경 및 동작 범위

SDK가 전달하는 정보

대상자가 게임에 로그인하면 일정 시점마다 콜백을 통해 다음 정보가 전달돼요.
게임에서는 이 값을 사용해 알림 UI를 구성하고, 종료 시점에 게임 강제 종료 처리를 수행해요.

콜백 호출 시점과 알림

OnShutdownFinished 콜백은 게임 시간 만료 임박 시점부터 종료 시점까지 최대 4회 호출돼요.
게임 UI에서는 각 시점에 맞춰 알림을 노출해야 해요.

연동 가이드

연동 준비

게임시간 선택제 기능을 사용하려면 셧다운 적용 대상 게임 목록과 이용 시간 설정이 사전에 완료되어야 해요.
해당 설정은 퍼블리싱 기술 담당자에게 문의해 주세요.

기본 연동 구조

게임 실행부터 종료까지 알림 등록 → 콜백 수신 → 알림 노출 및 종료 처리 순으로 동작해요.

StovePCShutdown 구조체

콜백을 통해 전달되는 구조체는 다음 메서드를 제공해요.

개발하기

PC (PCSDK)

사전 준비

• BaseSDK 연동 및 초기화(Base_Initialize)가 선행돼야 해요.
• 게임 루프에서 콜백 구동 함수(Base_RunCallback())가 주기적으로 호출돼야 콜백이 정상 전달돼요.
• 퍼블리싱 기술 담당자가 셧다운 게임 리스트 추가, 상점 등록 및 키 발급, 게임시간 선택제 페이지 구성, 원스톱 셧다운 서비스 적용을 사전에 완료해야 해요.
• 등록은 1회만 호출하면 돼요. 초기화 성공 이후에 호출하는 것을 권장해요.

개발 흐름

1. 알림 등록: 초기화 완료 후 셧다운 알림 등록 함수(Base_ShutdownNotification)를 호출해요.
2. PCSDK 내부 처리: PCSDK가 Web API로 이용자의 셧다운 정보를 조회해요. 대상자인 경우 이벤트가 등록되고, 대상자가 아니면 콜백이 호출되지 않아요.
3. 사전 알림 콜백 (10·5·1분 전): 셧다운 알림 콜백이 전달돼요. StovePCShutdown의 GetInadvanceTimeInMinutes()(C#은 inadvanceTimeInMinutes)로 남은 시간을, GetShutdownMessage()(C#은 shutdownMessage)로 메시지를 가져와 UI에 노출해요. GetExposureTimeInSeconds()(C#은 exposureTimeInSeconds) 이상 유지해요.
4. 종료 콜백 (0분): 남은 시간(GetInadvanceTimeInMinutes())이 0이면 종료 안내 UI를 노출하고 이용자 확인 입력을 받아요.
5. 게임 종료: 이용자 확인 후 게임 프로세스를 즉시 종료해요. 종료 안내가 누락되면 정책 위반이 될 수 있어요.

트러블슈팅

샘플 코드

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

// 1) 셧다운 알림 등록 — Base_Initialize 성공 콜백 안에서 1회 호출
Base_ShutdownNotification(
    [](CallbackResult callbackResult, StovePCShutdown shutdown)
    {
        if (!callbackResult.GetResult().IsSuccessful())
        {
            // 비대상자/예외 처리
            return;
        }

        int32_t remaining   = shutdown.GetInadvanceTimeInMinutes();
        const wchar_t* msg  = shutdown.GetShutdownMessage();
        int32_t exposureSec = shutdown.GetExposureTimeInSeconds();

        // UI에 메시지 노출, exposureSec 이상 유지
        if (remaining == 0)
        {
            // 종료 안내 UI 노출 → 사용자 확인 입력 → 게임 프로세스 종료
        }
    }
);

자주 묻는 질문