שילוב של Android Frame Pacing במעבד ה-OpenGL

במדריך הזה מוסבר איך לשלב את Android Frame Pacing בשרשרת הכלים, איך להשתמש בפונקציות שהספרייה מספקת ואיך לוודא שהשיפור ב-Frame Pacing אכן התרחש. התכונה Android Frame Pacing זמינה כספרייה סטטית או משותפת בספריות AGDK.

שנתחיל?

  1. משכפלים את מאגר games-samples.
  2. פועלים לפי ההוראות שבקטע דרישות מוקדמות בקובץ ה-README של AGDKTunnel.
  3. מריצים את הדוגמה AGDKTunnel ב-Android Studio. בפרויקט לדוגמה הזה משולב Android Frame Pacing במשחק שמשתמש ב-OpenGL ES לרינדור.

    1. פותחים את Android Studio.
    2. לוחצים על Projects > Open (פרויקטים > פתיחה) ובוחרים את הספרייה /games-samples/agdk/agdktunnel.
    3. ממתינים ש-Android Studio יסנכרן את הפרויקט.
    4. כדי להריץ את הדוגמה, צריך לחבר מכשיר או ליצור מכשיר וירטואלי (למידע נוסף, אפשר לעיין במאמר איך ליצור ולהריץ את האפליקציה).
    5. בוחרים את מכשיר היעד ולוחצים על הפעלה כפתור ההפעלה ב-Android Studio.
    6. חבילת ה-APK לדוגמה אמורה להיבנות ולהיות מותקנת במכשיר היעד. אם נתקלתם בשגיאות, כדאי לבדוק את הדברים הבאים:

      • יש לך גרסה נתמכת של Android SDK. מידע נוסף זמין בשדה compileSdkVersion בקובץ build.gradle של מודול האפליקציה. אפשר לעדכן את גרסת ה-SDK בכרטיסייה SDK Platforms ב-SDK Manager.
      • יש לכם גרסה נתמכת של Android NDK. למידע נוסף, אפשר לעיין בשדה ndkVersion בקובץ build.gradle של מודול האפליקציה. אפשר להתקין גרסה ספציפית של NDK מהכרטיסייה SDK Tools ב-SDK Manager.
      • בקובץ local.properties בפרויקט לא מופיעה רשומה של ndk.dir. המיקום הזה מצוין על ידי Android Studio ומשתמש בגרסת ה-NDK שצוינה למעלה. אם הרשומה הזו מופיעה, צריך למחוק את כל השורה.
      • אחרי כל שינוי בהגדרות ה-build, צריך לנקות את הפרויקט (Build > Clean Project) ולרענן את פרויקטי C++ המקושרים (Build > Refresh Linked C++ Projects).