دستاوردهای بازی های یونیتی

این مبحث نحوه استفاده از دستاوردهای خدمات Play Games در بازی‌های Unity را شرح می‌دهد. این فرض را بر این می‌گذارد که پروژه خود و افزونه Google Play Games را برای Unity راه‌اندازی کرده‌اید، همانطور که در راهنمای شروع کار توضیح داده شد.

یک دستاورد ایجاد کنید

هنگامی که پروژه و افزونه خود را راه اندازی می کنید، دستاوردها را در کنسول Google Play ایجاد کنید و سپس افزونه را با منابع Android برای دستاوردهای خود به روز کنید. برای جزئیات درباره ایجاد دستاوردها در Play Console، به راهنمای دستاوردها مراجعه کنید.

یک دستاورد را آشکار و باز کنید

برای باز کردن قفل یک دستاورد، از روش Social.ReportProgress با مقدار پیشرفت 100.0f استفاده کنید:

    using GooglePlayGames;
    using UnityEngine.SocialPlatforms;
    ...
    // unlock achievement (achievement ID "Cfjewijawiu_QA")
    Social.ReportProgress("Cfjewijawiu_QA", 100.0f, (bool success) => {
      // handle success or failure
    });

با توجه به رفتار مورد انتظار Social.ReportProgress ، مقدار 0.0f به معنای آشکار شدن دستاورد و پیشرفت 100.0f به معنای باز شدن قفل دستاورد است.

برای آشکار کردن دستاوردی که قبلاً بدون باز کردن قفل آن پنهان شده بود، با Social.ReportProgress با مقدار 0.0f تماس بگیرید.

افزایش یک دستاورد

اگر دستاورد افزایشی باشد، اجرای بازی‌های Play Social.ReportProgress سعی می‌کند مطابق با API اجتماعی Unity، رفتار مورد انتظار را رعایت کند. اگرچه ممکن است این رفتار یکسان نباشد، بنابراین توصیه می کنیم از Social.ReportProgress برای دستاوردهای افزایشی استفاده نکنید. در عوض، از روش PlayGamesPlatform.IncrementAchievement استفاده کنید، که یک برنامه افزودنی بازی های Play است.

    using GooglePlayGames;
    using UnityEngine.SocialPlatforms;
    ...
    // increment achievement (achievement ID "Cfjewijawiu_QA") by 5 steps
    PlayGamesPlatform.Instance.IncrementAchievement(
        "Cfjewijawiu_QA", 5, (bool success) => {
            // handle success or failure
    });

نمایش رابط کاربری دستاوردها

برای نشان دادن رابط کاربری داخلی برای همه دستاوردها، با Social.ShowAchievementsUI تماس بگیرید.

    using GooglePlayGames;
    using UnityEngine.SocialPlatforms;
    ...
    // show achievements UI
    Social.ShowAchievementsUI();

این مبحث نحوه استفاده از دستاوردهای خدمات Play Games در بازی‌های Unity را شرح می‌دهد. این فرض را بر این می‌گذارد که پروژه خود و افزونه Google Play Games را برای Unity راه‌اندازی کرده‌اید، همانطور که در راهنمای شروع کار توضیح داده شد.

یک دستاورد ایجاد کنید

هنگامی که پروژه و افزونه خود را راه اندازی می کنید، دستاوردها را در کنسول Google Play ایجاد کنید و سپس افزونه را با منابع Android برای دستاوردهای خود به روز کنید. برای جزئیات درباره ایجاد دستاوردها در Play Console، به راهنمای دستاوردها مراجعه کنید.

یک دستاورد را آشکار و باز کنید

برای باز کردن قفل یک دستاورد، از روش Social.ReportProgress با مقدار پیشرفت 100.0f استفاده کنید:

    using GooglePlayGames;
    using UnityEngine.SocialPlatforms;
    ...
    // unlock achievement (achievement ID "Cfjewijawiu_QA")
    Social.ReportProgress("Cfjewijawiu_QA", 100.0f, (bool success) => {
      // handle success or failure
    });

با توجه به رفتار مورد انتظار Social.ReportProgress ، مقدار 0.0f به معنای آشکار شدن دستاورد و پیشرفت 100.0f به معنای باز شدن قفل دستاورد است.

برای آشکار کردن دستاوردی که قبلاً بدون باز کردن قفل آن پنهان شده بود، با Social.ReportProgress با مقدار 0.0f تماس بگیرید.

افزایش یک دستاورد

اگر دستاورد افزایشی باشد، اجرای بازی‌های Play Social.ReportProgress سعی می‌کند مطابق با API اجتماعی Unity، رفتار مورد انتظار را رعایت کند. اگرچه ممکن است این رفتار یکسان نباشد، بنابراین توصیه می کنیم از Social.ReportProgress برای دستاوردهای افزایشی استفاده نکنید. در عوض، از روش PlayGamesPlatform.IncrementAchievement استفاده کنید، که یک برنامه افزودنی بازی های Play است.

    using GooglePlayGames;
    using UnityEngine.SocialPlatforms;
    ...
    // increment achievement (achievement ID "Cfjewijawiu_QA") by 5 steps
    PlayGamesPlatform.Instance.IncrementAchievement(
        "Cfjewijawiu_QA", 5, (bool success) => {
            // handle success or failure
    });

نمایش رابط کاربری دستاوردها

برای نشان دادن رابط کاربری داخلی برای همه دستاوردها، با Social.ShowAchievementsUI تماس بگیرید.

    using GooglePlayGames;
    using UnityEngine.SocialPlatforms;
    ...
    // show achievements UI
    Social.ShowAchievementsUI();