AdConfig

يُرسِل طلب adConfig() إعدادات اللعبة الحالية إلى واجهة برمجة التطبيقات Ad Placement API. يمكن أن تستخدم واجهة برمجة التطبيقات Ad Placement API هذه المعلومات لضبط طريقة التحميل المُسبَق للإعلانات، ولتصفية أنواع الإعلانات التي تطلبها حتى تكون مناسبة (مثل إعلانات الفيديو التي تتطلّب صوتًا).

توقيع الدالة:

adConfig({
   preloadAdBreaks: 'on|auto',  // Ad preloading strategy
   sound: 'on|off'              // This game has sound
   onReady: () => {},           // Called when API has initialised and adBreak() is ready
});

مَعلمات adConfig

الاسم	النوع	الوصف
sound	سلسلة	(اختياري) يوضّح ما إذا كانت اللعبة تشغّل الصوت حاليًا. القيم: - on (القيمة التلقائية) - off يحدّد هذا الاستدعاء ما إذا كانت لعبتك قادرة على تشغيل الصوت، وما إذا كان الصوت مفعّلاً (أي تم إلغاء كتمه) قبل استدعاء adBreak(). يساعد ذلك واجهة برمجة التطبيقات لمواضع الإعلانات في اختيار نوع الإعلان المناسب للعبتك. استدعِ هذه الدالة فور تغيُّر حالة الصوت في لعبتك، لأنّ واجهة برمجة التطبيقات لمواضع الإعلانات قد تحتاج إلى طلب تصميمات إعلانية جديدة، ويمنحها ذلك أكبر قدر من الوقت لإجراء ذلك. القيمة التلقائية هي "تشغيل الصوت". لذا، ستحتاج معظم الألعاب إلى إجراء طلب إلى adConfig() عند بدء الإعلان عن تفعيل الصوت.
preloadAdBreaks	سلسلة	(اختياري) ما إذا كان يجب دائمًا التحميل المُسبَق للإعلانات قبل إجراء أول طلب إلى adBreak(). القيم: - on - auto (تلقائي) تترك القيمة التلقائية auto القرار لواجهة برمجة التطبيقات لموضع الإعلان. لا يمكن ضبط preloadAdBreaks إلا مرة واحدة باستخدام adConfig()، ولن يكون لأي قيم أخرى يتم تمريرها إلى preloadAdBreaks أي تأثير. لن يكون لضبط preloadAdBreaks بعد طلب adBreak() الأول أي تأثير.
onReady	سلسلة	(اختياري) يتم استدعاؤها عند تهيئة واجهة برمجة التطبيقات والانتهاء من التحميل المُسبَق للإعلانات (في حال طلبت التحميل المُسبَق باستخدام preloadAdBreaks أعلاه).