이 문서에는 Play Games 서비스 v1 SDK의 지원 중단 일정이 나와 있습니다.
Google 로그인 (GSI) API 및 계획된 종료에 따라 Play Games 서비스 v1 SDK 및 API가 지원 중단됩니다. 최신 기능을 사용하려면 게임을 Play Games 서비스 v2 SDK로 이전해야 합니다.
지원 중단 타임라인은 다음과 같습니다.
| 날짜 | 지원 중단 이정표 |
영향 | 개발자 조치 |
|---|---|---|---|
| 2026년 5월 | GSI API 삭제 |
게임에서 Play 게임즈 서비스 v1 API를 제외한 Google 인증에 의존하지 않는 라이브ops, 미션, 지도와 같은 새로운 기능을 추가하는 경우 이러한 기능은 계속 작동합니다. 게임에서 인증 업그레이드가 필요한 Play Games 서비스 v1 이외의 서드 파티 SDK 또는 Google SDK를 사용하는 경우 해당 SDK의 최신 버전으로 업그레이드하면 컴파일 오류가 발생할 수 있습니다. |
|
| 2026년 6월 15일 | Play Games 서비스 v1 API 삭제 |
GSI API가 삭제된 새로운 Play 게임즈 서비스 v1 SDK가 게시되며 기존 Play 게임즈 서비스 v1 기능에 대한 추가 버그 수정 또는 업데이트는 없습니다. 기존 v1 게임이 최신 Play 게임즈 서비스 v1 버전으로 업그레이드되는 경우 이 새 버전의 Play 게임즈 서비스 기능이 작동하지 않습니다. |
|
| 2027년 5월 | Play 게임즈 서비스 v1 종료 |
게임 컴파일 없이 Play Games 서비스 v1의 모든 트래픽이 차단됩니다. 기존 Play 게임즈 서비스 v1 API가 프로덕션 환경에서 작동하지 않습니다. |
플레이어 온보딩 및 로그인 중단을 방지하려면 이 기한 전에 Play 게임즈 서비스 v2로 이전하는 방법밖에 없습니다. |
2025년 9월 이후에는 게임즈 v1 SDK 및 API가 지원 중단됩니다. 이전 v1 통합이 적용된 기존 게임은 계속 작동합니다. Google Play에서는 v1 SDK 및 API를 사용하는 새 게임을 게시할 수 없습니다.
2026년 6월 15일부터 지원 중단된 API가 SDK에서 삭제됩니다.
2027년 6월부터 게임즈 v1 SDK가 삭제됩니다. 이전 버전의 SDK를 사용하더라도 이러한 API 호출은 실패합니다.
다음 표에는 게임즈 v1 (SDK) 버전, 지원 중단 날짜, 이전 가이드가 나와 있습니다.
| SDK 버전 | 출시일 | 이전 가이드 |
|---|---|---|
| play-services-games:v24.0.0 | 2025년 9월 12일 지원 중단됨 |
v2(자바 또는 Kotlin)로 이전 |
| v0.10.15 Unity | 2025년 9월 17일 지원 중단됨 |
v2(Unity)로 이전 |
| play-services-games:v25.0.0 | 2026년 6월 15일 Play 게임즈 서비스 v1 API가 SDK에서 삭제됨 |
v2(자바 또는 Kotlin)로 이전 |
GSI API 삭제의 샘플 영향
SDK1이라는 SDK가 플레이어의 Google 계정에서 친구 목록을 가져오는 시나리오를 생각해 보세요. 이 기능을 사용하려면 플레이어가 Google 인증 SDK를 사용하여 Google 계정을 인증해야 합니다.
다음과 같은 상황에서는 Google 인증 SDK를 업데이트해야 할 수 있습니다.
- 인증 흐름의 심각한 버그를 해결합니다.
- 인증 관리자 SDK에서 제공하는 새로운 패스키 환경을 구현합니다.
다음 표에서는 게임의 인증 통합을 업데이트하는 세 가지 시나리오를 설명합니다.
- 시나리오 1: SDK1이 최신 Google 인증 SDK로 업그레이드됩니다.
- 시나리오 2: SDK1이 인증 관리자와 통합되고 Google 인증 SDK는 변경되지 않습니다.
- 시나리오 3: SDK1이 인증 관리자와 통합되고 Google 인증 SDK를 삭제합니다.
| 기능 | 시나리오 1 | 시나리오 2 | 시나리오 3 |
|---|---|---|---|
| 인증 업그레이드 시나리오 |
|
GSI API 삭제를 알고 있는 SDK1은 인증 SDK를 업그레이드하지 않지만 최신 버전의 인증 관리자 SDK를 사용하여 Google 인증 기능을 지원합니다. | 최신 버전에서 SDK1은 인증 관리자 SDK를 사용하여 Google 인증 기능을 지원하고 인증 SDK를 완전히 삭제합니다. |
| Play Games 서비스 v1 SDK | 변경되지 않음 | 변경되지 않음 | 변경되지 않음 |
| 게임 컴파일 시 발생하는 상황 |
|
게임에 컴파일 시간 오류가 발생합니다. | 그런 다음 게임에서 해결 경로를 따르려고 합니다. |
| 가능한 플레이어 환경 | 해당 사항 없음. 게임을 컴파일할 수 없으므로 게시할 수 없습니다. |
|
|
| 게임 개발자를 위한 해결 경로 |
|
|
|
| Play 게임즈 서비스 v1의 최종 결과 | 게임은 Play Games 서비스 v2로 업그레이드할 필요가 없지만 SDK1은 오래된 상태로 유지됩니다. | 게임은 Play Games 서비스 v1에서 v2로 업그레이드할 필요가 없습니다. | 게임은 Play Games 서비스 v1에서 v2로 업그레이드할 필요가 없습니다. |