مجموعة SDK الألعاب الفورية
في هذا القسم، ستجد مرجع API لمجموعة SDK الألعاب الفورية للغة JavaScript. إذا كنت ستبدأ لعبة جديدة، فنوصي دائمًا باستخدام أحدث إصدار من مجموعة SDK. انقر على الزر أدناه لعرض مرجع مجموعة SDK لأحدث إصدار:
مرجع مجموعة SDK الألعاب الفوريةمرجع تكوين الحزمةراجع سجلات التغييرات لمعرفة إصدارات مجموعة SDK الألعاب الفورية المدعومة حاليًا:
الإصدار 7.1
انتقل إلى المستندات المرجعية لمجموعة SDK الألعاب الفورية بالإصدار 7.1
سجل التغييرات
- عرض محتوى الفيديو الأصلي: إضافة واجهات API للتطبيقات لعرض محتوى الفيديو بشكل أصلي.
- API الإعلانات الخلالية بمكافأة: الإعلانات الخلالية بمكافأة هي تنسيق عرض إعلان جديد يمكن لمطوّري الألعاب الفورية الاستفادة منه لتحقيق الأرباح. على عكس إعلانات الفيديو بمكافأة حيث يشترك المستخدم لعرض الإعلان، فإن الإعلانات الخلالية بمكافأة ستحل محل الإعلان الخلالي العادي ويمكن للمستخدم إلغاء الاشتراك. إذا شاهد المستخدم الفيديو بالكامل، فسيحصل على مكافأة داخل اللعبة.
- إعلانات البانر العلوية: تسمح للمطوّرين بعرض إعلانات البانر أعلى اللعبة.
الإصدار 7.0
انتقل إلى المستندات المرجعية لمجموعة SDK الألعاب الفورية بالإصدار 7.0
سجل التغييرات
- الدعوات المخصصة يمكن للاعبين دعوة لاعبين جُدد إلى اللعبة من خلال Messenger. سيرى اللاعبون قسم "دعوة لاعبين جُدد" يتضمن أصدقاءهم الذين لم يجربوا اللعبة بعد. عند النقر على "دعوة"، سيتم إرسال رسالة إلى الأصدقاء لتجربة اللعبة. يمكن للاعبين إرسال العديد من الدعوات في وقت واحد. نوفر دليلاً بمزيد من المعلومات هنا.
- الاستجابة الحسية تدعم الألعاب الفورية الآن الاستجابة الحسية على أجهزة Android وiOS المزودة بمحرك هزاز مدمج.
- واجهات API البطولات البطولات الفورية هي طريقة رائعة لاكتساب لاعبين جُدد، وطريقة جيدة أيضًا للحفاظ على تفاعل اللاعبين أثناء فترة البطولة (لمدة 7 أيام بشكل افتراضي). يشارك اللاعبون لوحة الصدارة على صفحة اليوميات مع مطالبة للأصدقاء بالانضمام إلى التحدي. يتيح عرض آخر الأخبار، جنبًا إلى جنب مع عمليات إعادة المشاركة من جانب اللاعبين الذين ينضمون، للبطولات اجتياز مخطط الأصدقاء بسرعة لمساعدة اللعبة في اكتساب المزيد من اللاعبين في وقت قصير.
- إزالة واجهات API الإحصاءات تمت إزالة هذه الواجهات لتوفير واجهات API أكثر مرونة فيما يتعلق ببيانات اللاعبين.
- إزالة postSessionScore نوفر
postSessionScoreAsyncكبديل حيث ستوفر معلومات أفضل حول إجراءات المستخدم فيما يتعلق بمربعات الحوار التي تم استدعاؤها عبر API هذه. - إزالة المعلمات غير المستخدمة في shareAsync وupdateAsync تمت إزالة المعلمة INTENT من
shareAsyncنظرًا إلى أنها لم تكن تُستخدم. كما تمت إزالة الاستراتيجية IMMEDIATE_CLEAR منupdateAsyncنظرًا إلى أن لدينا سياسة مطبقة لتقييد التحديثات المخصصة بحيث تشمل تحديثًا واحدًا لكل جلسة سياق. - إعلانات البانر العلوية: تسمح للمطوّرين بعرض إعلانات البانر أعلى اللعبة.
الإصدار 6.3
انتقل إلى المستندات المرجعية لمجموعة SDK الألعاب الفورية بالإصدار 6.3
سجل التغييرات
- (جديد) FBInstant.postSessionScore تسمح API هذه للعبة بتزويد فيسبوك بنتيجة اللاعب من جلسة اللعبة الحالية. سيستخدم فيسبوك إشارات النتائج هذه في عمليات دمج المنصة المختلفة لمساعدة اللاعبين في استكشاف اللعبة والتنافس فيها وإعادة التفاعل معها.
- مطابقة اللاعبين غير المتصلة في السابق، كانت عملية مطابقة اللاعبين متزامنة، ما أدى إلى حظر اللعبة عن اللاعب أثناء الانتظار. يضيف هذا الإصدار خيارًا غير متزامن إلى "matchPlayerAsync". ستتم إضافة اللاعبين الذين يحاولون بدء مباراة من دون اتصال بالإنترنت إلى سلسلة محادثات جماعية على الفور، ويمكن للاعبين مغادرة اللعبة أثناء انتظار انضمام المزيد من اللاعبين. بمجرد المطابقة مع اللاعبين الآخرين، إذا كان اللاعب لا يزال في اللعبة، فستتم إضافته ونقله إلى سياق السلسلة المطابقة.
- واجهات API البيانات للاعب والسياق والإعدادات المحلية ونقطة الإدخال لتصبح قابلة للوصول بعد "initializeAsync" نعمل على إعادة توفير إمكانية الوصول إلى واجهات API البيانات قبل بدء اللعبة! على سبيل المثال، يمكنك الآن الوصول إلى بيانات اللاعب بشأن الإعدادات المحلية أو نقطة الإدخال، أثناء تحميل اللعبة. من المفترض أن يساعد ذلك في تقليل شاشات التحميل الثانوية وإجمالي متطلبات التحميل للألعاب. يتوفر هذا التغيير الآن على الويب وسيتوفر على الهواتف المحمولة بدءًا من الإصدارات التالية: فيسبوك لأجهزة Android بالإصدار 219 وMessenger لأجهزة Android بالإصدار 213 وفيسبوك لأجهزة iOS بالإصدار 222 وMessenger لأجهزة iOS بالإصدار 216. ستعرض إصدارات الهواتف المحمولة الأقدم السلوك السابق، لذلك احرص على التحقق من أي قيم تم تحديثها بعد إزالة "startGameAsync".