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

توفّر فئة 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 (مستوى الصوت الحالي للجهاز)، ولا يتم كتم صوت التطبيق.

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