دعم خدمات ألعاب Google Play

تحذير: لن تعود ميزة "تطبيقات Google Play الفورية" متاحة. اعتبارًا من كانون الأول (ديسمبر) 2025، لن يكون بإمكانك نشر التطبيقات الفورية من خلال Google Play، ولن تعمل واجهات برمجة التطبيقات الفورية في "خدمات Google Play" بعد ذلك. لن يعرض Play "التطبيقات الفورية" للمستخدمين باستخدام أي أسلوب.

نحن بصدد إجراء هذا التغيير استنادًا إلى ملاحظات المطوّرين واستثماراتنا المستمرة لتحسين المنظومة المتكاملة منذ طرح ميزة "تطبيقات Google Play الفورية".

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

يجب أن تتيح جميع ألعاب "التشغيل الفوري" تسجيل الدخول تلقائيًا باستخدام "خدمات ألعاب Google Play". استخدِم "خدمات ألعاب Google Play" لتوفير معرّف لاعب ثابت يمكنك استخدامه لاستعادة مستوى التقدّم المحفوظ من السحابة الإلكترونية.

تأثير حجم المكتبة

يعتمد تأثير حجم مكتبة "خدمات ألعاب Google Play" على ما إذا كان محرك اللعبة يعمل على Unity أو Java أو Native.

Java

يكون تأثير الحجم ضئيلًا لأنّ أداة ProGuard يتم إعلامها بالصفوف المستخدَمة.

Unity

يمكنك دمج ميزة حفظ التقدم في اللعبة في لعبتك على Unity باستخدام المكوّن الإضافي الرسمي لخدمة "ألعاب Google Play". يبلغ تأثير الحجم حوالي 200 كيلوبايت في حال استخدام اقتراحات ProGuard.

مدمجة مع المحتوى

يمكنك دمج ميزة حفظ التقدم في اللعبة مع لعبة تم إنشاؤها باستخدام حزمة Android NDK باستخدام حزمة تطوير البرامج (SDK) الأصلية لخدمة "ألعاب Play".

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

# The native PGS library wraps the Java PGS SDK using reflection.
-dontobfuscate
-keeppackagenames

# Needed for callbacks.
-keepclasseswithmembernames,includedescriptorclasses class * {
    native <methods>;
}

# Needed for helper libraries.
-keep class com.google.example.games.juihelper.** {
  public protected *;
}
-keep class com.sample.helper.** {
  public protected *;
}

# Needed for GoogleApiClient and auth stuff.
-keep class com.google.android.gms.common.api.** {
  public protected *;
}

# Keep all of the "nearby" library, which is needed by the native PGS library
# at runtime (though deprecated).
-keep class com.google.android.gms.nearby.** {
  public protected *;
}

# Keep all of the public PGS APIs.
-keep class com.google.android.gms.games.** {
  public protected *;
}