Google Play 게임즈 서비스 지원
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
경고: Google Play 인스턴트는 더 이상 사용할 수 없습니다. 2025년 12월부터는 Google Play를 통해 인스턴트 앱을 게시할 수 없으며 모든 Google Play 서비스 인스턴트 API가 더 이상 작동하지 않습니다. 더 이상 Play에서 어떤 메커니즘을 사용하여도 사용자에게 인스턴트 앱이 게재되지 않습니다.
이번 변경사항은 개발자 의견과 Google Play 인스턴트 도입 이후 생태계를 개선하기 위한 Google의 지속적인 투자에 따라 결정되었습니다.
사용자 증가를 목표로 계속 최적화하려면 개발자는 딥 링크를 사용하여 사용자를 일반 앱 또는 게임으로 안내하고, 관련된 경우 특정 여정이나 기능으로 리디렉션하는 것이 좋습니다.
모든 인스턴트 플레이 게임은 Google Play 게임즈 서비스를 사용한 자동 로그인을 지원해야 합니다. Google Play 게임즈 서비스를 사용하여 클라우드에서 저장된 진행 상황을 복원하는 데 사용할 수 있는 일관된 플레이어 ID를 제공합니다.
라이브러리의 크기 영향
Google Play 게임 서비스 라이브러리의 크기 영향은 게임 엔진이 Unity, Java 또는 네이티브에서 실행되는지에 따라 다릅니다.
자바
ProGuard는 사용되는 클래스에 관해 알 수 있으므로 크기 영향은 최소화됩니다.
Unity
공식 Google Play 게임 서비스 플러그인을 사용하여 게임 저장 기능을 Unity 게임에 통합할 수 있습니다.
ProGuard 권장사항을 사용하면 크기 영향이 약 200KB입니다.
네이티브
네이티브 Play 게임즈 서비스 SDK를 사용하여 Android NDK 기반의 게임과 게임 저장 기능을 통합할 수 있습니다.
아래의 일반 ProGuard 구성을 사용하여 라이브러리에 포함된 대부분의 자바 코드를 제거하세요. 이 구성을 사용하면 APK에 약 250KB만 추가하면서 Play 게임즈 서비스 로그인 및 게임 저장을 구현할 수 있습니다.
# The native PGS library wraps the Java PGS SDK using reflection.
-dontobfuscate
-keeppackagenames
# Needed for callbacks.
-keepclasseswithmembernames,includedescriptorclasses class * {
native <methods>;
}
# Needed for helper libraries.
-keep class com.google.example.games.juihelper.** {
public protected *;
}
-keep class com.sample.helper.** {
public protected *;
}
# Needed for GoogleApiClient and auth stuff.
-keep class com.google.android.gms.common.api.** {
public protected *;
}
# Keep all of the "nearby" library, which is needed by the native PGS library
# at runtime (though deprecated).
-keep class com.google.android.gms.nearby.** {
public protected *;
}
# Keep all of the public PGS APIs.
-keep class com.google.android.gms.games.** {
public protected *;
}
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-08-28(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-28(UTC)"],[],[],null,["**Warning:** Google Play Instant will no longer be available. Starting December 2025,\nInstant Apps cannot be published through Google Play, and all\n[Google Play services Instant APIs](https://developers.google.com/android/reference/com/google/android/gms/instantapps/package-summary)\nwill no longer work. Users will no longer be served Instant Apps by Play using any\nmechanism.\n\nWe're making this change based on developer feedback and our continuous investments\nto improve the ecosystem since the introduction of Google Play Instant.\n\nTo continue optimizing for user growth, we encourage developers to refer users to\ntheir regular app or game, using [deeplinks](https://support.google.com/googleplay/android-developer/answer/12463044)\nto redirect them to specific journeys or features when relevant.\n\nAll Instant play games must support automatic\n[sign-in using Google Play Games Services](https://developers.google.com/games/services/common/concepts/sign-in). Use\nGoogle Play Games Services to\nprovide a consistent player ID that you can use to restore saved progress\nfrom the cloud.\n\nSize impact of the library\n\nThe size impact of the Google Play Games Services library depends on whether the\ngame engine runs on Unity, Java, or Native.\n\nJava\n\nThe size impact is minimal because ProGuard is informed about\nwhich classes are used.\n\nUnity\n\nYou can integrate the game save feature into your Unity game using the\n[official Google Play Game Services plugin](https://github.com/playgameservices/play-games-plugin-for-unity/tree/master/current-build).\nThe size impact is around 200 KB if you use the ProGuard recommendations.\n\nNative\n\nYou can integrate the game save feature with a game built on the Android NDK using the\n[Native Play Games Services SDK](https://developers.google.com/games/services/cpp/GettingStartedNativeClient).\n\nUse the general ProGuard configuration below to strip out most of the Java code\nincluded by the library. You can implement Play Games Services\nsign-in and game save with this configuration, while only adding about\n250 KB to the APK. \n\n # The native PGS library wraps the Java PGS SDK using reflection.\n -dontobfuscate\n -keeppackagenames\n\n # Needed for callbacks.\n -keepclasseswithmembernames,includedescriptorclasses class * {\n native \u003cmethods\u003e;\n }\n\n # Needed for helper libraries.\n -keep class com.google.example.games.juihelper.** {\n public protected *;\n }\n -keep class com.sample.helper.** {\n public protected *;\n }\n\n # Needed for GoogleApiClient and auth stuff.\n -keep class com.google.android.gms.common.api.** {\n public protected *;\n }\n\n # Keep all of the \"nearby\" library, which is needed by the native PGS library\n # at runtime (though deprecated).\n -keep class com.google.android.gms.nearby.** {\n public protected *;\n }\n\n # Keep all of the public PGS APIs.\n -keep class com.google.android.gms.games.** {\n public protected *;\n }"]]