> For the complete documentation index, see [llms.txt](https://onestore-dev.gitbook.io/dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://onestore-dev.gitbook.io/dev/tools/play.md).

# 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="/files/LyLQcXoCL6VMsEN4dBXw" alt=""><figcaption></figcaption></figure>
2. \[성장 > Play 게임즈 서비스 > 설정 및 관리 > 설정] 메뉴를 클릭합니다.
3. \[사용자 인증 정보]섹션에서 \[사용자 인증 정보 추가]를 클릭합니다.
4. \[사용자 인증 정보 추가]화면의 \[OAuth 클라이언트]섹션에서 OAuth 클라이언트 ID를 선택한 후 \[변경사항 저장]을 클릭합니다.

   <figure><img src="/files/Dyk1iThGCCUaSHcQXa86" alt=""><figcaption></figcaption></figure>

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

       <figure><img src="/files/vvsOj7wTQnPa1aKPrOKG" alt=""><figcaption></figcaption></figure>
     * Google Cloud Platform의 \[OAuth 클라이언트 ID 만들기]에 내용을 입력한 후 \[만들기]를 클릭합니다.

       <figure><img src="/files/bqaKjs6rh7vgs5oD1G1e" alt=""><figcaption></figcaption></figure>
     * \[Google Cloud Platform  > 사용자 인증 정보]에서 생성된 OAuth 클라이언트 ID를 확인할 수 있습니다.

       <figure><img src="/files/30kxzkKQ5XhcVYnqHZp7" 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="/files/jxLdS3xjkdNylzyDx6NO" alt=""><figcaption></figcaption></figure>
2. 상단 영역에서 2개의 앱이 모두 등록되어 있는 것을 확인할 수 있습니다.

   <figure><img src="/files/BlhYrAQqFD4HF0oPqxVA" alt=""><figcaption></figcaption></figure>
3. \[프로젝트 개요] 옆의 \[설정]아이콘을 클릭한 후 \[프로젝트 설정]을 클릭합니다.
4. \[일반]탭의 \[내 앱]섹션에 2개의 앱이 모두 등록되어 있는 것을 확인할 수 있습니다.

   <figure><img src="/files/ICAibMFOjW8iaDZj6yRm" alt=""><figcaption></figcaption></figure>

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

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

   <figure><img src="/files/o5NnoAQL76mzvHrGU0lp" alt=""><figcaption></figcaption></figure>
2. Gradle > app > Tasks > build > assemble을 확인합니다.

   <figure><img src="/files/9TLt3DitgGxDs8H3klLa" alt=""><figcaption></figcaption></figure>
3. release의 apk를 각각의 스토어에 등록합니다.