واجهة برمجة تطبيقات وضع الألعاب

تسمح لك واجهة برمجة التطبيقات Game Mode API بتحسين لعبتك لتحقيق أفضل أداء أو لإطالة عمر البطارية عندما يختار المستخدم وضع اللعبة المناسب.

ويمكنك بدلاً من ذلك إرسال طلبات للتدخّلات في وضع الألعاب لتحسين أداء الألعاب التي لم يعُد المطوّرون يخضعون للتحديث.

تتوفّر واجهة برمجة التطبيقات Game Mode API والتدخلات على:

• اختيار أجهزة Android 12
• أجهزة Android 13 أو بإصدار أحدث

يجوز لكل لعبة تنفيذ سلوك واجهة برمجة التطبيقات Game Mode API أو اقتراح إعدادات تدخلات في "وضع اللعبة" على المصنّعين الأصليين للأجهزة أو إيقاف تدخلات "وضع اللعبة".

تحذير: قد يختار المصنّعون الأصليون للأجهزة تنفيذ إجراءات تدخل في "وضع الألعاب" بدون الحصول على ملاحظات المطوّرين.

ضبط إعدادات الجهاز

لاستخدام واجهة برمجة التطبيقات Game Mode API في لعبتك، عليك اتّباع الخطوات التالية:

1. نزِّل حزمة تطوير البرامج (SDK) لنظام التشغيل Android 13 وثبِّتها.

2. في ملف AndroidManifest.xml، يمكنك الإعلان عن تطبيقك باعتباره لعبة من خلال ضبط السمة appCategory في العنصر <application>:

android:appCategory="game"

1. إجراء طلب بحث عن وضع اللعبة الحالي من خلال إضافة ما يلي إلى نشاطك الرئيسي:

Java

// Only call this for Android 12 and higher devices
if ( Build.VERSION.SDK_INT >= Build.VERSION_CODES.S ) {
  // Get GameManager from SystemService
  GameManager gameManager = Context.getSystemService(GameManager.class);

  // Returns the selected GameMode
  int gameMode = gameManager.getGameMode();
}

Kotlin

// Only call this for Android 12 and higher devices
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
  // Get GameManager from SystemService
  val gameManager: GameManager? = context.getSystemService(Context.GAME_SERVICE) as GameManager?

  // Returns the selected GameMode
  val gameMode = gameManager?.gameMode
}

وضع الألعاب المتوافق	الوصف
غير متاحة	لا تشير اللعبة إلى أنّها توفّر إمكانية استخدام واجهة برمجة التطبيقات Game Mode API، كما أنّها لا تتيح استخدام إمكانية التدخلات من "وضع اللعبة".
عادية	لم يختار المستخدم وضع اللعبة أو الوضع العادي.
الأداء	يوفر هذا الخيار أقل عدد لقطات في الثانية لوقت الاستجابة مقابل تقليل الدقّة وعمر البطارية.
البطارية	توفّر هذه الميزة أطول عمر ممكن للبطارية مقابل تقليل الدقة أو عدد اللقطات في الثانية.

ملاحظة مُهمّة: يرتبط وضع "توفير شحن البطارية" بالألعاب ولا يؤثر في سلوك ميزة "توفير شحن البطارية" على مستوى النظام في Android.

1. أضِف رمزًا لطلب البحث عن حالة وضع اللعبة في دالة onResume:

   

ملاحظة مهمة: يجب أن يستفسر تطبيقك دائمًا عن طريقة getGameMode() عند استئناف عملية إيقاف مؤقت. راجِع الرسم البياني أعلاه لمعرفة التفاصيل.

أفضل الممارسات

إذا كانت لعبتك توفّر أهدافًا متعددة للدقة وعدد اللقطات في الثانية، عليك تحديد الإعدادات المناسبة لأوضاع الأداء وتوفير شحن البطارية:

• لتحقيق الحد الأقصى لعدد اللقطات في الثانية بشكل مستمر، ننصحك بمراعاة انخفاضات طفيفة في الدقّة لتحقيق معدّل أعلى للقطات في الثانية.

• لتحسين عمر البطارية، يمكنك اختيار معدّل أقل لإعادة تحميل الشاشة (مثلاً 30 هرتز أو 60 هرتز) واستخدام وتيرة الإطار لاستهداف المعدّل المنخفض.

بالنسبة إلى الألعاب العالية الدقة، مثل ألعاب الرماية من منظور البطل، وساحات القتال المتعددة اللاعبين على الإنترنت (MOBA)، وألعاب تقمّص الأدوار، عليك التركيز على تحقيق عدد لقطات عالٍ من اللقطات المتسقة لتعزيز تفاعل المستخدمين مع اللعبة.

بالنسبة إلى الألعاب العادية والعالية الدقة، يجب استخدام وضع "توفير شحن البطارية" لإطالة وقت اللعب من خلال خفض عدد اللقطات في الثانية ذروته.

توضيح إتاحة "أوضاع الألعاب"

لتقديم بيان عن إتاحة "أوضاع الألعاب" وإلغاء أي تدخلات من المصنّعين الأصليين للأجهزة ، يجب أولاً إضافة إعدادات "وضع اللعبة" إلى العنصر <application> في ملف AndroidManifest.xml:

<application>
    <meta-data android:name="android.game_mode_config"
               android:resource="@xml/game_mode_config" />
  ...
</application>

بعد ذلك، أنشئ ملف game_mode_config.xml في دليل res/xml/ لمشروعك يتضمّن المحتوى التالي:

<?xml version="1.0" encoding="UTF-8"?>
<game-mode-config
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:supportsBatteryGameMode="true"
    android:supportsPerformanceGameMode="true"
/>

ملاحظة مهمة: إذا أعلنت لعبتك أنّها توفّر "وضع ألعاب"، يجب أن تنفِّذ اللعبة تحسينًا خاصًا بها. نتيجةً لذلك، يعيد النظام الأساسي ضبط أي تدخلات سابقة من "وضع الألعاب" نفّذها المصنّعون الأصليون للأجهزة.

تبديل أوضاع الألعاب

للتبديل بين أوضاع الألعاب، يمكنك استخدام "لوحة بيانات الألعاب" (المتوفّرة على أجهزة Pixel) أو تطبيقات مشابهة يوفّرها المصنّعون الأصليون للأجهزة. وبدلاً من ذلك، يمكنك استخدام أمر "وضع الألعاب" في مرحلة التطوير.

إذا كنت تستخدم "لوحة بيانات الألعاب" ولم يظهر رمز التحسين عند إطلاق اللعبة، قد تحتاج إلى تحميل التطبيق إلى Google Play Console وتثبيته من خلال "متجر Play". للحصول على معلومات حول اختبار التطبيقات في "متجر Play"، يُرجى الاطّلاع على مشاركة حِزم التطبيقات وحِزم APK مع الفريق الداخلي.

الشكل 1. لوحة بيانات الألعاب تظهر فوق اللعبة الجارية على جهاز Pixel.

في الشكل 1، يمكن تغيير وضع الألعاب في لعبة الجري من أداة "التحسين". كما هو موضّح في الأداة، تعمل اللعبة حاليًا في وضع PERFORMANCE.

أثناء عملية التطوير، إذا كنت تستخدم جهازًا لا يتضمن "لوحة بيانات اللعبة" ولم توفِّر الشركة المصنّعة أي طريقة لضبط "وضع الألعاب" لكل تطبيق، يمكنك تغيير حالة "وضع اللعبة" من خلال adb:

adb shell cmd game mode [standard|performance|battery] <PACKAGE_NAME>

تطبيق نموذجي

يُلقي نموذج واجهة برمجة التطبيقات Game Mode API الضوء على كيفية تحسين عدد اللقطات في الثانية والحد الأقصى لدقة العرض، وذلك لتوفير ما يقرب من% 25 من الطاقة في تطبيقاتك.

التالي

اقرأ التدخلات من وضع الألعاب لتحسين أداء اللعبة عندما لا يكون من الممكن تقديم تحديثات لها.