페이지 비교

1.1. Unity SDK 설치

...

참고사항

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

게임외 앱에서 플레이 중인 음악 볼륨이 작아지는 유니티 버그가 있습니다.
에디터 환경에서 웹소켓 연결이 멈추는 유니티 버그가 있습니다. 이 버그는 에디터 환경에서만 발생하는 이슈로, 안드로이드나 iOS빌드에서는 문제가 없습니다.
https://kakaogames.atlassian.net/wiki/spaces/KS3GFC/pages/413828469/1.1+Unity+SDK#1.1.4.4.-gradle-%EB%B2%84%EC%A0%84-%EC%84%B8%ED%8C%85 사용 방법 참조
"USING MEMORYADRESSES FROM MORE THAN 16GB OF MEMORY" 메시지와 함께 앱 실행시 크래쉬가 발생할 수 있습니다. (관련 이슈)
2018.x 버전에서 Android 12 이상 빌드시 검은 화면만 뜨는 버그가 있습니다.

...

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

파일	설명
KakaoGameSDK.unitypackage	배포되는 Unity 패키지 파일입니다.
SampleApp.zip	샘플 프로젝트입니다. 배포된 Unity패키지 파일(KakaoGameSdk.unitypackage)을 import하면, 샘플앱 실행이 가능합니다.
ApiReference.zip	카카오게임 Unity SDK의 API 레퍼런스 문서입니다.

...

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

경고
이전 버전 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님께 문의부탁드립니다.

...

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

코드 블럭
// KGPostBuild.cs if (KGSharedData.instance.useSigninWithApple) KGIosSupport.AddSigninWithAppleCapability(buildPath);

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

...

unitypackage를 import 후에 Assets/Plugins/Android/AndroidManifest.xml 파일에 게임에서 사용할 permission을 추가
1. <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

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

...

Kakao SDK v3.8.3 이상 버전 사용 필수
1. Unity Inspector 내에 Etc Setting(Use as needed) -> Domains to use HTTP(Android) 항목에 Add 버튼을 통해 게임에서 사용할 http domain을 추가
3.10.0 이후 버전에서 다음카페뷰를 로드하는 API가 추가되었는데, 이 API를 사용하기 위해서 모든 HTTP Domain의 호출이 필요한데 아래와 같은 설정이 필요합니다.
1. Etc Setting -> HTTP Domain -> Use All HTTP Domain Check 설정

...