마이그레이션 개요

Google Play 게임즈 서비스, 게임즈 v1 SDK는 지원 중단되어 2025년에 Google Play 서비스 인증 SDK (com.google.android.gms:play-services-auth)에서 삭제될 Google Sign-In for Android를 사용합니다. 새 게임 앱은 2025년까지 게임즈 v1을 사용할 수 있습니다. Google 로그인 삭제로 인해 기존 게임 앱에 종속 항목 문제가 발생합니다. 기존 게임 앱을 게임즈 v1 SDK 에서 게임즈 v2 SDK 로 이전하면 Google 로그인 삭제로 인해 발생한 종속 항목 문제가 해결됩니다.

Google Play Games 서비스 v1에서 v2로의 이전은 개발을 간소화하고 크로스 플랫폼 게임을 지원하는 중요한 업데이트입니다. Google Play 게임즈 서비스 v2는 플랫폼과 게임 내 ID를 분리하여 실행 시 플레이어를 자동으로 인증하는 플랫폼 수준 ID 시스템 역할을 합니다. 이제 플랫폼 ID는 Google 계정으로 로그인 또는 독점 백엔드와 같은 도구를 사용하여 독립적으로 관리해야 하는 기본 게임 내 계정 시스템과 분리됩니다. Play 게임즈 서비스 v2 SDK 통합은 기존 온보딩 또는 로그인 흐름을 변경하지 않고 업적 및 리더보드와 같은 플랫폼 기능에 플레이어 ID를 사용합니다.

이 문서는 게임 애플리케이션과 다양한 SDK 간의 상호작용을 이해하는 데 도움이 됩니다. 공식 지원 중단 일정으로 인해 플레이어 연속성을 보장하려면 이 이전 가이드의 아키텍처 원칙, 경로, 플레이어 커뮤니케이션 전략을 따라야 합니다.

SDK 상호작용

다이어그램은 Android의 게임 애플리케이션, Google 모바일 서비스 (GMS) 코어, Play 게임즈 서비스, 서드 파티 (3P) 게임 서버 간의 상호작용을 보여줍니다. 애플리케이션이 Google 서비스를 사용하여 인증 및 게임 기능을 사용하는 동시에 별도의 서드 파티 시스템과 상호작용하는 방법을 강조합니다.

다음은 구성요소 및 SDK에 관한 간략한 개요입니다.

• 게임 애플리케이션.
  • Android 지원 기기에서 실행되는 사용자의 게임 애플리케이션을 나타냅니다.
  • 다음과 같은 두 가지 기본 구성요소가 포함되어 있습니다.
    • 게임즈 v1 또는 게임즈 v2 SDK. Play Games 서비스와 상호작용하는 클라이언트 측 SDK입니다.
    • 인증 SDK. Google Play 서비스 인증 SDK는 게임즈 v1에서 사용자 인증 및 승인 흐름을 처리합니다.
  • 두 SDK는 AIDL (Android 인터페이스 정의 언어)을 사용하여 통신하며, 이는 서로 다른 프로세스 또는 서비스 간의 통신 패턴을 나타냅니다.
• GMS 코어(Google Play 서비스라고도 함).
  • Android의 Google 독점 레이어입니다.
  • 게임 애플리케이션은 두 가지 GMS 코어 모듈을 사용합니다.
    • 게임 모듈. 리더보드, 업적, 게임 상태 관리와 같은 게임별 기능을 제공합니다.
    • 인증 모듈. 사용자 인증 및 승인 작업을 처리합니다.
  • 게임 애플리케이션의 게임 및 인증 SDK는 상응하는 모듈과 AIDL 인터페이스를 사용하여 통신하며, 이는 프로세스 간 통신 (IPC)을 나타냅니다.

• Play Games 서비스 게이트웨이.
  • GMS 코어와 Play Games 서비스 서버 간의 통신을 중재하는 논리적 게이트웨이입니다.
  • 서버 통신을 위한 API 요청, 데이터 변환, 인증을 처리합니다.
• Play Games 서비스 서버.
  • 게임 데이터 저장, 사용자 계정 관리, 멀티플레이어 기능을 지원하는 Play Games 서비스 백엔드 서비스를 나타냅니다.
• 서드 파티 게임 게이트웨이.
  • 게임 애플리케이션이 서드 파티 (3P) 애플리케이션으로 분류되는 경우 클라이언트 라이브러리는 서드 파티 게임 서버를 통해 Play 게임즈 서비스 서버와 통신합니다.
  • 애플리케이션이 다른 서비스 제공업체로 인증할 수도 있음을 의미합니다.
• 서드 파티 게임 서버.
  • 게임 애플리케이션이 상호작용할 수 있는 선택적 외부 서버를 나타내며, 맞춤 기능 또는 데이터 관리를 위한 것일 수 있습니다.
  • 애플리케이션과의 통신은 서드 파티 게임 게이트웨이를 통해 이루어집니다.

Play Games 서비스 v2로 게임을 이전해야 하는 이유

Play 게임즈 서비스 v1에서 v2로의 전환은 개발을 간소화하고 크로스 플랫폼 게임을 지원하는 주요 아키텍처 현대화입니다.

기본 게임 내 ID 시스템 역할을 한 v1과 달리 Play 게임즈 서비스 v2는 플랫폼과 게임 내 ID를 분리합니다. 실행 시 플레이어를 자동으로 인증하여 업적 및 리더보드와 같은 기능을 관리하는 플랫폼 수준 ID 시스템 역할을 합니다.

이제 Google 계정으로 로그인 또는 독점 백엔드와 같은 도구를 사용하여 게임의 기본 게임 내 계정 시스템을 독립적으로 관리해야 합니다. Play 게임즈 서비스 v2 SDK를 사용하면 게임에서 Play 게임즈 서비스 플레이어 ID를 사용하여 기존 온보딩 또는 로그인 흐름을 변경하지 않고 플랫폼 기능에 액세스할 수 있습니다. 이 문서는 아키텍처 원칙, 경로, 플레이어 커뮤니케이션 전략을 다루는 이전 과정을 안내합니다. 공식 지원 중단 일정을 고려할 때 준수가 중요합니다.

플랫폼 인증과 게임 내 인증 비교

Play 게임즈 서비스 v2에서 '로그인' 개념은 다음과 같은 두 가지 고유한 레이어로 분리됩니다.

• 플랫폼 ID. SDK는 플랫폼 인증을 처리합니다.
• 게임 내 ID.

플랫폼 인증

Play Games 서비스는 플랫폼 참여 레이어로만 작동합니다. 특정 게임 계정 또는 인벤토리에 인증하는 대신 Google Play 게임즈 생태계 (업적, 리더보드, 이벤트)와의 플레이어 관계를 관리합니다.

• 자동 및 자동: 게임이 실행될 때 백그라운드에서 인증이 자동으로 이루어집니다. Play 게임즈 서비스 자체에는 수동 '로그인' 버튼이 필요하지 않습니다.
• 플레이어 ID: 플랫폼 인증에 성공하면 Play 게임즈 서비스는 안정적인 플레이어 ID 를 제공합니다. 이 ID는 동일한 게임의 기기에서 일관되지만 주로 업적 진행률과 같은 플랫폼 통계를 추적하는 데 사용해야 합니다.
• 분리됨: Play 게임즈 서비스 v2는 게임 진행률 또는 인벤토리가 있는 플레이어의 게임 내 계정을 관리하는 게임의 기본 ID 시스템으로 사용해서는 안 됩니다. Play Games 서비스 v2는 엄격히 보조 영구 플랫폼 식별자 역할을 합니다.

게임 내 인증

개발자는 '게임 내 계정'(IGA) 관리를 담당합니다. 이는 게임 내에서 플레이어의 진행률, 인벤토리, 화폐를 바인딩하는 ID 시스템입니다.

• 기본 ID: 자체 백엔드, Google 계정으로 로그인(SiWG) 또는 기타 제공업체를 기본 로그인 방법으로 사용할 수 있습니다.
• 독립성: 플레이어는 특정 게임 내 계정에 로그인한 상태에서 Play 게임즈 서비스 (플랫폼 ID)에 로그인하여 업적을 획득할 수 있습니다. 예를 들어 게스트 계정 또는 특정 SiWG 계정입니다.
• 여러 게임 내 계정 관리: Play 게임즈 서비스는 게임 내 계정 (IGA)에 대한 플레이어의 기본 인증을 관리하는 게임과의 플랫폼 인증만 담당합니다. 즉, 플레이어가 게임 내 계정 간에 전환하는 방법에 관한 게임의 기존 흐름은 변경되지 않습니다. 플레이어가 이렇게 하는 동안 Play 게임즈 서비스를 사용하여 Play 게임즈 플랫폼에 계속 인증되고 영구 플레이어 ID에 대해 업적 및 기타 Play 게임즈 서비스 기능과 관련된 데이터가 계속 전송됩니다.

이전 요구사항: Play 게임즈 서비스 플레이어 ID 대신 Google Open ID로 게임 내 계정 바인딩

Play 게임즈 서비스 v1에서 개발자는 Play 게임즈 서비스를 기본 ID 제공업체로 사용했습니다. 'Google Play' 버튼은 플레이어의 게임 내 계정(IGA)을 Player ID에 직접 연결합니다.

Play 게임즈 서비스 v2는 실행 시 자동 자동 플랫폼 인증 을 제공하여 이를 변경합니다. 결과 Player ID는 이제 기본 계정 로그인과 별도로 리더보드 및 업적과 같은 플랫폼 기능에만 사용됩니다.

이제 게임은 'Google로 로그인'(SiWG) 또는 기타 소셜 계정과 같은 방법을 제공하는 전용 로그인 화면을 통해 기본 ID 를 독립적으로 관리해야 합니다. 중요한 점은 Play Games 서비스 v2를 기본 ID 시스템으로 사용해서는 안 된다 는 것입니다.

이러한 아키텍처 변경에는 개발자가 계정 데이터를 구성하는 방식에 상응하는 변경이 필요합니다. 게임 내 계정 (IGA)은 Player ID에 주로 바인딩되지 않도록 분리해야 합니다.

대신 이제 IGA는 Play 게임즈 서비스와 독립적인 안정적인 기본 식별자에 바인딩되어야 합니다. 권장되는 식별자는 Google 계정으로 로그인 (SiWG) 흐름에서 제공하는 Open ID입니다. 이 Open ID는 시스템 내에서 플레이어의 기본 계정에 대한 고유한 영구 키 역할을 합니다.

하지만 IGA는 보조 바인딩으로 Player ID에 여전히 연결될 수 있습니다. 이 보조 링크는 다음과 같은 두 가지 중요한 기능을 제공합니다.

1. 게임을 통해 특정 플레이어와 연결된 Play 게임즈 기능 (업적 등)의 진행률을 계속 추적하고 업데이트할 수 있습니다.
2. '원활한 복원' 기능을 사용 설정하여 게임에서 새 기기에서 또는 재설치 후에만 가장 최근에 사용한 IGA에 플레이어를 자동으로 로그인할 수 있습니다.

이 분리된 ID 모델을 이해하는 것이 게임의 올바른 기술 이전 경로를 여는 열쇠입니다.

기능 비교

이 표에서는 게임즈 v1과 게임즈 v2 SDK의 기능을 비교합니다.

기능	게임즈 v1 SDK	게임즈 v2 SDK
인증	play-services-auth와의 통합이 필요합니다.	간소화 및 간소화됨, play-services-auth가 필요하지 않음
승인	성공, 실패, 재시도를 위한 추가 코드	SDK에서 관리
서버 액세스 토큰	`GoogleSigninClient`를 사용하여 추가 OAuth 2.0 범위를 요청할 수 있습니다. GoogleSigninClient 인증 중 오류 처리를 위한 추가 코드	Play 게임즈 서비스 웹 API에 대한 서버 측 액세스를 요청할 때 GamesSignInClient를 사용하여 세 가지 기본 OAuth 2.0 ID 범위를 요청할 수 있습니다. 자세한 내용은 Play Games 서비스에 대한 서버 측 액세스 및 서버 인증 코드 검색을 참고하세요.
로그인 프로세스	GoogleSigninClient를 사용합니다. 자동 인증 및 오류 처리를 위한 상용구 코드 처리를 위한 추가 코드	GamesSignInClient를 사용합니다. SDK는 상용구 코드, 자동 인증, 오류 처리를 처리합니다. '로그인'은 다음과 같은 두 가지 고유한 레이어로 분리됩니다. 플랫폼 인증: Play Games 서비스 v2 SDK에서 처리합니다. 게임 내 인증: 게임에서 처리합니다.
환영 팝업	추가 코드가 필요합니다. 개발자는 배치 및 시기를 제어할 수 있습니다.	추가 코드가 필요하지 않습니다. 게임즈 v2 SDK로 구성된 모든 게임에서 일관된 사용자 인터페이스
종속 항목	play-services-auth가 필요합니다.	게임 모듈은 승인 및 인증을 처리합니다. 추가 종속 항목을 추가할 필요가 없습니다.
로그아웃	GoogleSignInClient.signOut를 사용합니다.	Play 게임즈 서비스 v2는 영구 플랫폼 ID이므로 로그아웃 API가 필요하지 않습니다.
여러 Play 게임즈 서비스 계정 및 게임별 설정	게임 내에서 계정 관리가 가능합니다.	사용자는 휴대기기 설정에서 Play 게임즈 서비스 프로필을 변경할 수 있습니다. 자세한 내용은 휴대기기에서 Play 게임즈 프로필을 전환하는 방법을 참고하세요.