버전 비교

버전 이전 버전 9 새 버전 현재
변경한 사람

Eric

KG_SDKDEV

에 저장

키

  • 이 줄이 추가되었습니다.
  • 이 줄이 삭제되었습니다.
  • 서식이 변경되었습니다.
목차
7
minLevel1
maxLevel6
include
outlinefalse
indent
stylenone
exclude
typelist
class
printabletrue

...

1. 설치 환경 및 실행 환경

  • 최소 버전

    • Unity 2021.3.37f1 이상

  • 권장 버전

    • Unity 2022.3.21f1 이상

참고사항

권장 버전을 사용하지 않을 경우, 아래와 같은 문제가 있습니다.

2. SDK 파일 구성

전달받은 KakaoGamesSDK_Unity_[버전].zip 파일은 다음과 같은 파일들로 구성되어 있습니다.

파일

설명

KakaoGamesSDK.unitypackage

  • 배포되는 unitypackage 파일입니다.

  • 종속 항목이 포함되어 있습니다.

com.kakaogames.sdk-[버전].tgz

  • 배포되는 tgz 파일입니다.

  • 종속 항목이 포함되어 있지 않습니다.

    • https://developers.google.com/unity/archive?hl=ko 종속 항목을 추가해줍니다.

    • EDM, FirebaseApp, FirebaseCrashlytics tgz 파일을 다운받아서 순서대로 설치해주거나 FirebaseCrashlytics.unitypackage를 설치해주어야합니다.

SampleApp.zip

  • 샘플 프로젝트입니다.

ApiReference.zip

  • 카카오게임 Unity SDK의 API 레퍼런스 문서입니다.

3. SDK 설치

3.1. unitypackage 파일로 설치하기

먼저 Unity에서 게임 프로젝트를 오픈합니다.
KakaoGamesSDK.unitypackage를 실행하면, Unity에서 import할 수 있는 메뉴가 뜹니다. 모든 항목이 체크된 상태로 import를 진행합니다.

참고사항

macOS에서 빌드하는 경우 아래와 같은 경고창이 발생할 수 있습니다.

...

? 클릭 > 개인정보 보호 및 보안 설정 열기 클릭 > 확인 없이 허용 클릭 후

...

...

3.1

...

SDK에서 newtonsoft-json을 사용하게 되면서 해당 패키지를 필수로 설치해야 합니다.

프로젝트 루트 디렉토리에서 Packages/manifest.json을 열고 "com.unity.nuget.newtonsoft-json": "3.0.2" 을 추가합니다.

...

languagejson

...

.

...

참고사항

추가하지 않을 경우 다음과 같은 오류가 뜨며 빌드가 되지 않습니다.

...

정보

Package Manager로 설치하는 경우 자동으로 설치됩니다.

...

 Package Manager로 설치하기(

...

Scoped Registry)

  1. Window Project Settings - Package Manager를 열어 줍니다Manager - Scoped Registries에 아래와 같이 스코프를 설정해줍니다.

    Image Removed스크린샷 2024-10-16 오후 7.23.22.pngImage Added

  2. Add Package from tarball… 를 통해 종속 패키지를 설치해줍니다.

    Image Removed

  3. EDM, Firebase App, Firebase Crashlytics 순서로 설치해줍니다.

    Image Removed

  4. 마찬가지로 com.kakaogames.sdk-<버전>.tgz 파일로 패키지를 설치해줍니다.

    Image RemovedImage Removed

    Package Manager를 열고 My Registry로 변경후 SDK를 설치합니다.

    스크린샷 2024-10-16 오후 7.24.00.pngImage Added

  5. 시작화면을 띄웁니다.

    스크린샷 2024-10-16 오후 7.16.01.pngImage Added

  6. 필수 플러그인을 설치합니다.

    스크린샷 2024-10-16 오후 7.27.26.pngImage Added

4. 카카오 게임 SDK 설정

...

  1. SDK 설치를 완료하면, Unity 메뉴에 KakaoGames/Configure SDK 라는 메뉴가 생긴걸 확인할 수 있습니다.

    Image RemovedImage Added

    클릭시 KGTConfiguration.asset으로 이동됩니다. 혹은 바로 Assets/KakaoGames/KGTConfiguration.asset 파일의 Inspector를 확인할 수 있습니다.

    Image RemovedImage Added

  2. KGTConfiguration.asset의 Inspector를 통해 카카오 게임에서 사용할 속성을 설정할 수 있습니다.

    Image RemovedImage Added

4.2. 공통 설정

4.2.1. 기본 설정

...

  • 아래 그림과 같이 카카오게임 기본 설정을 작성합니다.

    • Image RemovedImage Added

  • 설정 이후 Test Configuration 버튼을 클릭합니다.

  • 올바르게 설정되어 있을 경우

  • 잘못 설정되어 있을 경우

    • Image RemovedImage Added

4.3. Android 설정

...

 

2021.3

2022.3

필수로 사용하는 항목

 

스크린샷 2024-04-25 오후 4.20.09.png

 

 

스크린샷 2024-04-25 오후 4.19.22.png

 

AndroidManifest.xml

SDK 내부 로직에 의해 자동으로 생성됩니다.

SDK 내부 로직에 의해 자동으로 생성됩니다.

mainTemplate.gradle

반드시 체크가 필요하며 필요한 디펜던시스는 EDM에 의해 자동 세팅됩니다.

External Dependency Manager를 통해 Android Dependencies가 세팅됩니다.

반드시 체크가 필요하며 필요한 디펜던시스는 EDM에 의해 자동 세팅됩니다.

External Dependency Manager를 통해 Android Dependencies가 세팅됩니다.

launcherTemplate.gradle

자동생성된 파일에

코드 블럭
apply plugin: 'com.google.firebase.firebase-perf'
apply plugin: 'com.google.firebase.crashlytics'

해당 구문을 추가해야합니다.

자동생성된 파일에

코드 블럭
apply plugin: 'com.google.firebase.firebase-perf'
apply plugin: 'com.google.firebase.crashlytics'

해당 구문을 추가해야합니다.

자동 생성된 파일을 사용하시면 됩니다.

자동 생성된 파일을 사용하시면 됩니다.

baseProjectTemplate.gradle

자동생성된 파일에

코드 블럭
classpath 'com.google.gms:google-services:4.3.3'
classpath 'com.google.firebase:perf-plugin:1.2.0'
classpath 'com.google.firebase:firebase-crashlytics-gradle:2.2.0'

해당 구문을 추가해야합니다.

자동 생성된 파일에

코드 블럭
// Make sure that you have the Google services Gradle plugin dependency
id 'com.google.gms.google-services' version "4.3.15" apply false
// Add the dependency for the Performance Monitoring Gradle plugin
id 'com.google.firebase.firebase-perf' version "1.4.2" apply false
// Add the dependency for the Crashlytics Gradle plugin
id 'com.google.firebase.crashlytics' version "2.9.8" apply false

해당 구문을 추가해야합니다.

gradleTemplate.properties

유니티와 EDM에 의해 자동 생성된 파일을 사용하시면 됩니다.

유니티와 EDM에 의해 자동 생성된 파일을 사용하시면 됩니다.

settingTemplate.gradle

2021.3 버전에는 해당 파일이 없습니다.

자동 생성된 파일을 사용하시면 됩니다.

4.3.2. Permission 설정

Assets/Plugins/Android/AndroidManifest.xml 파일에 게임에서 사용할 permission을 추가할 수 있습니다.

...

  1. 게임 설정에 맞는 google-services.json 파일을 다운로드 합니다.

  2. 해당 파일을 다운로드 받은 후에 Assets/Plugins/Android 폴더 아래에 위치시킵니다.

  3. firebase sdk에서 자동으로 google-services.xml 또는 google-services-desktop.json를 생성해줍니다.

    Image RemovedImage Added

  4. firebase sdk를 설치하지 않는 경우, https://github.com/firebase/firebase-cpp-sdk에서 generate_xml_from_google_services_json.exe와 generate_xml_from_google_services_json.py을 다운로드 후 프로젝트에 추가해줍니다. 또는 수동으로 google-services.xml 또는 google-services-desktop.json을 직접 생성해줄 수 있습니다.

...

  1. Unity3d툴에서 File -> Build Settings... 메뉴를 선택합니다. 

  2. 아래와 같이 "Build Settings"창에서 Platfrom을 iOS로 설정하고, "Player Settings..."버튼을 클릭합니다.

    Image RemovedImage Added

  3. 카카오게임 SDK의 iOS 최소 지원 버전은 13.0입니다.

  4. Image RemovedImage Added

    Build 버튼을 클릭하여 빌드합니다. 빌드가 성공하면, Xcode 프로젝트가 생성됩니다.

...

  1. 카카오 인증을 사용할 경우, Kakao 체크 박스를 클릭합니다.

  2. Windows SDK를 사용하는 경우 App Key를 설정합니다.

    Image RemovedImage Added

4.5.2. Signin with Apple 정보 설정

...

  1. Signin with Apple을 사용할 경우, SigninWithApple 체크 박스를 클릭합니다.

  2. 애플 어드민에서 발급받은 ClientId 항목을 입력합니다.

    Image RemovedImage Added

유니티 버전별로 signin with apple 관련 설정이 추가로 필요합니다.

...