마이그레이션 개요

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

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

SDK 상호작용

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

게임 v2 (현재)

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

games v1 (기존)

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

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

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

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

기능 비교

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


기능

게임즈 v1 SDK

게임즈 v2 SDK

인증

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

간소화되고 능률적입니다. play-services-auth는 필요하지 않습니다.

승인

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

SDK에서 관리함

서버 액세스 토큰

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

로그인 중 오류 처리를 위한 추가 코드입니다.

추가 범위는 허용되지 않습니다.

serverAuthcode가 있는 성공 실패 콜백이 있는 추가 코드

로그인 절차

GoogleSigninClient를 사용합니다.

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

GamesSignInClient를 사용합니다.

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

시작 팝업

추가 코드가 필요합니다.
개발자는 게재위치와 시점을 제어할 수 있습니다.

추가 코드가 필요하지 않습니다. 모든 PGS V2 구성 게임에서 일관된 사용자 인터페이스를 제공합니다. .

종속 항목

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

play-services-auth에 대한 별도의 종속 항목이 없습니다.
로그아웃

GoogleSignInClient.signOut를 사용합니다.

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

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

계정 선택 및 관리를 사용할 수 없습니다.

게임별로 Play 게임즈 서비스 계정을 관리할 수 있습니다. 이렇게 하면 각 게임에서 사용할 계정을 선택할 수 있습니다.