1.1. Unity SDK 설치
목차 |
---|
...
1.1. Unity SDK 설치
목차 |
---|
...
1.1.1. 설치 환경 및 실행 환경
최소 버전
Unity 2019.4.15f1 이상 지원
권장 버전
Unity 2020.3.43f1 이상
참고사항 |
---|
권장 버전을 사용하지 않을 경우, 아래와 같은 문제가 있습니다.
|
...
전달받은 KakaoGameSDK_Unity_[버전].zip 파일은 다음과 같은 파일들로 구성되어 있습니다.
파일 | 설명 |
---|---|
KakaoGameSDK.unitypackage |
|
SampleApp.zip |
|
ApiReference.zip |
|
1.1.3. SDK 설치
1.1.3.1. Unity 패키지 파일 import하기
...
KakaoGameSdk.unitypackage를 실행하면, Unity3d툴에서 import할 수 있는 메뉴가 뜹니다.
기존 SDK에서 필요한 항목이 체크된 상태로 import를 진행합니다.
경고 |
---|
이전 버전 SDK 파일들에 의해 컴파일 에러가 발생할 수 있습니다. |
...
Assets > Reimport All 또는 에디터를 재부팅하면 KGAssetImporter에 의해 자동으로 이전 SDK 파일들을 제거합니다.
...
먼저 카카오게임 속성 설정을 해야 합니다. 먼저 설정 항목에 대한 설명을 확인하시길 바랍니다.
카카오게임 SDK 속성 | ||||
---|---|---|---|---|
키 | 타입 | 필수 | 설명 | 예시 |
App Id | String | O | 아래 둘 중 한곳에서 확인할 수 있습니다. | 103815 |
App Secret | String | O | 카카오 개발자 페이지 > 내 어플리케이션 > 앱 선택 > 앱 설정 > 요약 정보에서 확인할 수 있는 네이티브 앱 키와 동일합니다. | 951b75bf17fe0885ab5106ba2a9f9bc9 |
Debug Level | String | X | SDK 로그 출력 레벨을 설정합니다. "Verbose", "Debug", "Error", "None" 중 하나를 선택할 수 있습니다. | None |
아래 그림과 같이 카카오게임 속성을 설정하도록 합니다.
설정 이후 잘 설정되었는지 확인하기 위해 Check configuration setting 버튼을 클릭합니다.
잘 설정되어있지 않을 경우, 아래와 같이 원인 문구가 나옵니다.
아래의 경우는 유효하지 않은 앱아이디를 사용하고 있어서 발생합니다.
기술PM님이 전달받은 앱아이디가 잘 등록되었는지 확인합니다. 잘 등록되어 있을 경우, 기술PM님께 문의부탁드립니다.
...
경고 |
---|
https://docs.unity3d.com/2018.4/Documentation/ScriptReference/iOS.Xcode.PBXCapabilityType.SignInWithApple.html |
|
만약, 사용중인 유니티 버전에서 위의 코드에서 빌드 에러가 발생한다면, 해당 유니티 버전이 signin with apple capabilities를 추가하는 기능을 지원하지 않는 버전입니다.
...
1.1.4.1. Permission 설정
unitypackage를 import 후에 Assets/Plugins/Android/AndroidManifest.xml 파일에 게임에서 사용할 permission을 추가
<uses-permission android:name="android.permission.XXXXXX" /> 형태로 추가
...
SDK unitypackage에서 제공하는 파일을 그대로 사용해주셔도 상관없습니다.
Unity 2022.2 이상을 사용할 경우
자동 생성된 파일에
코드 블럭 |
---|
// 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
...
Kakao SDK v3.8.3 이상 버전 사용 필수
Unity Inspector 내에 Etc Setting(Use as needed) -> Domains to use HTTP(Android) 항목에 Add 버튼을 통해 게임에서 사용할 http domain을 추가
3.10.0 이후 버전에서 다음카페뷰를 로드하는 API가 추가되었는데, 이 API를 사용하기 위해서 모든 HTTP Domain의 호출이 필요한데 아래와 같은 설정이 필요합니다.
Etc Setting -> HTTP Domain -> Use All HTTP Domain Check 설정
...