تعریف حاشیه‌نویسی‌ها، پارامترهای وفاداری، و سطوح کیفیت

این سند نحوه تنظیم حاشیه‌نویسی‌ها، پارامترهای وفاداری، و سطوح کیفیت را در پروژه Unity شما شرح می‌دهد.

حاشیه‌نویسی‌ها

حاشیه‌نویسی‌ها اطلاعات زمینه‌ای درباره آنچه بازی شما هنگام ثبت تیک انجام می‌دهد ارائه می‌دهند.

حاشیه‌نویسی‌های پیش‌فرض

افزایه یک گزارش پیش‌فرض برای شما تعریف می‌کند:

  • صحنه: حاوی شناسه صحنه فعلی درحال پخش است؛ در مواردی که اکثر سطوح شما به یک صحنه در پروژه‌تان نگاشت می‌شود مفید است.

برای دیدن این حاشیه‌نویسی‌ها در میانای کاربر، کارهای زیر را انجام دهید:

  1. Google > Android Performance Tuner را انتخاب کنید.
  2. برگه پارامترهای حاشیه‌نویسی را انتخاب کنید و سپس روی استفاده از پارامترهای سفارشی کلیک کنید.

    برگه پارامترهای حاشیه‌نویسی در افزونه Android Performance Tuner Unity که پارامتر صحنه سفارشی را نشان می‌دهد
    شکل ۱. برگه پارامترهای حاشیه‌نویسی در افزونه

تعریف و استفاده از حاشیه‌نویسی سفارشی

برای ایجاد حاشیه‌نویسی سفارشی، کارهای زیر را انجام دهید:

  1. در برگه پارامترهای حاشیه‌نویسی، روی دکمه + کلیک کنید تا حاشیه‌نویسی جدیدی ایجاد کنید.
  2. در ردیف جدید، روی ستون نوع کلیک کنید و افزودن یا به‌روزرسانی شمارشی را انتخاب کنید. به‌عنوان مثال، می‌توانید برای دشواری بازی شمارش ایجاد کنید.

  3. پس‌از مشخص کردن مقادیر enum، روی دکمه افزودن Enum جدید کلیک کنید.

    کادر گفتگوی شمارشی جدید برای «دشواری» با مقادیر «آسان»، «متوسط»، و «سخت»
    شکل ۲. افزودن enum جدید
  4. نوع جدید را در ستون نوع انتخاب کنید. نامی برای پارامتر در ستون نام پارامتر وارد کنید.

    برگه پارامترهای حاشیه‌نویسی که پارامتر شمارشی سفارشی «دشواری» را با نام game-difficulty نشان می‌دهد
    شکل ۳. انتخاب enum جدید
  5. روی دکمه اعمال کلیک کنید تا افزایه بتواند کلاس‌ها و فایل‌های میان‌گیر پروتکل را دوباره تولید کند.

برای تنظیم این حاشیه‌نویسی در بازی‌تان، SetCurrentAnnotation را فراخوانی کنید:

tuner.SetCurrentAnnotation(new Annotation
{
    Scene = Scene.AssetsScenesMainmenu,
    Difficulty = Difficulty.Medium
});

تعریف پارامترهای وفاداری و سطوح کیفیت

پارامترهای وفاداری نشان‌دهنده عملکرد و تنظیمات گرافیکی بازی شما است. از سطوح کیفیت برای حاشیه‌نویسی جلسه‌ها استفاده می‌شود تا بتوانید تعیین کنید که آیا دستگاه‌ها در سطح کیفیتی اجرا می‌شوند که خیلی بالا است (منجر به عملکرد پایین‌تر می‌شود) یا خیلی پایین است (منجر به کاهش غیرضروری وفاداری می‌شود).

ممکن است بازی شما ازقبل پارامترهای وفاداری متفاوتی مثل موارد زیر داشته باشد:

  • کیفیت سایه
  • وضوح بافت
  • کیفیت جلوه‌های ذره‌ای

این پارامترها را می‌توان در سطوح کیفیت (برای مثال «پایین»، «متوسط»، و «بالا») گروه‌بندی کرد. برای اینکه این پارامترها به‌درستی توسط Android Performance Tuner گزارش شوند و سپس در «کنسول Google Play» تجزیه‌وتحلیل و تجسم شوند، باید پارامترها را در معرض افزونه قرار دهید. پارامترهای وفاداری را در برگه پارامترهای وفاداری اضافه کنید.

برگه پارامترهای وفاداری که پارامترهای سفارشی texture_resolution، shadow_quality، و particle_details را نشان می‌دهد
شکل ۴. برگه پارامترهای Fidelity در افزونه

استفاده از پارامترهای سفارشی را انتخاب کنید و سپس مجموعه‌ای از پارامترها را تعریف کنید. هر پارامتر نوعی دارد، مثل حاشیه‌نویسی‌ها.

از تابع SetFidelityParameters برای تنظیم پارامترهای وفاداری به‌طور مناسب در بازی‌تان استفاده کنید:

tuner.SetFidelityParameters(new FidelityParams
{
    ParticleDetails = 1.0f,
    ShadowQuality = ShadowQuality.High,
    TextureResolution = 2048,
});

سپس، سطوح کیفیت مختلفی را تعریف کنید که برای گروه‌بندی داده‌ها در «کنسول Google Play» استفاده خواهد شد و اطلاعات آماری بهتری به شما ارائه خواهد داد. سطوح کیفیت را در برگه سطوح کیفیت اضافه کنید.

روی دکمه افزودن سطح کلیک کنید تا اولین سطح خود را اضافه کنید. چند سطح را که از روندی پیروی می‌کنند تعریف کنید. برای مثال، سطوح را از پایین‌ترین سطح کیفیت تا بالاترین سطح تعریف کنید.

برگه سطوح کیفیت که سه سطح وفاداری را با افزایش وضوح بافت، جزئیات ذرات، و کیفیت سایه نشان می‌دهد
شکل ۵. برگه سطوح کیفیت در افزونه