버전 비교

버전 이전 버전 1 새 버전 2
변경한 사람

Eric

QATEAM

에 저장

키

  • 이 줄이 추가되었습니다.
  • 이 줄이 삭제되었습니다.
  • 서식이 변경되었습니다.
목차 영역
목차

초기화 및 상태변화 이벤트 처리

...

Initialization and Status Change Event Processing

App Event Method Initialization (iOS Only)

발췌
nameapplication_ios_appDelegate

SDK에서 AppDelegate 메서드를 처리하기 위해 초기화 하는 과정을 수행합니다.

AppDelegate 클래스에서 호출되어야 합니다This process initializes the SDK to handle AppDelegate methods.

It must be called within the AppDelegate class.

SDK

...

Initialization

발췌
nameapplication_init_sdk

SDK에서 사용하는 앱 정보를 설정하고 초기화 하는 과정을 수행합니다.

게임 시작 시 다른 API보다 먼저 호출되어야 합니다This process sets and initializes the app information used by the SDK.

It must be called before any other API when the game starts.

...

Start

...

발췌
nameapplication_start

게임이 실행되면, 게임은 시작 함수를 호출하여 게임이 실행되었다는 정보를 카카오게임 SDK로 전달해야 합니다.

카카오게임 SDK의 시작 함수가 호출되면 플랫폼의 공지 사항, 업데이트 정보, 약관 동의 등의 UI 기능을 수행합니다.

만약 이전에 로그인한 사용자의 기록이 있다면 자동 로그인을 수행합니다. 이후 그 결과를 메서드 호출 시 게임에서 입력한 콜백 함수를 통해 전달합니다.

따라서, 게임은 그 결과를 활용하여 사용자의 인증을 먼저 수행해야 할지, 혹은 이전에 하던 게임을 재개해야 할 지에 대한 결정을 할 수 있습니다When a game is started, it must call the Start function to notify the Kakao Game SDK that it has been started.

UI functions such as platform announcements, update news, and term agreements are performed when the Start function of the Kakao Game SDK is called.

If there exists a prior user login record, the automatic login function is also performed, and the result is sent through the callback function inputted in the game when the method is called.

Therefore, the game can use the results to decide whether to authenticate the user first or whether to resume a previous game.

Pause

...

발췌
nameapplication_pause

모바일 환경에서 게임이 백그라운드로 내려가는 시점이 오면, 게임은 Pause API를 호출하여 게임이 비 활성화되었다는 정보를 카카오게임 SDK로 전달해야 합니다.

카카오게임 SDK는 Pause API가 호출되면 배터리 소모를 막기 위해 연결된 세션을 끊고, 주기적으로 발송되던 Heartbeat을 중단합니다If the game is moved to the background, the game must call the Pause API to notify the Kakao Game SDK that it has become inactive.

When the Pause API is called, the Kakao Game SDK disconnects the connected session and stops periodically sending heartbeats to prevent battery consumption.

Resume

...

발췌
nameapplication_resume

모바일 환경에서 게임이 백그라운드로 내려갔다가 다시 활성화되는 시점이 오면, 게임은 Resume API를 호출하여 게임이 활성화되었다는 정보를 카카오게임 SDK로 전달해야 합니다.

카카오게임 SDK는 Resume 메서드가 호출되면 인증의 만료 여부를 확인하고 그 여부에 따라 세션을 복구한 후 그 결과를 메서드 호출시 게임에서 입력한 콜백 함수를 통해 전달합니다.

게임은 그 결과를 활용하여 사용자의 인증을 다시 수행해야 할지, 혹은 이전에 하던 게임을 재개해야 할 지에 대한 결정을 할 수 있습니다If the game is moved back to the foreground from the background, it must call the Resume API to notify the Kakao Game SDK that it has become active.

The Kakao Game SDK checks whether the authentication has expired when the Resume method is called and restores the session depending on the check. The result is then sent through the callback function inputted in the game when the method is called.

The game can use the results to decide whether to authenticate the user again or whether to resume a previous game.습니다.

...

Setting Up Auto Login in a Windows Environment

발췌
nameapplication_set_use_auto_login

윈도우즈 환경에서 지원하는 기능입니다.

SDK에서 제공하는 기본 로그인 UI를 사용하지 않고, 로그인 UI를 직접 구현하는 경우 자동로그인 방식을 설정하는 기능을 제공합니다.

  • 자동로그인 유무를 설정하지 않으면 기본으로 자동로그인을 위한 파일을 생성하지 않습니다.

    • 자동로그인을 위한 파일이 생성되는 위치는 PC에서 여러 사용자가 있을 수 있어서

    This feature is supported in the Windows environment.

    If you do not use the default login UI provided by the SDK and instead implement your own login UI, the SDK offers a feature to set up auto login.

    • If you do not configure auto login, the SDK will not create a file for automatic login by default.

    • The file for auto login is created and stored in an encrypted format in the folder "C:\Users\사용자[User]\AppData\Local\.kakaogames\앱아이디" 폴더에 [AppdID]" under the name ".access"이름의 파일에 암호화되어 저장하고 있습니다.게임을 삭제하고 재 설치 시 자동로그인 파일이 남아 있는 경우 자동로그인이 진행되는 것을 막기 위해 윈도우SDK파일. This is because multiple users can exist on a single PC."

    • When a game is uninstalled and then reinstalled, if the auto login file remains, the SDK checks whether an encrypted ".access" file exists in the location of the Windows SDK file (KakaoGame.dll)위치에 암호화된 ".access"파일이 존재하는지 여부를 체크하고 정상적인 파일일 때 자동로그인 정보가 들어있는 파일을 불러와 자동로그인을 수행합니다.

    • 자동로그인을 위한 파일들이 손상되면 해당 파일들을 삭제합니다.

    • 자동로그인을 위한 파일이 존재한 상태에서 로그아웃이나 탈퇴를 진행하면 자동로그인을 위한 파일이 삭제됩니다. If the file is valid, the SDK loads the file containing the auto login information and performs the auto login.

    • If the auto login files are corrupted, the SDK will delete them.

    • If the auto login file exists and the user logs out or withdraws, the auto login file will be deleted.

    ...

    Adding a new Intent receive setting

    발췌
    nameapplication_android_intent

    Android SDK를 직접 사용하는 경우 필요한 설정입니다.

    게임의 MainActivity 내부에 아래와 같이 콜백을 추가합니다.

    이 설정을 추가하지 않으면 게임하기를 통한 게임의 유입경로 체크에 문제가 됩니다. 반드시 추가해주세요.

    그리고 Unity 환경에서 직접 Android SDK를 연동하는 경우 아래 설정을 추가한 해당 MainActivity를 Unity 의 This setting is required if you are using the Android SDK directly.

    Add a callback inside MainActivity of the game as shown below.

    If you do not add this setting, there will be a problem checking your game's funnel through 'game-play' page on KakaoTalk. Please be sure to add.

    And when using Unity, set the corresponding MainActivity as the main activity in Unity Assets / Plugins / Android / AndroidManifest.xml 파일에 main activity로 설정해 줍니다file.

    (카카오게임 Unity, Unreal SDK를 사용하는 경우 자동으로 설정하고 있어서 추가 설정이 필요하지 않습니다If you are using the KakaoGames Unity or Unreal SDK, this setting is configured automatically, so no additional setup is required.)

    ...