Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

1.1. Unity SDK 설치

Table of Contents

...

1.1. Unity SDK 설치

Table of Contents

...

1.1.1. 설치 환경 및 실행 환경

  • 최소 버전

    • Unity 2019.4.15f1 이상 지원

  • 권장 버전

    • Unity 2020.3.43f1 이상

Note

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

...

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

파일

설명

KakaoGameSDK.unitypackage

  • 배포되는 Unity 패키지 파일입니다.

SampleApp.zip

  • 샘플 프로젝트입니다.

  • 배포된 Unity패키지 파일(KakaoGameSdk.unitypackage)을 import하면, 샘플앱 실행이 가능합니다.

ApiReference.zip

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

 

1.1.3. SDK 설치

1.1.3.1. Unity 패키지 파일 import하기

...

KakaoGameSdk.unitypackage를 실행하면, Unity3d툴에서 import할 수 있는 메뉴가 뜹니다.
기존 SDK에서 필요한 항목이 체크된 상태로 import를 진행합니다.

Warning

이전 버전 SDK 파일들에 의해 컴파일 에러가 발생할 수 있습니다.

...

Assets > Reimport All 또는 에디터를 재부팅하면 KGAssetImporter에 의해 자동으로 이전 SDK 파일들을 제거합니다.

...

  • 먼저 카카오게임 속성 설정을 해야 합니다. 먼저 설정 항목에 대한 설명을 확인하시길 바랍니다.

카카오게임 SDK 속성

타입

필수

설명

예시

App Id

String

O

아래 둘 중 한곳에서 확인할 수 있습니다.
카카오 개발자 페이지 > 내 어플리케이션 > 앱 선택 > 앱 설정 > 요약 정보
카카오게임 3.0 어드민 -> 게임빌드 -> 클라이언트 버전 관리

103815

App Secret

String

O

카카오 개발자 페이지 > 내 어플리케이션 > 앱 선택 > 앱 설정 > 요약 정보에서 확인할 수 있는 네이티브 앱 키와 동일합니다.

951b75bf17fe0885ab5106ba2a9f9bc9

Debug Level

String

X

SDK 로그 출력 레벨을 설정합니다. "Verbose", "Debug", "Error", "None" 중 하나를 선택할 수 있습니다.

None

  • 아래 그림과 같이 카카오게임 속성을 설정하도록 합니다.

  • 설정 이후 잘 설정되었는지 확인하기 위해 Check configuration setting 버튼을 클릭합니다.
     

  • 잘 설정되어있지 않을 경우, 아래와 같이 원인 문구가 나옵니다.
    아래의 경우는 유효하지 않은 앱아이디를 사용하고 있어서 발생합니다.
    기술PM님이 전달받은 앱아이디가 잘 등록되었는지 확인합니다. 잘 등록되어 있을 경우, 기술PM님께 문의부탁드립니다.

...

Warning

https://docs.unity3d.com/2018.4/Documentation/ScriptReference/iOS.Xcode.PBXCapabilityType.SignInWithApple.html
해당 API를 지원하지 않는 유니티 버전의 경우 빌드 에러가 발생할 수 있습니다.

Code Block
// KGPostBuild.cs
if (KGSharedData.instance.useSigninWithApple)
    KGIosSupport.AddSigninWithAppleCapability(buildPath);

만약, 사용중인 유니티 버전에서 위의 코드에서 빌드 에러가 발생한다면, 해당 유니티 버전이 signin with apple capabilities를 추가하는 기능을 지원하지 않는 버전입니다.

...

1.1.4.1. Permission 설정

  1. unitypackage를 import 후에 Assets/Plugins/Android/AndroidManifest.xml 파일에 게임에서 사용할 permission을 추가

    1. <uses-permission android:name="android.permission.XXXXXX" /> 형태로 추가

...

SDK unitypackage에서 제공하는 파일을 그대로 사용해주셔도 상관없습니다.

Unity 2022.2 이상을 사용할 경우

자동 생성된 파일에

Code Block
// Make sure that you have the Google services Gradle plugin dependency
id 'com.google.gms.google-services' version "4.3.15" apply false

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

  • gradleTemplate.properties

...

  1. Kakao SDK v3.8.3 이상 버전 사용 필수

    1. Unity Inspector 내에 Etc Setting(Use as needed) -> Domains to use HTTP(Android) 항목에 Add 버튼을 통해 게임에서 사용할 http domain을 추가

  2. 3.10.0 이후 버전에서 다음카페뷰를 로드하는 API가 추가되었는데, 이 API를 사용하기 위해서 모든 HTTP Domain의 호출이 필요한데 아래와 같은 설정이 필요합니다.

    1. Etc Setting -> HTTP Domain -> Use All HTTP Domain Check 설정

...