80. 오프라인 게임 연동

 

모바일 게임이 오프라인 모드에서도 정상으로 게임 플레이 가능하도록 지원하는 API를 안내합니다.

 

 


오프라인 모드?

  • 인터넷에 연결되어 있지 않는 상태

  • 스마트폰 설정에서 '비행기 모드'로 전환된 상태와 동일

     

제공하는 API (SDK 3.11.4 이상)

1. 퍼블리싱 약관 동의 정보 관리

  • 게임에서 UI를 구현한 <게임즈 통합약관> 페이지를 띄우면, 유저가 동의한 약관 동의 정보를 기기에 저장시킬 수 있는 API 제공

구분

SDK API

설명

구분

SDK API

설명

KGAgreement

setAgreement

게임에서 UI를 구현한 <퍼블리싱 약관 동의> 플로우에서 사용자가 동의한 약관 정보를 디바이스에 저장할 수 있음

getAgreement

유저 디바이스에 저장한 약관 동의 정보를 리턴

 

2. 계정 연동

  • 게임에서 다음과 같이 2가지 옵션으로, 유저가 <계정 연동> 방식을 선택할 수 있는 기능 구현 시 제공하는 기능입니다.

  • 상황 : 게스트 로그인으로 플레이 하다가, 이미 플레이어 아이디가 연결된 IDP계정으로 <계정 연동>을 시도하면, 아래 옵션에서 선택할 수 있는 UI를 노출

  • 제공 옵션

    1. 로그인 되어 있는 현재의 게스트 로그인으로 계속 플레이 할 수 있음

    2. 게스트 로그인으로 플레이한 게임 데이터를 삭제하고, 기존에 이미 계정 연동한 IDP 계정의 게임 데이터를 불러올 수 있음

구분

SDK API

설명

구분

SDK API

설명

KGSessionForCustomUI

connectIdpAccount

계정 연동 시, AlreadyUsedIdAccount(406) 에러를 리턴하더라도 idp account logout은 처리하지 않도록 동작함

chooseIdpAccount

이미 플레이어 아이디가 연결된 IDP계정으로 <계정 연동> 시도할때, 유저가 선택할 수 있는 옵션창을 게임에서 구현 시, 해당 기능성을 지원함

  • CurrentAccount 모드를 선택하면, 계정연결 시도시에 로그인했던 idp의 로그아웃 기능을 처리함

  • AlreadyConnectedAccount 모드를 선택하면, 이미 플레이어 아이디가 있는 idp 계정으로 전환하여 로그인을 처리함

 

 

사전 준비사항 : 퍼블리싱 약관 미노출 설정

  • 퍼블리싱 게임의 경우, 최초 로그인 유저에게는 <게임즈 통합약관> 페이지가 노출이 되도록 동작합니다.

  • 게스트로그인을 백그라운드에서 인증을 시키고, 유저에게는 <게임즈 통합약관> 페이지를 미노출 할 경우, 다음과 같이 설정 작업이 필요합니다.

    • 담당자 : 카카오게임즈 기술PM

    • 설정 메뉴 : 지니 어드민 - 게임빌드 - 클라이언트 버전관리 (https://admin-zinny3.game.kakao.com/game/buildList)

    • option key : offTermsAgreementPopup

    • option value : 디폴트로 빈값 (해당 key만 등록되어 있으면 동작함. value는 아무값이나 설정 가능)