게임을 Google Play 게임즈 서비스와 통합하려면 먼저 플랫폼 인증을 구현하세요. 업적, 리더보드, 이벤트와 같은 다른 모든 기능에 액세스하려면 이 권한이 필요합니다.
Google Play 게임즈 Level Up 사용자 환경 가이드라인을 충족하려면 게임이 권장 인증 흐름을 준수해야 합니다.
초기화 및 인증
게임 초기화 및 인증에 필요한 단계는 다음과 같습니다.
- 시작 시 Play 게임즈 서비스 v2 SDK를 초기화하여 플랫폼 인증을 구현합니다. 자세한 내용은 Android 게임의 플랫폼 인증을 참고하세요. 업적, 리더보드와 같은 Play 게임즈 서비스 기능에 액세스하려면 이 단계를 완료해야 합니다.
- 인증은 게임 실행 중에 자동 백그라운드 프로세스로 실행됩니다.
기존 Play 게임 서비스 사용자는 인증에 성공하면 환영 메시지가 표시됩니다.
프로필 만들기
플레이어가 플랫폼을 이용하려면 Play 게임즈 서비스 프로필이 필요합니다. 일부 플레이어는 게임을 시작할 때 Play 게임즈 서비스 프로필이 없을 수 있습니다. 이러한 플레이어에게는 계정을 만들라는 메시지가 표시됩니다.
자동으로 트리거되는 프로필 생성 메시지는 Play 게임즈 서비스 프로필 없이 게임을 실행할 때 기본적으로 자동으로 표시됩니다.
권장 인증 흐름
Google Play 게임즈 Level Up 사용자 환경 가이드라인을 충족하려면 플레이어 연속성 요구사항을 준수하는지 확인하세요. 플레이어가 게임에 로그인하도록 하려면 다음 인증 흐름을 이용합니다.
- 게임의 시작 시퀀스 중에 자동 트리거되는 프로필 생성을 구현합니다.
- 자동 인증이 실패하거나 거부하는 경우 나중에 인증할 수 있도록 수동 로그인 버튼을 표시합니다.
플레이어 ID
플레이어 ID는 Play 게임즈 서비스 플레이어 계정의 식별자입니다. 게임은 Play 게임즈 서비스 인증을 사용하여 게임에 로그인하는 플레이어의 플레이어 ID를 검색할 수 있습니다. 게임 클라이언트 통합, 게임 서버 통합, 클라우드 저장 서비스는 ID를 사용하여 Play 게임즈 서비스의 플레이어 데이터에 안전하게 액세스할 수 있습니다.
사용자 ID는 사용자가 여러 기기에서 게임을 플레이할 때 일관됩니다. 하지만 게임 간에 항상 일관적이지는 않습니다. 자세한 내용은 차세대 플레이어 ID를 참고하세요.
OAuth 범위
Play 게임즈 서비스는 OAuth 시스템을 사용하고, 이를 통해 플레이어는 자신의 계정에 대한 액세스 권한을 게임에 부여할 수 있습니다. Play 게임즈 서비스는 게임에 관한 고유한 범위(games-lite)를 가지며 게임에 저장된 게임 기능이 사용되는 경우에는 다른 범위(drive.appdata)를 사용합니다. 저장된 게임 기능을 사용하면 게임 데이터가 저장되는 사용자의 Google Drive 계정에 액세스할 수 있습니다.
Play 게임즈 서비스 v2 SDK를 사용하는 경우 추가 OAuth 범위를 요청할 수 있습니다.
추가 OAuth 범위가 필요한 경우 requestServerSideAccess를 호출하는 것이 좋습니다.
자세한 내용은 서버 인증 코드 가져오기 또는 서버 인증 코드 검색을 참고하세요.
여러 인증 서비스
Play 게임즈 서비스는 Android 플레이어를 위한 게임 ID를 제공하지만, 그 ID가 사용자에게 연결된 유일한 ID일 필요는 없습니다. 개발자는 Play 게임즈 서비스, 소셜 네트워크 ID, 자체 게임 내 ID 시스템을 동시에 모두 사용하여 플레이어를 인증할 수 있습니다.
Recall API
Recall API를 사용하면 게임에서 Google 서버에 리콜 토큰을 저장하여 PGS 사용자와 게임 내 계정 간의 링크를 관리할 수 있습니다. 이 기능을 사용 설정하는 방법을 자세히 알아보려면 게임 내에서 PGS Recall API 통합을 참고하세요.
게임 클라이언트 통합
게임 프로젝트에 인증을 통합할 때는 다음 사용자 플로우를 사용하는 것이 좋습니다.
게임의 시작 시퀀스 중에 프로필 생성이 실행되고 사용자 인증 또는 새 계정 생성이 시도됩니다.
자동 인증이 실패하거나 거부하는 경우 나중에 인증할 수 있도록 수동 로그인 버튼을 표시합니다.
게임 프로젝트에 인증을 통합하는 방법에 관한 자세한 내용은 프로젝트 유형 관련 문서를 참고하세요.
게임 서버 통합
플레이어가 인증되었는지 확인한 후 requestServerSideAccess를 호출하여 서버 승인 코드를 가져올 수 있습니다. 이 서버 승인 코드를 백엔드 게임 서버에 전달하여 Play 게임즈 서비스 서버와 직접 통신합니다. 이 통신을 통해 서버는 다음을 비롯한 플레이어 데이터에 액세스할 수 있습니다.
- 플레이어 ID
- 프로필
- 친구 목록
- 게임 진행 상황
- 업적
그러면 서버가 이 승인 코드를 REST API와 함께 사용하여 Play 게임즈 서비스 서버와 안전하게 상호작용합니다. 자세한 내용은 Play 게임즈 서비스에 대한 서버 측 액세스를 참고하세요.
로그인 요청 할당량
Play 게임즈 서비스에는 로그인 요청의 일일 할당량이 있습니다. 자세한 내용은 일일 할당량 관리를 참고하세요.