نمای کلی Android Performance Tuner (بومی)

این سند نحوه ادغام Android Performance Tuner، که با نام کتابخانه Tuning Fork نیز شناخته می‌شود، را برای ضبط و بارگذاری داده‌های زمان پردازش فریم از موتورهای بازی بومی (C و C++) شرح می‌دهد.

برای موتور بازی Unity، به راهنمای Unity مراجعه کنید.

پس‌زمینه

یکی از مؤلفه‌های کلیدی تجربه بازی عملکرد پردازشی است. عملکرد پرداخت به نتیجه دو ورودی زیر بستگی دارد:

  • نرخ فریم: هر چند وقت یک‌بار فریم ترسیم می‌شود.
  • تنظیمات کیفیت گرافیکی: سطح وفاداری که در آن قاب ارائه می‌شود، ازجمله وفاداری شبیه‌سازی و همچنین گرافیک.

برای بازی‌ها، عملکرد پردازشی خوب به‌صورت زیر تعریف می‌شود:

  • ارائه نرخ فریم پایدار و یکنواخت (یعنی درصد فریم‌هایی که با بسامد مطلوب پرداز می‌شود).
  • پرداز فریم‌ها با بالاترین فرکانس ممکن درحین حفظ پایداری، معمولاً ۳۰ یا ۶۰ فریم در ثانیه بسته به نوع بازی.
  • به‌حداکثر رساندن سطح جزئیات برای کاربر باتوجه‌به اندازه و تراکم صفحه‌نمایش او، درحالی‌که همچنان نرخ فریم پایدار و مطلوب حاصل می‌شود.

کتابخانه Android Frame Pacing بیشتر تغییرات در زمان پردازش فریم را محدود می‌کند و نرخ فریم پایداری برای بازی‌ها ارائه می‌دهد. تغییرات باقی‌مانده در زمان پردازش فریم به‌دلیل سطح جزئیات نمایش‌داده‌شده درطول صحنه‌های خاصی در شیوه بازی و قابلیت‌های گرافیکی دستگاه است. بااستفاده از Android Performance Tuner، می‌توانید زمان‌هایی را درطول بازی که زمان پردازش فریم کندتر یا سریع‌تر از هدف شما است مشخص کنید و این مشکلات و فرصت‌ها را به موارد زیر مرتبط کنید:

  • تنظیمات کیفیت خاص
  • صحنه‌های خاص در بازی شما
  • مدل‌های خاص دستگاه یا مشخصات دستگاه

ضبط و بارگذاری داده‌ها

کتابخانه Tuning Fork به یکی از توابع تیک خود متکی است که در هر فریم توسط کتابخانه Android Frame Pacing فراخوانی می‌شود. در کتابخانه، این اطلاعات تیک در هیستوگرام‌هایی جمع‌آوری می‌شود که سپس به‌طور دوره‌ای ازطریق نقطه پایانی HTTP در Google Play بارگذاری می‌شود. هر تیک به‌عنوان مرتبط با یک کلید ابزار و یک حاشیه‌نویسی ثبت می‌شود که تعاریف آن‌ها را در یک فایل میان‌گیر پروتکل مشخص می‌کنید.

کلیدهای ابزار

کلید ابزار نشان می‌دهد که تیک از کجای قاب می‌آید و عدد صحیحی است که باید به هر فراخوانی تابع تیک ارسال شود. کتابخانه Android Frame Pacing از مجموعه ازپیش‌تعریف‌شده‌ای از کلیدهای ابزار استفاده می‌کند که در swappy_common.h تعریف شده‌اند. اگر از کتابخانه Frame Pacing استفاده نمی‌کنید، می‌توانید کلیدهای ابزار خودتان را نیز تعریف کنید.

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

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

  • سطح فعلی بازی
  • یک «رئیس بزرگ» روی صفحه است
  • هرگونه اطلاعات مرتبط دیگر درباره وضعیت بازی

حاشیه‌نویسی‌ها با پیام میان‌گیر پروتکل com.google.tuningfork.Annotation تعریف می‌شوند. برای تنظیم حاشیه‌نویسی فعلی، سری‌سازی پیامی را که تعریف کرده‌اید به TuningFork_setCurrentAnnotation ارسال می‌کنید. سپس همه داده‌های تیک بعدی با این حاشیه‌نویسی مرتبط می‌شوند تا زمانی که حاشیه‌نویسی دیگری تنظیم شود. در زیر نمونه‌ای از تعریف proto برای حاشیه‌نویسی‌ها آورده شده است:

import "tuningfork.proto"
enum Level {
  INVALID_LEVEL = 0;
  Level_1 = 1;
  Level_2 = 2;
  Level_3 = 3;
}
message Annotation {
  optional Level level = 1;
}

پارامترهای وفاداری

پارامترهای وفاداری بر عملکرد و وفاداری گرافیکی بازی شما تأثیر می‌گذارند، مانند سطح جزئیات مش، وضوح بافت، و روش ضدپلگی. مانند حاشیه‌نویسی‌ها، پارامترهای وفاداری بااستفاده از پیام میان‌گیر پروتکل com.google.tuningfork.FidelityParams تعریف می‌شوند. در زیر نمونه‌ای از تعریف proto برای پارامترهای وفاداری آورده شده است:

import "tuningfork.proto"
message FidelityParams {
  int32 texture_quality_level = 1;
  int32 shadow_resolution = 2;
  float terrain_details_percent = 3;
  int32 post_processing_effects_level = 4;
}

در مقداردهی اولیه Tuning Fork، سریال‌سازی پارامترهایی را که بازی استفاده می‌کند ارسال می‌کنید. می‌توانید این پارامترها را تغییر دهید، مثلاً اگر کاربر تنظیمات پرداز بازی را تغییر دهد و داده‌های بارگذاری‌شده بعدی شما با پارامترهای جدید مرتبط باشد.

برای اینکه Google Play بتواند حاشیه‌نویسی‌ها و پارامترهای وفاداری را که تعریف می‌کنید درک کند، فایل میان‌گیر پروتکل حاوی این تعاریف باید به‌همراه تنظیمات مقداردهی اولیه در APK بازی گنجانده شود. همچنین باید مقادیر پیش‌فرضی برای ترکیب‌های رایج پارامتر وفاداری در APK خود ارائه دهید تا داده‌هایتان براساس آن‌ها در میانای کاربر Google Play بخش‌بندی شود. برای اطلاعات بیشتر، تعریف سطوح کیفیت را ببینید.

سربار حافظه و واحد پردازش مرکزی

تمام حافظه استفاده‌شده توسط کتابخانه Tuning Fork در زمان مقداردهی اولیه اختصاص داده می‌شود تا از بروز مشکلات غیرمنتظره درطول بازی جلوگیری شود. اندازه داده‌ها به تعداد کلیدهای ابزار، تعداد حاشیه‌نویسی‌های ممکن، و تعداد دسته‌ها در هر بافت‌نگاشت بستگی دارد؛ این اندازه مضربی از همه این موارد ضربدر چهار بایت برای هر دسته است. همچنین دو نسخه از همه هیستوگرام‌ها وجود دارد تا امکان ارسال به‌صورت میان‌گیر دوگانه فراهم شود.

ارسال در رشته‌ای جداگانه انجام می‌شود و تماس‌های تیک را مسدود نمی‌کند. اگر اتصال بارگذاری دردسترس نباشد، ارسال در صف قرار می‌گیرد تا بعداً بارگذاری شود.

There is little processing overhead to calling a tick function: it simply calculates an index into the array of histogram buckets and increments an integer count.

ادغام کتابخانه Tuning Fork

این راهنمای یکپارچه‌سازی به دو بخش تقسیم شده است. بخش اول نحوه اجرای آزمایش سرتاسری بااستفاده از برنامه نمایشی و «کنسول Google Play» را شرح می‌دهد. بخش دوم نحوه ادغام کتابخانه Tuning Fork در زنجیره ابزار و نحوه استفاده از توابعی را که کتابخانه ارائه می‌دهد شرح می‌دهد. برای شروع، روی پیوند بعدی در زیر کلیک کنید.