# Play 게임즈 서비스 연동 가이드

구글 'Play 게임즈  서비스'의 업적 및 리더보드 등을  원스토어 앱과 연동할 수 있습니다. 연동을 위해서는 'Play 게임즈 서비스'의 게임 프로젝트에 '사용자 인증 정보'를 추가해야 합니다.

* Google Play와 원스토어의 패키지 네임이 달라도 Play 게임즈 서비스는 동일하게 연동 가능합니다.<br>

### Play 게임즈 서비스 (Google Play Games Services) 설정하기 <a href="#id-googleplayservice-playservice" id="id-googleplayservice-playservice"></a>

<https://play.google.com/console>에 접속 후 아래 절차에 따라 설정을 진행할 수 있으며, 좀 더 상세한 내용은 [여기](https://developers.google.com/games/services/console/enabling?hl=ko)를 클릭해 주세요.

1. \[모든  앱]  메뉴에서 연동을 원하는 앱을 클릭합니다.

   <figure><img src="https://1837360763-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fot0z57AnnXZ02C5qyePV%2Fuploads%2FToRBXv2hVOuKLcBKzXsk%2Fimage.png?alt=media&#x26;token=7dbb358e-8c38-4a29-8b34-1472e774326e" alt=""><figcaption></figcaption></figure>
2. \[성장 > Play 게임즈 서비스 > 설정 및 관리 > 설정] 메뉴를 클릭합니다.
3. \[사용자 인증 정보]섹션에서 \[사용자 인증 정보 추가]를 클릭합니다.
4. \[사용자 인증 정보 추가]화면의 \[OAuth 클라이언트]섹션에서 OAuth 클라이언트 ID를 선택한 후 \[변경사항 저장]을 클릭합니다.

   <figure><img src="https://1837360763-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fot0z57AnnXZ02C5qyePV%2Fuploads%2FY9RQ6ZWWUBPE9FBtkRVH%2Fimage.png?alt=media&#x26;token=8ec83fdc-a5e1-4c36-bc93-8378dbd74e8a" alt=""><figcaption></figcaption></figure>

   * OAuth 클라이언트 ID를 새로 만들어야 하는 경우
     * \[OAuth 클라이언트 만들기]를 클릭합니다.
     * 호출된 팝업의 Google Cloud Platform에서 OAuth 클라이언트 ID 만들기 위한 링크를 클릭합니다.

       <figure><img src="https://1837360763-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fot0z57AnnXZ02C5qyePV%2Fuploads%2FFGVzOP4N70sTuZ40x4Bf%2Fimage.png?alt=media&#x26;token=82d65636-e994-4269-bcd3-d816b3722002" alt=""><figcaption></figcaption></figure>
     * Google Cloud Platform의 \[OAuth 클라이언트 ID 만들기]에 내용을 입력한 후 \[만들기]를 클릭합니다.

       <figure><img src="https://1837360763-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fot0z57AnnXZ02C5qyePV%2Fuploads%2F2gImQ0VH0euaT1LqR5sy%2Fimage.png?alt=media&#x26;token=b8fefe5c-1a2c-471e-8fe5-b4e6c1a51fed" alt=""><figcaption></figcaption></figure>
     * \[Google Cloud Platform  > 사용자 인증 정보]에서 생성된 OAuth 클라이언트 ID를 확인할 수 있습니다.

       <figure><img src="https://1837360763-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fot0z57AnnXZ02C5qyePV%2Fuploads%2FcVQ1cXceYgEnVLaDNNjO%2Fimage.png?alt=media&#x26;token=054737ac-4180-4ae0-aaee-35d415e51f9f" alt=""><figcaption></figcaption></figure>
     * \[성장 > Play 게임즈 서비스 > 설정 및 관리 > 설정]의 \[사용자 인증 정보 추가]화면에서 \[OAuth 클라이언트 새로고침]을 하면 생성된 OAuth 클라이언트 ID를 선택할 수 있습니다.
5. Google Play와 원스토어의 게임을 디바이스에서 실행하여 업적 및 리더보드 등이 공유되는지 확인합니다.

### Firebase 연동 여부 확인하기 <a href="#id-googleplayservice-firebase" id="id-googleplayservice-firebase"></a>

'Play 게임즈 서비스'를 설정했다면 Firebase는 자동으로 연동됩니다.\
<https://console.firebase.google.com>에 접속 후 아래 절차에 따라 연동 정보를 확인할 수 있습니다.

1. \[Firebase 프로젝트]에서 프로젝트를 클릭합니다.

   <figure><img src="https://1837360763-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fot0z57AnnXZ02C5qyePV%2Fuploads%2Fu92XD6ObctziDwKkcie2%2Fimage.png?alt=media&#x26;token=7f6a6074-d6b8-4eb4-bb48-b42e1bb6f5b0" alt=""><figcaption></figcaption></figure>
2. 상단 영역에서 2개의 앱이 모두 등록되어 있는 것을 확인할 수 있습니다.

   <figure><img src="https://1837360763-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fot0z57AnnXZ02C5qyePV%2Fuploads%2FAVpnmTqzykvU5wR9YNLI%2Fimage.png?alt=media&#x26;token=00c8b179-0f78-4be2-9c29-97f55e668e12" alt=""><figcaption></figcaption></figure>
3. \[프로젝트 개요] 옆의 \[설정]아이콘을 클릭한 후 \[프로젝트 설정]을 클릭합니다.
4. \[일반]탭의 \[내 앱]섹션에 2개의 앱이 모두 등록되어 있는 것을 확인할 수 있습니다.

   <figure><img src="https://1837360763-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fot0z57AnnXZ02C5qyePV%2Fuploads%2FilqCzdEdQYRyTQn3tg7C%2Fimage.png?alt=media&#x26;token=7f1d9c03-a008-463c-9cc2-8dbf491b7950" alt=""><figcaption></figcaption></figure>

### TIPS - 두 개의 패키지 네임으로 빌드하기 <a href="#id-googleplayservice-tips" id="id-googleplayservice-tips"></a>

1. build.gradle를 설정합니다.

   <figure><img src="https://1837360763-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fot0z57AnnXZ02C5qyePV%2Fuploads%2FKtiVWjWQG0L9CKBCoBpN%2Fimage.png?alt=media&#x26;token=b1ecd839-2783-408d-827d-72b3e479bfb1" alt=""><figcaption></figcaption></figure>
2. Gradle > app > Tasks > build > assemble을 확인합니다.

   <figure><img src="https://1837360763-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fot0z57AnnXZ02C5qyePV%2Fuploads%2FqZF78yPt6VZ1oYEeOn4t%2Fimage.png?alt=media&#x26;token=de8d0414-ceda-479a-af83-a6c55622641c" alt=""><figcaption></figcaption></figure>
3. release의 apk를 각각의 스토어에 등록합니다.