과몰입 방지

이해하기

국내에서 온라인으로 서비스하는 게임은 「게임산업진흥에 관한 법률」 시행령에 따라 일정 주기마다 과몰입 방지 문구를 게임 화면에 노출해야 해요.
스토브 PC SDK는 이 의무 표시를 처리할 수 있도록 Base SDK를 통해 과몰입 경고 메시지·게임 플레이 경과 시간·메시지 최소 노출 시간 정보를 콜백으로 전달해요.
게임에서는 전달받은 정보를 활용해 게임 내 식별 가능한 위치에 메시지를 노출하도록 UI를 구성하면 돼요.

적용 환경 및 동작 범위

SDK가 전달하는 정보

게임 플레이 시작 이후 일정 주기마다 콜백을 통해 다음 정보가 전달돼요.
게임에서는 이 값을 사용해 의무 표시 UI를 구성해요.

메시지 노출 예시

콜백으로 전달되는 메시지는 아래와 같은 형태예요. 경과 시간 정보가 메시지에 함께 포함되어 전달돼요.

"게임을 플레이한 지 1 시간이 지났습니다. 과도한 게임이용은 정상적인 일상생활에 지장을 줄 수 있습니다."

적용 방식

과몰입 방지 메시지는 두 가지 방식 중 선택해 적용할 수 있어요.
두 방식 모두 법령 요건(노출 주기, 최소 노출 시간, 가독성 등)을 충족해야 해요.

연동 가이드

기본 연동 구조

• 알림 등록
  • Base SDK 초기화가 완료된 후 Base_OverImmersionNotification API를 호출해 과몰입 방지 알림을 등록해요.
  • 이 API는 1회만 호출하면 되며, Base_Initialize 성공 콜백 내에서 호출하는 것을 권장해요.
  • 등록이 완료되면 게임 시작 시점부터 매 시간마다 OnOverImmersionFinished 콜백이 자동으로 호출돼요.

• 콜백 수신 및 정보 추출
  • 콜백에는 StovePCOverImmersion 구조체가 전달돼요. 구조체에서 메시지·경과 시간·최소 노출 시간을 조회해 화면에 노출해요.
  • GetWarningMessage()로 얻은 메시지는 Base_SetLanguage로 설정된 언어로 번역된 결과예요.
  • 한국 외 국가에서 호출되면 콜백에서 NOT_SUPPORTED_COUNTRY (31) 에러가 반환돼요. 국내 서비스 외에는 별도 처리 없이 자연스럽게 우회되도록 구현해 주세요.

• 메시지 노출
  • 게임 내 식별이 가능한 위치(예: 화면 상단/하단 띠 영역, 시스템 메시지 영역 등)에 메시지를 표시해요.
  • 전달받은 메시지 최소 노출 시간(초)만큼 화면에 유지한 후 자연스럽게 사라지도록 처리해요.
  • 메시지 영역은 다른 UI에 가려지지 않도록 z-order와 가독성을 확보해요.

개발하기

PC (PCSDK)

사전 준비

• BaseSDK 연동 및 초기화(Base_Initialize)가 선행돼야 해요. 초기화 전에 호출하면 콜백이 동작하지 않아요.
• 게임 루프에서 콜백 디스패치 함수(Base_RunCallback())가 주기적으로 호출돼야 콜백이 정상 전달돼요.
• 메시지를 다국어로 노출하려면 사전에 언어 설정 API(Base_SetLanguage(enum 기반) / Base_SetLanguageEx(문자열 기반))로 언어를 설정해요. 콜백에서 받는 메시지가 설정된 언어로 자동 번역돼요.
• 등록은 1회만 호출하면 돼요. 초기화 성공 직후에 호출하는 것을 권장해요.

개발 흐름

1. 알림 등록 초기화 완료 후 알림 등록 API(Base_OverImmersionNotification)를 호출해 과몰입 방지 알림을 등록해요.
2. 콜백 수신 게임 시작 시점부터 매 시간마다 등록한 콜백이 호출돼요. 콜백 인자는 콜백 결과와 과몰입 정보 객체예요. (CallbackResult·StovePCOverImmersion)
3. 결과 검증 콜백 결과로 성공 여부를 확인해요. (CallbackResult.IsSuccessful()) 한국 외 국가에서는 NOT_SUPPORTED_COUNTRY(31)가 반환돼요.
4. 정보 추출 과몰입 정보 객체에서 메시지·경과 시간·최소 노출 시간을 가져와요. (GetWarningMessage()·GetElapsedTimeInHours()·GetMinExposureTimeInSeconds())
5. 메시지 노출 게임 내 식별 가능한 위치에 메시지를 띄우고, 최소 노출 시간(초) 이상 유지한 뒤 자연스럽게 사라지게 처리해요.

트러블슈팅

샘플 코드

// 기존 C/C++ API (Native C/C++ · Unreal 공통)
using namespace Stove::PCSDK;
using namespace Stove::PCSDK::Base;

// (선택) 다국어 노출 시 사전 언어 설정
Base_SetLanguageEx(L"ko");

// 과몰입 방지 알림 등록 — Base_Initialize 성공 콜백 안에서 1회만 호출
Base_OverImmersionNotification(
    [](CallbackResult callbackResult, StovePCOverImmersion overImmersion)
    {
        if (callbackResult.GetResult().IsSuccessful())
        {
            const wchar_t* message   = overImmersion.GetWarningMessage();
            int32_t elapsedHours     = overImmersion.GetElapsedTimeInHours();
            int32_t minExposureSec   = overImmersion.GetMinExposureTimeInSeconds();
            // 게임 UI에 message 노출, minExposureSec 이상 유지 후 종료 처리
        }
        else
        {
            // 한국 외 국가(NOT_SUPPORTED_COUNTRY=31) 등은 자연스럽게 우회 처리
        }
    }
);

자주 묻는 질문