AdConfig

ينقل طلب adConfig() الإعداد الحالي للعبة إلى واجهة برمجة التطبيقات 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 أعلاه).