عیب‌یابی هوش مصنوعی عمومی

این موضوع نحوه رفع مشکلات رایج هنگام استفاده از Android GPU Inspector (AGI) را شرح می‌دهد.

درحال بازنشانی تنظیمات «هوش مصنوعی عمومی»

AGI تنظیماتش را در فایل ~/.agic ذخیره می‌کند. با برداشتن این فایل، همه تنظیمات AGI، ازجمله فهرست ردگیری‌های اخیراً بازشده و نتایج اعتبارسنجی دستگاه حذف می‌شود.

AGI در برخی‌از دستگاه‌ها ناموفق است

لطفاً مطمئن شوید که راه‌اندازی شما همه الزامات را برآورده می‌کند.

موارد زیر نیز می‌تواند کمک کند:

  • هر برنامه‌ای را که ممکن است ازطریق ADB با دستگاه تعامل داشته باشد، مانند Android Studio، متوقف کنید.

  • گزینه Stay awake (در بخش «گزینه‌های توسعه‌دهندگان» در Android) را فعال کنید تا از بروز مشکلاتی که هنگام خاموش شدن صفحه‌نمایش دستگاه به‌دلیل حالت خواب رخ می‌دهد جلوگیری شود.

نمایه‌ساز سیستم فعالیت GPU را برای بازی‌های OpenGL ES گزارش نمی‌کند

درحال‌حاضر، فقط شمارنده‌های GPU هنگام ردیابی برنامه OpenGL ES پشتیبانی می‌شوند. اطلاعات فعالیت GPU برای برنامه‌های OpenGL ES درحال توسعه فعال است.

نمایه‌ساز قاب در برخی‌از بازی‌های Vulkan ناموفق است

اولین چیزی که باید تأیید شود این است که بازی شما به‌درستی از Vulkan استفاده می‌کند. از لایه اعتبارسنجی Vulkan استفاده کنید و مطمئن شوید که بازی‌تان هیچ خطا یا هشداری ایجاد نمی‌کند.

اگر خطای اعتبارسنجی Vulkan وجود داشته باشد، انتظار نمی‌رود که نمایه‌ساز قاب AGI کار کند.

هنگام ایجاد ردیابی نمایه‌ساز قاب، بازی با شکست مواجه شد

اگر بازی بدون AGI با موفقیت اجرا می‌شود اما هنگام ایجاد ردیابی نمایه قاب اجرا نمی‌شود، ممکن است بازی درطول توالی راه‌اندازی خود فرایند دیگری را منشعب کند. در این صورت، باید نام فرایند را برای ردیابی در فیلد «نام فرایند» در گزینه‌های ردیابی مشخص کنید.

برای شناسایی این مشکل، می‌توانید خروجی logcat را هنگام ایجاد ردگیری بررسی کنید و تأیید کنید که آیا فرایند دیگری درحال شروع است یا نه:

# Clear the logcat output
adb logcat -c

## Use AGI to attempt to create a frame profile trace

Look at the logcat output to identify the processes that are running AGI. 

adb logcat | grep "this process name"
I GAPID   : gapii [gapii/cc/spy.cpp:109] this process name: com.example.mygame
I GAPID   : gapii [gapii/cc/spy.cpp:109] this process name: com.example.mygame:GameProcess

اکثر بازی‌ها فقط یک فرایند دارند، مثال بالا نشان می‌دهد که برای بازی‌ای که بیش‌از یک فرایند دارد چه انتظاری باید داشت.

بازی در فرایند اصلی به‌نام com.example.mygame شروع می‌شود و سپس فرایند جدیدی به‌نام com.example.mygame:GameProcess را منشعب می‌کند. اگر پردازش واقعی بازی در فرایند دوم اتفاق می‌افتد، باید به AGI بگویید که این فرایندی است که می‌خواهید ردیابی کنید. می‌توانید این کار را با وارد کردن نام فرایند در فیلد Process name کادر گفتگوی گزینه ردیابی انجام دهید.

خرابی بازی پس‌از استفاده از AGI

اگر ردیابی به‌درستی خاتمه نیابد، ممکن است AGI برخی‌از تنظیمات Android را در وضعیتی رها کند که اجرای بعدی برنامه را مختل کند. این تنظیمات عبارت‌اند از:

  • تنظیمات مربوط به لایه‌های Vulkan:

    • enable_gpu_debug_layers

    • gpu_debug_app

    • gpu_debug_layers

    • gpu_debug_layer_app

  • تنظیمات مربوط به ANGLE:

    • angle_debug_package

    • angle_gl_driver_selection_values

    • angle_gl_driver_selection_pkgs

اگر برنامه‌تان پس‌از استفاده از AGI با مشکلی مواجه شد، می‌توانید بااستفاده از فرمان‌های adb زیر این تنظیمات را پاک کنید:

# Vulkan layers
adb shell settings delete global enable_gpu_debug_layers
adb shell settings delete global gpu_debug_app
adb shell settings delete global gpu_debug_layers
adb shell settings delete global gpu_debug_layer_app
# ANGLE
adb shell settings delete global angle_debug_package
adb shell settings delete global angle_gl_driver_selection_values
adb shell settings delete global angle_gl_driver_selection_pkgs

وقتی بازی را ازطریق AGI درحالی‌که ردگیری نمایه قاب را ایجاد می‌کنید راه‌اندازی می‌کنید، بازی متفاوت به‌نظر می‌رسد

برای ایجاد ردگیری نمایه قاب، AGI فراخوانی‌های میانای برنامه‌سازی کاربردی گرافیک را که توسط بازی انجام شده است رهگیری می‌کند، که ممکن است بر رندرینگ بازی تأثیر بگذارد.

AGI تماس‌های Vulkan را ضبط می‌کند. برای بازی‌های OpenGL ES، ‏AGI به ANGLE متکی است تا OpenGL ES را به Vulkan ترجمه کند. اگر بازی‌تان وقتی آن را ازطریق AGI راه‌اندازی می‌کنید متفاوت به‌نظر می‌رسد (مثلاً برخی‌از رنگ‌ها آن‌هایی نیستند که انتظار دارید)، احتمالاً اشکالی در AGI یا ANGLE وجود دارد. با امتحان کردن موارد زیر می‌توانید به ما کمک کنید تا درک بهتری از علت ریشه‌ای مشکل داشته باشیم.

بازی‌های Vulkan: ردیابی با همه افزونه‌های Vulkan پشتیبانی‌شده

گزینه ردیابی Include Unknown Extensions کنترل می‌کند که آیا AGI باید افزونه‌های Vulkan را که پشتیبانی نمی‌کند اضافه کند یا نه. (مرور فهرست افزونه‌های پشتیبانی‌شده.)

اگر برنامه‌تان از افزونه‌ای استفاده می‌کند که توسط AGI پشتیبانی نمی‌شود، ممکن است هنگام بازپخش ردیابی با رفتار نامطلوبی ازجمله خطاهای جزئی یا ازکارافتادن مواجه شوید.

این گزینه را فعال کنید، سپس ردیابی نمایه‌ساز قاب دیگری را راه‌اندازی کنید. اگر بازی با فعال بودن این گزینه طبق انتظار نمایش داده می‌شود، ممکن است بازی به افزونه Vulkan متکی باشد که توسط AGI پشتیبانی نمی‌شود.

بازی‌های OpenGL ES: فقط با ANGLE اجرا شود

می‌توانید بازی OpenGL ES خود را با ANGLE اما بدون AGI اجرا کنید تا ببینید آیا رندرینگ اشتباه ناشی از مشکلی در ANGLE است یا نه.

اگر قبلاً سعی کرده‌اید ردیابی نمایه قاب بازی OpenGL ES خود را ایجاد کنید، AGI قبلاً ANGLE را در دستگاهتان نصب کرده است. نام بسته ANGLE که توسط AGI استفاده می‌شود org.chromium.angle.agi است.

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

# Make sure that the AGI capture layer will be ignored
adb shell settings delete global enable_gpu_debug_layers
# Force the package com.example.mygame to use ANGLE
adb shell settings put global angle_debug_package org.chromium.angle.agi
adb shell settings put global angle_gl_driver_selection_values angle
adb shell settings put global angle_gl_driver_selection_pkgs com.example.mygame

اگر بازی با این تنظیمات متفاوت به‌نظر می‌رسد، احتمالاً اشکالی در ANGLE وجود دارد و نه AGI. اگر بازی با این تنظیمات درست به‌نظر می‌رسد، اما هنگام ایجاد ردگیری AGI متفاوت به‌نظر می‌رسد، احتمالاً اشکالی در AGI وجود دارد.

می‌توانید با ایجاد مشکل GitHub، اشکالات AGI را گزارش کنید.