매번 구글 플레이 서비스를 유니티에 연동할 때 단번에 성공한 적이 없는거 같네요... 시간낭비가 커서 이번에 파이어 베이스를 연동하며 같이 기록을 남기고자 합니다.
애초에 이런 기록을 남기는게 블로그 시작의 이유였는데... 이제서야 하다니....
여기서는 구글 플레이 서비스 인증과 파이어 베이스 인증, 데이터 베이스 연동까지 진행하는 플로우와 발생했던 이슈들에 대해 포스팅하겠습니다.
우선 환경은 아래와 같습니다.
- Unity 2017.4.1f1
- GooglePlayGamesPlugin-0.9.50
- firebase_unity_sdk_4.5.2
1. 구글 플레이 서비스 와 파이어 베이스 환경설정
- Google Play Console
- 구글 콘솔에 새 프로젝트 생성.
- 해당 프로젝트의 패키지로 서명된 앱을 샘플앱으로 우선 등록.
- 패키지 등록 및 SHA-1 값을 편하게 보기 위해 ㅎㅎ ( KeyTool로 해도 되지만 개인적으로 이게 편합니다.)
- Console에 게임 서비스에 프로젝트 등록.
- 플레이 콘솔에서 등록했던 프로젝트를 게임서비스에 등록. (Android)
- 파이어 베이스에서 인증에 사용하기위해 웹 어플리케이션으로도 등록.
- 웹 어플리케이션에 등록하는 실행 URL은 파이어베이스의 URL을 사용.
- ex) myproject.firebaseapp.com
- 위의 url은 설정의 google-services.json에서도 확인할 수 있고, 웹설정에서도 확인 가능, Authentication의 로그인 방법에 승인된 도메인에서 확인가능.
- FireBase 프로젝트 등록.
- 생성시 위의 프로젝트에 연동을 하거나, 생성 후 설정에서 안드로이드 앱을 등록하여 연동.
- SHA 인증서 지문 = GooglePlayConsole에서 앱로드 증명서의 SHA-1 값
- Authentication 의 로그인 방법에 Play 게임 사용으로 설정.
- 이때 등록하는 클라이언트 ID와 보안 비밀은 아래 API console에서 웹 애플리케이션의 클라이언트 ID에서 구할 수 있습니다.
- 반드시 웹 애플리케이션의 클라이언트 ID와 비번이여야 합니다. 웹을 통해서 인증을 받아오기 때문에
- API Console 설정. ( https://console.developers.google.com/)
- API는 이미 위에서 FireBase와 게임서비스가 연동되면서 클라이언트 ID들이 만들어져있습니다.
- Android 클라이언트 ID 서명 인증서 지문 확인.
- 이번에도 앱로드 증명서의 SHA-1 값을 등록합니다.
- Unity 환경 설정.
- Window - GooglePlayGames - Setup - Android Setup
- Resource Definition 과 web App client ID 등록.
- 리소스 정의는 게임 서비스의 리더보드나 업적에서 리소스 받기로 받을 수 있음. 만약에 두가지를 안쓴다면 밑의 기본 리소스로 등록.
- WebAppClientID는 게임서비스에 등록된 웹 어플리케이션 ID 등록.
- FireBase 프로젝트의 설정으로 들어가 google-services.json을 다운받아 유니티 프로젝트 내에 넣는다.
2. GooglePlayService 인증 연동하기 (코드)
public void activePlayGame()
{
PlayGamesClientConfiguration config = new PlayGamesClientConfiguration.Builder()
.RequestServerAuthCode(false)
.Build();
PlayGamesPlatform.InitializeInstance(config);
// recommended for debugging:
PlayGamesPlatform.DebugLogEnabled = true;
// Activate the Google Play Games platform
PlayGamesPlatform.Activate();
}
public void googleLogin()
{
Social.localUser.Authenticate((success, errorMessage) =>
{
if (success)
{
authCode = PlayGamesPlatform.Instance.GetServerAuthCode();
}
else
{
Debug.Log("google " + errorMessage);
}
Debug.Log("google " + success);
});
}
public void googleLogout()
{
PlayGamesPlatform.Instance.SignOut();
}
2. 파이어 베이스 인증 연동하기. (코드)
- 공식 문서의 예제 코드를 거의 임용한 코드.
- 사용 전에는 반드시 connectFirebase를 먼저 호출.
public void connectFirebase(string _authCode)
{
FirebaseAuth auth = Firebase.Auth.FirebaseAuth.DefaultInstance;
Firebase.Auth.Credential credential =
Firebase.Auth.PlayGamesAuthProvider.GetCredential(_authCode);
auth.SignInWithCredentialAsync(credential).ContinueWith(task => {
if (task.IsCanceled)
{
Debug.LogError("SignInWithCredentialAsync was canceled.");
return;
}
if (task.IsFaulted)
{
Debug.LogError("SignInWithCredentialAsync encountered an error: " + task.Exception);
return;
}
Firebase.Auth.FirebaseUser newUser = task.Result;
Debug.LogFormat("User signed in successfully: {0} ({1})",
newUser.DisplayName, newUser.UserId);
});
}
public string getFirebaseUser()
{
Firebase.Auth.FirebaseUser user = auth.CurrentUser;
string uid = null;
if (user != null)
{
uid = user.UserId;
}
return uid;
}
public void firebaseLogout()
{
FirebaseAuth.DefaultInstance.SignOut();
}
3. 파이어 베이스 데이터 베이스(실시간) 연동하기. (코드)
- 공식 문서의 예저코드를 거의 임용한 코드 ( 델리게이트 제외)
- 반드시 connectDatabase를 먼저 호출
public delegate void DelGetDB(object data);
DatabaseReference reference;
public void connectDatabase()
{
// Set up the Editor before calling into the realtime database.
FirebaseApp.DefaultInstance.SetEditorDatabaseUrl("https://myproject.firebaseio.com/");
// Get the root reference location of the database.
reference = FirebaseDatabase.DefaultInstance.RootReference;
}
public void FuncGetDB(object _data)
{
Debug.Log("SUCESS " + _data.ToString());
}
public void setData(string _userId, string _dataName,int _value)
{
reference.Child("users").Child(_userId).Child(_dataName).SetValueAsync(_value);
}
public void getData(string _userId, string _dataName, DelGetDB _funcDB)
{
reference.Child("users").Child(_userId).Child(_dataName).GetValueAsync().ContinueWith(task => {
if (task.IsCompleted)
{
DataSnapshot snapshot = task.Result;
_funcDB(snapshot.Value);
}
else if (task.IsFaulted)
{
// Handle the error...
Debug.Log("getData fail ");
}else
{
Debug.Log("getData cancel ");
}
});
}
* 발생 오류들과 해결과정
- 저한테는 요게 이 포스팅의 핵심입니다 ㅎㅎ
1) duplicate files copied in APK ~~~ (빌드 에러)
- 사실 이전에 다른 프로젝트하면서 구글 플레이 서비스 인증을 사용했던 적이 있던터라...패키지들을 한꺼번에 추가했다가 발생했던 오류입니다.
- 원인 - 패키지 임포트 간의 다른 폴더에 중복된 파일 추가로 추정.
- 해결 - GooglePlayGamesPlugin-0.9.46 에서의 버그로, 0.9.50에서 수정되었다하여 버전 업 후 전체 패키지 파일 제거하여 차례로 다시 import
2) 구글 플레이 게임 로그인 시도시 Authentication fail 발생.
- 솔직히 구글은 인증 실패시 원인같은거 안알려주고 error 코드로 Authentication fail로 알려줘서 이 부분은 원인과 해결방안이 굉장히 많겠지만... (Android Native로 개발해도 error code 하나 툭 던져주고 끝이라 고생했던 기억이...ㅠ)
- 원인 - API 서비스의 Android Client ID의 서명 인증서가 앱 서명 인증서로 되어있었음.
- 해결 - 업로드 인증서의 SHA-1 값으로 변경.
3) 구글 플레이 게임 로그인 시도시 Authentication fail 발생.
- 네 위랑 똑같에요... 하지만 위와 상황은 달랐습니다.
- 위는 순전히 구글 게임 인증만 시도했을 때고, 3)은 FireBase에서 사용하기 위한 AuthCode를 요청하는 코드를 추가했을 때 발생한 문제입니다. RequestServerAuthCode <- 요거
- 원인 - Window - GooglePlayGames - Setup - Android Setup 의 웹 어플리케이션 ID에 오타가....
- 해결 - 오타 수정.
4) FireBase 연동이 동작하지 않음
- 원인 - 1)을 해결하며 가이드대로 Unity프로젝트에 넣었던 google-service.json을 같이 제거하고 다시 넣지 않음.
- 해결 - 다시 추가.
5) DB에서 데이터를 가져올 때 제대로 데이터를 가져오지 못함.
- 원인 - 가이드 그대로 코드했다가 별도 thread라는 걸 인지 못함. 지역 변수를 다른 스레드로 도는 함수내에서 조작하려 해서 발생.
- 해결 - 델리게이트를 콜백 함수로 넘겨서 실행.
6) 리더보드 호출시 동작하지 않음
- 상세 - 로그인과 리더보드 진입은 되나, 리더보드의 상세 등수를 보려하면 꺼짐.
- 에러 코드 - There is no linked app associated with this client ID.
- 원인 - 구글 콘솔 서비스(연결된 앱)의 안드로이드 클라이언트 ID와 API 서비스의 안드로이드 클라이언트 ID가 다름 ( 유니티에 ClientID를 잘못 등록해서 발생한걸로 추정)
- 해결 - 콘솔 서비스의 연결된 앱에 새로 안드로이드를 등록하면 자동으로 API 서비스에 생성되니, 삭제 후 새로 생성.
