이 주제에서는 Unity 게임에서 Play 게임즈 서비스 업적을 사용하는 방법을 설명합니다. 여기서는 시작 가이드의 설명과 같이 프로젝트와 Unity용 Google Play 게임즈 플러그인을 설정했다고 가정합니다.
업적 만들기
프로젝트와 플러그인을 설정할 때 Google Play Console에서 업적을 만들고 업적을 위한 Android 리소스로 플러그인을 업데이트합니다. Play Console에서 업적을 만드는 방법을 자세히 알아보려면 업적 가이드를 참고하세요.
업적 공개 및 달성
업적을 달성하려면 진행 상황 값이 100.0f인 Social.ReportProgress 메서드를 사용하세요.
usingGooglePlayGames;usingUnityEngine.SocialPlatforms;...// unlock achievement (achievement ID "Cfjewijawiu_QA")Social.ReportProgress("Cfjewijawiu_QA",100.0f,(boolsuccess)=>{// handle success or failure});
달성하지 않고 이전에 숨겨졌던 업적을 공개하려면 값이 0.0f인 Social.ReportProgress를 호출합니다.
단계별 업적
업적이 단계별 업적이라면 Social.ReportProgress의 Play 게임즈 구현이 Unity 소셜 API에 따라 예상되는 동작을 준수하려고 합니다. 그러나 동작이 동일하지 않을 수 있으므로, 단계별 업적에는 Social.ReportProgress를 사용하지 않는 것이 좋습니다. 대신 Play 게임즈 확장 프로그램인 PlayGamesPlatform.IncrementAchievement 메서드를 사용하세요.
usingGooglePlayGames;usingUnityEngine.SocialPlatforms;...// increment achievement (achievement ID "Cfjewijawiu_QA") by 5 stepsPlayGamesPlatform.Instance.IncrementAchievement("Cfjewijawiu_QA",5,(boolsuccess)=>{// handle success or failure});
업적 UI 표시
모든 업적의 내장 UI를 표시하려면 Social.ShowAchievementsUI를 호출합니다.
usingGooglePlayGames;usingUnityEngine.SocialPlatforms;...// show achievements UISocial.ShowAchievementsUI();
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(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-07-27(UTC)"],[],[],null,["# Achievements in Unity games\n\nThis topic describes how to use Play Games Services achievements in Unity\ngames. It assumes that you've set up your project and the\nGoogle Play Games plugin for Unity, as discussed in the\n[Get started guide](/games/pgs/unity/unity-start).\n\nCreate an achievement\n---------------------\n\nWhen you set up your project and plugin, create the achievements in\nGoogle Play Console and then update the plugin with the Android resources\nfor your achievements. For details about creating achievements in\nPlay Console, see the\n[achievements guide](/games/pgs/achievements#create_an_achievement).\n\nReveal and unlock an achievement\n--------------------------------\n\nTo unlock an achievement, use the **Social.ReportProgress** method with a\nprogress value of 100.0f: \n\n using GooglePlayGames;\n using UnityEngine.SocialPlatforms;\n ...\n // unlock achievement (achievement ID \"Cfjewijawiu_QA\")\n Social.ReportProgress(\"Cfjewijawiu_QA\", 100.0f, (bool success) =\u003e {\n // handle success or failure\n });\n\nAccording to the expected behavior of\n[Social.ReportProgress](http://docs.unity3d.com/Documentation/ScriptReference/Social.ReportProgress.html),\na value of 0.0f means the achievement is revealed and a progress of 100.0f\nmeans the achievement is unlocked.\n\nTo reveal an achievement that was\npreviously hidden without unlocking it, call **Social.ReportProgress** with\na value of 0.0f.\n\nIncrement an achievement\n------------------------\n\nIf the achievement is incremental, the Play Games implementation of\n**Social.ReportProgress** will try to adhere to the\nexpected behavior according to Unity's social API. The behavior might not be\nidentical, though, so we recommend that you don't use **Social.ReportProgress**\nfor incremental achievements. Instead, use the\n[PlayGamesPlatform.IncrementAchievement](/games/services/unity/v2/api/class/google-play-games/play-games-platform#incrementachievement) method, which is a\nPlay Games extension. \n\n using GooglePlayGames;\n using UnityEngine.SocialPlatforms;\n ...\n // increment achievement (achievement ID \"Cfjewijawiu_QA\") by 5 steps\n PlayGamesPlatform.Instance.IncrementAchievement(\n \"Cfjewijawiu_QA\", 5, (bool success) =\u003e {\n // handle success or failure\n });\n\nShow the achievements UI\n------------------------\n\nTo show the built-in UI for all achievements, call\n**Social.ShowAchievementsUI**. \n\n using GooglePlayGames;\n using UnityEngine.SocialPlatforms;\n ...\n // show achievements UI\n Social.ShowAchievementsUI();"]]