إعدادات عمومية

توفّر الفئة MobileAds إعدادات عامة لحزمة تطوير البرامج (SDK) لعرض الإعلانات على الأجهزة الجوّالة.

التحكّم في مستوى صوت إعلانات الفيديو

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

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

يمكنك إعداد تقرير عن الحجم النسبي للتطبيق ضمن حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" من خلال طلب طريقة SetApplicationVolume(). تتراوح القيم الصالحة لحجم الإعلانات بين 0.0 (صامت) إلى 1.0 (مستوى الصوت الحالي للجهاز). إليك مثال على كيفية الإبلاغ الحجم النسبي للتطبيق على حزمة SDK:

    // Set app volume to be half of current device volume.
    MobileAds.SetApplicationVolume(0.5f);

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

لإبلاغ حزمة SDK بأنّه تم كتم صوت التطبيق، استخدِم طريقة SetApplicationMuted():

    // Set app to be muted.
    MobileAds.SetApplicationMuted(true);

يتم ضبط مستوى صوت التطبيق تلقائيًا على 1 (مستوى الصوت الحالي على الجهاز) عدم كتم صوت التطبيق

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