게임을 Google Play 게임즈 서비스와 통합하려면 먼저 플랫폼 인증을 구현하세요. 업적, 리더보드, 이벤트와 같은 다른 모든 기능에 액세스하려면 이 권한이 필요합니다.
Google Play 게임즈 Level Up 사용자 환경 가이드라인을 충족하려면 게임이 권장 인증 흐름을 준수해야 합니다.
초기화 및 인증
게임 초기화 및 인증에 필요한 단계는 다음과 같습니다.
- 시작 시 Play 게임즈 서비스 v2 SDK를 초기화하여 플랫폼 인증을 구현합니다. 자세한 내용은 Android 게임의 플랫폼 인증을 참고하세요. 업적, 리더보드와 같은 Play 게임즈 서비스 기능에 액세스하려면 이 단계를 완료해야 합니다.
- 인증은 게임 실행 중에 자동 백그라운드 프로세스로 실행됩니다.
기존 Play 게임 서비스 사용자는 인증에 성공하면 환영 메시지가 표시됩니다.
프로필 생성 옵션
플레이어가 플랫폼에 참여하려면 Play 게임즈 서비스 프로필이 필요합니다. 일부 플레이어는 게임을 시작할 때 Play 게임즈 서비스 프로필이 없을 수 있습니다. 이러한 플레이어에게는 계정을 만들라는 메시지가 표시됩니다.
다음 옵션 중 하나를 선택하여 사용자에게 적합한 환경을 결정할 수 있습니다.
자동 트리거 프로필 생성 메시지 Play 게임즈 서비스 프로필 없이 게임을 실행하면 기본적으로 프로필 생성 메시지가 자동으로 표시됩니다.
게임을 실행할 때 표시되는 프로필 생성 프롬프트 (확대하려면 클릭) 실행 시 프로필 생성 프롬프트 사용 중지 및 게임 초기화 후 수동 프롬프트 추가 매니페스트 파일을 통해 자동 트리거 프로필 생성 프롬프트를 사용 중지할 수 있습니다. 이를 통해 Play 게임즈 서비스 프로필이 없는 사용자는 Play 게임즈 서비스 프로필을 만들라는 메시지가 즉시 표시되지 않고 구현된 인증 방법을 진행할 수 있습니다.
사용자는 모든 ID 제공업체로 로그인할 수 있지만 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 게임즈 서비스에는 로그인 요청의 일일 할당량이 있습니다. 자세한 내용은 일일 할당량 관리를 참고하세요.