마이그레이션 개요

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

이 문서는 게임 애플리케이션과 다양한 SDK 간의 상호작용을 이해하는 데 도움이 됩니다. 이 문서에서는 애플리케이션의 기능을 Play 게임즈 서비스 게임 v1 및 게임 v2 SDK의 기능과 비교합니다.

SDK 상호작용

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

games v2 (현재)

Android, GMS 코어, Play 게임즈 서비스, 서드 파티 (3P) 게임 서버의 게임 애플리케이션 간 상호작용
Android, GMS 코어, Play 게임즈 서비스, 서드 파티 (3P) 게임 서버 간의 게임 애플리케이션 상호작용 (확대하려면 클릭)

games v1 (기존)

Android, GMS 코어, Play 게임즈 서비스, 서드 파티 (3P) 게임 서버의 게임 애플리케이션 간 상호작용
Android, GMS 코어, Play 게임즈 서비스, 서드 파티 (3P) 게임 서버 간의 게임 애플리케이션 상호작용 (확대하려면 클릭)

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

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

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

기능 비교

다음 표에서는 게임 v1 및 게임 v2 SDK의 기능을 비교합니다.


기능

게임 v1 SDK

게임 v2 SDK

인증

play-services-auth와 통합해야 합니다.

간소화되고 능률화되었으며 play-services-auth이(가) 필요하지 않습니다.

승인

성공, 실패, 재시도를 위한 추가 코드입니다.

SDK에서 관리

서버 액세스 토큰

GoogleSigninClient를 사용하여 추가 OAuth 2.0 범위를 요청할 수 있습니다.

로그인 중 오류 처리를 위한 추가 코드

Play 게임 서비스 웹 API에 대한 서버 측 액세스를 요청할 때 GamesSignInClient를 사용하여 세 가지 기본 OAuth 2.0 ID 범위를 요청할 수 있습니다.

자세한 내용은 Play 게임즈 서비스에 대한 서버 측 액세스 서버 인증 코드 가져오기를 참고하세요.


로그인 절차

GoogleSigninClient을 사용합니다.

자동 로그인 및 오류 처리를 위한 상용구 코드를 처리하기 위한 추가 코드입니다.

GamesSignInClient을 사용합니다.

SDK는 상용구 코드, 자동 로그인, 오류 처리를 처리합니다.

환영 팝업

추가 코드가 필요합니다.
개발자는 배치와 타이밍을 제어할 수 있습니다.

추가 코드가 필요하지 않습니다. 게임즈 v2 SDK로 구성된 모든 게임에서 일관된 사용자 인터페이스

종속 항목

play-services-auth가 필요합니다.

게임 모듈은 승인 및 인증을 처리합니다. 추가 종속 항목을 추가할 필요는 없습니다.
로그아웃

GoogleSignInClient.signOut을 사용합니다.

로그아웃 API는 지원되지 않습니다.

여러 Play 게임즈 서비스 계정 및 게임별 설정

게임 내에서 계정 관리가 가능합니다.

사용자는 휴대기기 설정에서 Play 게임 서비스 프로필을 변경할 수 있습니다. 자세한 내용은 휴대기기에서 Play 게임즈 프로필을 전환하는 방법을 참고하세요.