HardCore in Programming

유니티를 사용하다 보면 디버깅을 위해 로그를 찍을때 리스트 뷰에서는 콜스택에 대한 정보를 볼수 없어 귀찮은 경우가 많다. 어셋 스토에서 판매하고 있는 'Console Pro'라는 어셋을 사용하면 편리하긴하지만..

using UnityEngine;

public static class LogHeader

{

    public static string Path

    {

        get

        {

#if UNITY_EDITOR || USE_DEBUGGING

            string callStack = StackTraceUtility.ExtractStackTrace();

            callStack = callStack.Substring(callStack.IndexOf("\n") + 1);

            callStack = callStack.Substring(0, callStack.IndexOf("\n") + 1);

            return callStack;

#else

            return "";

#endif

        }

    }

    public static string Function

    {

        get

        {

#if UNITY_EDITOR || USE_DEBUGGING

            string callStack = StackTraceUtility.ExtractStackTrace();

            callStack = callStack.Substring(callStack.IndexOf("\n") + 1);

            callStack = callStack.Substring(0, callStack.IndexOf("("));

            //callStack = callStack.Substring(0, callStack.IndexOf(" ") + 1);

            return "[" + callStack + "] ";

#else

            return "";

#endif

        }

    }

    // example :

    //     Debug.Log(LogHeader.Function + "any log text will be here");

    // result :

    //    CallStackLogMain:func_2() (at Assets/CallStackLogMain.cs:17)

    //    any log text will be here

}

유니티로 작업하다 보면 데이터를 저장하기 위해 SerializedField와 같은 어트리뷰트를 사용한다. 문제는 개발 도중 이 필드의 이름이 변경되어 기존 저장된 데이터들을 사용하지 못하게 되는 경우가 있다. 이런 경우 FormerlySerializedAs 어트리뷰트를 이용해 기존 버전과의 호환성을 유지해 줄 수 있다.

만일 아래와 같이 m_MyVariable이라는 멤버 변수를 사용하고 있는데 :

m_MyVariable의 이름이 다른 것으로, 예를 들자면 m_ABetterName와 같이 바뀐다면 기존에 m_MyVariable의 이름으로 저장된 데이터를 읽어 들이지 못하게 된다.

이럴 경우 아래와 같이 작성해주게 된다면 기존  m_MyVariable의 데이터를 m_ABetterName으로 치환해서 읽어 들일수 있다 :

그리고 FormerlySerializedAs 는 여러번 중복해서 사용가능하다. 만일 이름이 여러 번 변경 된다고 하더라도 변경 히스토리에 따라 FormerlySerializedAs 어트리뷰트를 유지해 준다면 여전히 데이터 손실 없이 사용이 가능하다.

원문 : https://blogs.unity3d.com/2015/02/03/renaming-serialized-fields/

Unity가 편한 개발 엔진이라고 아무런 기본 지식 없이 마냥 닥치는대로 하려다보니 이래저래 어려움이 많다.

이 포스팅에서는 Unity를 사용하기 전에 미리 알면 도움이 되는 기본 지식들에 대해서 다뤄 보자

• SetParent 
• 개인적으로 worldPositionStays 파라메터를 자주 잊거나 헷깔림
• worldPositionStays 가 true일 경우. 자식이 되는 오브젝트의 월드 좌표는 변경되지 않는다(화면상으로 보기엔 그냥 그대로 있는것 같다는 말). 하지만 부모가 변경 되었으므로 로컬 좌표가 변경된다.
  예를 들어 부모가 없는 두 오브젝트(부모가 없다는 것은 월드 포지션과 로컬 포지션이 같다는 의미) A가 (0, 1)에, 오브젝트 B가 (1, 0)에 있는 경우, SetParent 함수 호출시 worldPositionStays를 true로 하면 자식이 되는 오브젝트 B의 월드 포지션은 여전히 (1, 0)이고 부모와의 관계를 나타내는 로컬 포지션은 (1, -1)로 변경 된다(유니티 인스펙터에는 로컬 포지션이 표시된다).
• worldPositionStatys가 false일 경우. 자식이 되는 오브젝트의 로컬 좌표 값을 새로운 부모와 그대로 유지한다. 오브젝트 B가  오브젝트 A의 자식이 되는 경우 B의 로컬 포지션(1, 0)은 그대로 유지되며 대신 월드 포지션이 변경 된다.
  
• LLVM(Low Level Vritual Machine) : 프로그램을 컴파일 타임, 링크 타임, 런타임 상황에서 프로그램의 작성 언어에 상관 없이 최적화를 쉽게 구현할 수 있도록 구성. LLVM으로 언어에 가상 기계를 생성, 가상 기계가 언어에 독립적인 최적화를 실행한다.
• IL2CPP : https://blogs.unity3d.com/2015/05/06/an-introduction-to-ilcpp-internals/
• Intermediate Language to CPP
• 좌표계 : Unity uses a number of 2D coordinate spaces, most of which define X as increasing to the right, and Y increasing upwards. The one exception is in the GUI and GUILayout classes, where Y increases downwards.
• Resources - http://docs.unity3d.com/ScriptReference/Resources.html
• Assets 폴더 밑 어느 곳에라도 Resources 폴더를 만들고 asset들을 넣어두면 Resources.Load로 접근 가능
• 개인적으로 Resources 폴더를 어디에 만들어야 할지 몰라 한참을 고생했었기에 기록에 남긴다.
• Resources 디렉토리 밑에 스프라이트를 두면 SpritePacker로 아틀라스를 만들지 못한다.
• GameObject - http://docs.unity3d.com/ScriptReference/GameObject.html
• Unity scene 안에 있는 모든 것들의 베이스 클래스
• Transform - http://docs.unity3d.com/ScriptReference/Transform.html
• scene 안에 있는 모든 객체들이 가지고 있는 위치, 스케일, 회전 정보
• transform은 부모 transform을 가질 수 있다
• localPosition은 부모의 transform에 상대적 위치 정보
• GetComponentXXX<T> 함수들을 잘 이용하면 객체들을 찾기가 쉬워진다.
• RectTransform - http://docs.unity3d.com/ScriptReference/RectTransform.html
• 주로 UI를 위해 사용 됨(아마도..)
• 위치, 사이즈, 앵커, 피봇 관련 정보들을 담고 있음
• sizeDelta : RectTransform의 앵커 기준 상대적 사이즈. 만일 앵커가 붙어 있다면 sizeDelta는 size와 동일하다. 만일 앵커가 부모의 각 네 코너에 맞춰져 있다면 sizeDelta는 부모의 사각형 대비 얼마나 크거나 작은지를 나타낸다.
• rect : eg. rectTransform.rect.height 으로 RectTransform 객체의 높이를 가져 올 수 있다
• Gizmo : Gizmos are used to give visual debugging or setup aids in the scene view
• http://docs.unity3d.com/ScriptReference/Gizmos.html
• http://docs.unity3d.com/ScriptReference/MonoBehaviour.OnDrawGizmos.html
• 애니메이션 종료 여부 알아 내기 - http://kukuta.tistory.com/181
• svn 
• 무시 되도 될 디렉토리/파일 리스트 : http://answers.unity3d.com/questions/22604/which-unity-project-files-can-be-ignored-for-versi.html
• http://docs.unity3d.com/Manual/ExternalVersionControlSystemSupport.html
• Help with access/write files on Android : http://forum.unity3d.com/threads/help-with-access-write-files-on-android.72819/
• 4.6 UI Text rect does not expand automatically
• http://answers.unity3d.com/questions/789561/46-ui-text-rect-does-not-expand-automatically.html
• http://docs.unity3d.com/Manual/BuildingAssetBundles5x.html
• 유니티의 입력 값은 스크린 좌표 값인데 게임월드 상의 오브젝트를 다루려면 월드 좌표를 사용해야 한다. 이를 위해서 유니티에서는 ScreenToWorldPoint(http://docs.unity3d.com/ScriptReference/Camera.ScreenToWorldPoint.html) 함수를 제공한다.Event.current.mousePosition은 화면의 좌하단이 (0, 0)이다. 터치 입력과 같은 좌표계(화면 좌 상단이 0, 0)를 사용하는 Input.mousePosition(http://docs.unity3d.com/ScriptReference/Input-mousePosition.html)을 사용하자.
• BoxCollider 를 설정하고 IsTrigger 옵션을 선택하면 OnCollisionXXX 대신 OnTriggerXXX 함수가 호출 된다. IsTrigger 셋팅이 되어있다면 오브젝트간 물리적 상호 작용은 없고 서로 겹칠때 알림만 온다.
• saving and loading player game data in unity 
• http://www.sitepoint.com/saving-and-loading-player-game-data-in-unity/
• http://gamedevelopment.tutsplus.com/tutorials/how-to-save-and-load-your-players-progress-in-unity--cms-20934
• Dictionary 시리얼라이즈 : http://answers.unity3d.com/questions/460727/how-to-serialize-dictionary-with-unity-serializati.html
• content size fitter : 부모 객체의 rect를 자식 객체들에 맞춰서 변경 시켜주는 역할. 하지만 자식에 Vertical Layout 혹은 Horizon Layout 같은 Layout이 붙어야 한다. 텍스트 같은 경우는 아마도 예외인것 같다.
• JsonUtility - http://docs.unity3d.com/ScriptReference/JsonUtility.html
• 스크립트 직렬화 - http://docs.unity3d.com/kr/current/Manual/script-Serialization.html
• Application.OpenURL - https://docs.unity3d.com/kr/current/ScriptReference/Application.OpenURL.html
• AudioListener.volumn - https://docs.unity3d.com/ScriptReference/AudioListener-volume.html

스프라이트 객체를 AssetBundle로 만들고 난뒤 AssetBundle을 통해 스프라이트 객체로 로드를 했는데 로드를 하지 못하고 null을 리턴하는 현상이 발생했습니다. Unity 4.3 버젼에서는 스프라이트는 어셋번들로 만들면서 데이터가 떨어져 나가고 텍스쳐로 로드해서 스프라이트로 변환 해야 한다고하는 군요.

그래서 텍스쳐를 스프라이트로 변경하는 방법에 대해서 살짝 짚고 넘어가보도록 하겠습니다.

참 쉽죠?ㅋ

추가 : Sprite Packer를 이용해 패킹한 sprite는 asset bundle을 통해서도 정상적으로 로드 되었다.

1. 유니티 에디터에서 어셋번들에 포함될 어셋들을 지정
2. 어셋번들 빌드
3. 외부 저장소에 어셋번들을 업로드
4. 어플리케이션에서 어셋번들을 다운로드
5. 어플리케이션에서 어셋번들을 로드

어셋번들 매니저를 이용하면 위 과정중 1번. 어셋번들에 포함될 어셋들을 지정하는 작업외에는 모든 부분을 어셋번들 매니저에게 맡길수 있습니다.

• 'Asset Bundle Name'은 동일해야 합니다
• 유일하게 달라야 할 부분은 Asset Bundle Variant 부분 입니다.

• 어셋번들 베리언트를 이용한 어셋번들간에 호환성을 가지려면 어셋번들에 포함 되는 컨텐츠의 폴더와 모든 어셋들은 같은 이름과 같은 계층구조를 가져야 합니다.

애니메이션이 플레이 중인지 종료가 되었는지는 다음과 같은 체크 코드를 사용하면 간단하게 알아 볼수 있다.

animator.GetCurrentAnimatorStateInfo(0).IsName("YourAnimationName")

"YourAnimationName" : 메카님 스테이트의 이름(Animator 윈도우를 보면 여러 상태가 있는데 체크하고 싶은 애니메이션이 플레이되는 상태의 이름을 적어주면 된다).

위 함수를 작성하고 StartCoroutine() 함수를 이용해 호출 해주면 애니메이션 재생이 끝나면 해당 오브젝트가 삭제 된다.

출처 : http://answers.unity3d.com/questions/362629/how-can-i-check-if-an-animation-is-being-played-or.html

위의 방식이 정상 동작하지 않았다. 그래서 아래와 같이 IsInTransition함수를 이용하여 애니메이션 종료 여부를 알아 내도록 한다.

단 위와 같은 방법을 사용하기 위해서는 메카님에서 상태 변화(Transition)를 시켜 줘야한다.

현상 : GameObject의 AddComponent를 호출 했는데, 맥에서는 아무런 문제 없이 동작했지만 윈도우에서 작업 할 때는 null을 리턴 한다.

원인 : MonoBehaviour 를 상속 받은 아주 작은 역할을 하는 클래스를(이하 A 클래스) 새로운 파일을 만들지 않고 기존 클래스의(이하 B 클래스) 내부에 작성하였는데 이런 경우 윈도우에서는 AddComponent 시 null을 리턴한다.

해결 : A 클래스와 이름이 같은 신규 파일을 생성

참조 : http://forum.unity3d.com/threads/gameobject-addcomponent-is-returning-null.68201/

사족 : 유니티에서 MonoBehaviour를 상속받은 클래스는 new 로 생성할 수 없고 GameObject에 AddComponent를 통해서만 생성 할 수 있단다. 

이번 포스팅은 Facebook Unity SDK(https://developers.facebook.com/)를 이용하여 Unity와 facebook을 연동하는 방법에 대해서 다룹니다. 예제 코드는 facebook sdk 패키지를 import하면 만들어지는 Examples/InteractiveConsole이 깔끔하고 쉽게 나와있으므로 그것을 보시는 것이 좋습니다. 

본 포스팅에서는 InteractiveConsole 예제를 실행하면서 겪었던 환경 셋팅 문제를 주로 다룹니다. 현재 안드로이드 버젼마 다루고 있으며 ios의 경우에는 해당 작업을 하게 되면 추가하도록 하겠습니다.

준비 작업 :

• Java SDK(ver 1.7) : : facebook 앱 인증에 필요한 key hash를 생성하는데 사용됩니다.
• OpenSSL(dowload) : facebook key hash를 생성과 안드로이드 빌드 위해 필요 합니다.
• Java SDK와 OpenSSL의 경우에는 설치를 하고 환경 변수 PATH에 bin 디렉토리의 경로를 등록합니다.
• Unity 3D(ver. 4.3.4f) : http://unity3d.com/ 에서 다운 받으시면 됩니다. 자세한 설명은 생략합니다.
• Facebook Unity SDK(ver 4.3.6) : https://developers.facebook.com/docs/unity/downloads/ 에서 다운 받으시면 됩니라. 링크가 변경 되었더라도 충분히 검색을 통해 찾으실수 있으리라 믿습니다.
• 혹시나 몰라 버젼을 기록해 두었습니다. 뭔가 이상하게 돌아간다면 버젼을 확인해보시고 버젼이 상이하고 이 문서가 더 이상 도움이 되지 않는다고 생각 되시면 kukuta@gmail.com으로 메일 주십시오.

Overview : 

  우리가 하게 될 작업에 대해 간단하게 알아 보겠습니다.

1. 일단 Unity가 설치되어 있어야 합니다.
2. Facebook Unity SDK를 Unity 프로젝트에 import 합니다. 
3. Facebook app을 만듭니다.
4. Unity에서 Build Setting과 Facebook 연동.
5. 빌드해서 스마트 폰에 올려 봅니다.
6. 테스트 합니다.
7. 문제를 발견 합니다..고칩니다..빌드해서 스마트 폰에 올려 봅니다..테스트 합니다..문제르..쿨럭..

step 1. Unity 설치

• 알아서들 설치 합니다. 이 포스트를 볼 정도면 Unity 설치가 문제가 아니라고 생각 됩니다.

step 2. Facebook Unity SDK Download & Import

• https://developers.facebook.com/docs/unity/downloads/ 에서 SDK를 다운 받습니다.
• 페이지가 깨지거나 링크가 달라지더라도 검색을 통해 알아서 다운 받으실수 있다고 믿습니다.
• 다운로드 받고 custom import 하는 부분에 대해서도 설명을 생략합니다.
• SDK가 import 되고 나면 Unity 메뉴에 'Facebook'이 추가 됩니다.
• https://developers.facebook.com/docs/unity/getting-started/canvas 참조

step 3. Facebook 앱 만들기

• Facebook 앱 생성에 대한 설명 역시 생략합니다.
• 설정에 필요한 Package Name, Class Name, Key Hashes 항목은 Unity 셋팅을 통해 생성됩니다. 
• 본 포스팅 마지막 과정에서 위 세개 값을 Unity로 부터 생성하여 복사해서 넣도록 하겠습니다.

step 4. Unity와 Facebook 연동

1) App Name, App Id - "Invalid App Id"

• Unity 프로젝트 생성, Scene 생성 등에 대한 설명은 생략합니다.
• 'Facebook > Edit Settings' 메뉴를 클릭하면 Facebook Settings Inspector가 뜹니다.
• 'Facebook 앱'에서 App Name과 App Id 복사해 붙여 넣습니다.

2) 플랫폼 안드로이드로 변경

• 'File > Build Settings' 메뉴를 클릭, Platform=Android 변경, Switch Platform을 클릭하여 플랫폼을 변경합니다.

3) Package Name 지정

• 'Facebook > Edit Settings'에 보면 기본 Package Name이 (com.Company.ProductName) 셋팅 되어 있습니다.
• 'File > Build Settings > Player Settings 클릭 > Inspector 창 > Other Settings 메뉴 > Bundle Identifier'를 수정

• 'com.facebook.unity.FBUnityDeepLinkingActivity'
• 지정되어 있는대로 내비둡니다. 나중에 이걸 복사해서 facebook 엡에 붙여 넣을 겁니다.

5) Key Hash 생성

• 조심하십시오. 가장 많은 삽질이 여기서 일어납니다!!!
• "your android debug keystorefile is missing! you can create new one by creating and build empty android project in eclipse" 가 디스플레이 되고 있다면 아직은 정상입니다. 
• key hash를 먼저 생성해 주어야 합니다. 그러기 위해서는 Java SDK 에 들어 있는 keytool과 OpenSSL이 필요 합니다. (혹시 아직 설치하지 않았다면 Java SDK와  OpenSSL을 설치하시고 환경 변수(PATH)에 bin 디렉토리를 등록하신 다음 여기로 돌아 오시기 바랍니다)
• 커맨드 창을 열어 다음과 같이 입력 합니다 :

• '-genkey' : 키를 생성하라는 옵션입니다.
  Facebook 가이드 문서를 보면 -exportcert 옵션을 사용하는데, 이 옵션의 경우 파일이 없는 경우 새로 생성 해내지 않습니다. 하지만 우리는 대부분 처음 작업하는 사람인지라 기존 파일이 없겠지요.
• '-alias' : 뭔지 잘 모르겠습니다. 그냥 androiddebugkey라고 적어 줍니다.
• '-keystore' : key가 저장될 위치와 이름을 지정합니다.
  상대 경로도 가능한지 모르겠습니다. 지정된 디렉토리가 없는 경우 새로 생성하지 않고 실패 합니다. 디렉토리는 미리 생성 되어 있어야 합니다.
• 나머지는 그냥 그대로 따라 쓰면 됩니다.

• 정상적인 상황이라면 패스워드를 물어 옵니다. "android" 를 입력 합니다. 그 외에 질문하는 것들은 모두 엔터로 넘겨 버리고 맨 마지막 질문에 "yes(한글 버젼이면 예)"를 타이핑합니다. 이렇게 되면 key hash 생성에 성공 입니다.(따옴표는 입력하지 않습니다. 만일 패스워드를 묻지 않는다면 뭔가 잘못 된 것입니다.)

6) 'File > Build Settings > Player Settings 클릭 > Inspector 창 > Publishing Settings

• Use Existing Keystore 체크
• Browse Keystore클릭 하고 이전에 생성해놓은 debug.keystore 위치를 찾아 선택
• Keystore password에 "android" 입력
• Alias 에서 androiddebukey 선택
• Password "android" 

• 위와 같이 셋팅하고 다시 'Facebook > Edit Settings' 메뉴로 돌아가면 Package Name, Class Name, Debug Android Key Hash가 모두 반영 되어있습니다.
• ..라고 하고 싶지만 여전히 "your android debug keystorefile is missing! you can create new one by creating and build empty android project in eclipse" 메시지가 나오고 있을 겁니다.
• Facebook SDK의 윈도우쪽 버그로써 아래 Trouble Shooting에서 다루겠습니다.

7) Unity로 부터 Package Name, Class Name, Key Hash를 복사 & 붙여 넣기를 하고 저장

• 'Facebook > Edit Settings'
• 
• Package Name, Class Name, Key Hash를 페이스 북에 복사 & 붙여 넣기
• 로그인 테스트를 하는데 개발자만 로그인이 되고 다른 사람들이 로그인 되지 않는 경우는 아래 Trouble Shooting 항목을 참고 하세요.

step 5. Build & Run on Device

• Facebook SDK 4.3버젼에서는 PC에서 로그인 테스트를 하는 경우 무조건 성공을 떨어뜨리는 버그가 있다. 제대로된 테스트를 위해서는 꼭 장치에 올려서 테스트 해보도록 한다.

step 6. Trouble Shooting :

• "your android debug keystorefile is missing! you can create new one by creating and build empty android project in eclipse"
• key hash 파일이 생성되지 않았거나, 지정된 위치에 없으면 발생하는 에러 메시지 입니다.
• key hash 파일을 생성했고, 해당 파일이 지정된 디렉토리에 있는데도 불구하고 위 메시지가 발생 되는 경우원인은 Facebook Unity SDK 의 버그로써 SDK에서는 key hash 파일을 특정 위치에만 놓고 사용하도록 코드가 만들어져 있습니다(윈도우의 경우에는 "C:/Users/<계정>/.android/debug.keystore", 리눅스 or 맥의 경우에는 ~/.android/debug.keystore). 그런데 윈도우의 경우에는 앞에 "C:/" 부분이 빠져 있기 때문에 SDK 코드를 직접 수정해야만 합니다(http://answers.unity3d.com/questions/596752/android-debug-keystore-file-is-missing.html) :

// File : Facebook/Editor/android/FacebookAndroidUtil.cs private static string DebugKeyStorePath { get { return Application.dataPath + @"/../Facebook/debug.keystore"; /* return (Application.platform == RuntimePlatform.WindowsEditor) ? System.Environment.GetEnvironmentVariable("HOMEPATH") + @"\.android\debug.keystore" : System.Environment.GetFolderPath(System.Environment.SpecialFolder.Personal) + @"/.android/debug.keystore"; */ } }

• 저 같은 경우 Unity 프로젝트 내에 Facebook이라는 디렉토리를 만들고 그 안에 debug.keystore 파일을 저장했습니다만..각자 편한대로 수정해서 사용하시면 될듯 합니다.

• "openssl not found. make sure that openssl is installed and that it is in your path"
• open ssl이 PATH 환경 변수에 제대로 등록 되지 않은 것입니다. 등록하시고 unity를 재시작 합니다.
• 개발자만 로그인이 되고 다른 사람 계정은 로그인이 되지 않아요!
• Facebook 앱을 공개로 변경하지 않으면 앱 개발자만 로그인 할수 있습니다. Status & Review 설정에서 앱을 공개로 변경하거나 테스트 사용자를 등록하여 로그인하셔야 합니다.