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

يوفّر الصف MobileAds إعدادات عامة لحزمة "SDK لإعلانات Google على الأجهزة الجوّالة".

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

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

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

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)

  val backgroundScope = CoroutineScope(Dispatchers.IO)
  backgroundScope.launch {
    // Initialize the Google Mobile Ads SDK on a background thread.
    MobileAds.initialize(this@MainActivity) {}
    
    // Set app volume to be half of current device volume.
    MobileAds.setAppVolume(0.5f)
  }
}

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);

  new Thread(
          () -> {
            // Initialize the Google Mobile Ads SDK on a background thread.
            MobileAds.initialize(this, initializationStatus -> {});
            
            // Set app volume to be half of current device volume.
            MobileAds.setAppVolume(0.5f);
          })
      .start();
}

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

Kotlin

MobileAds.setAppMuted(true)

Java

MobileAds.setAppMuted(true);

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

إعلانات مدمجة مع المحتوى

اطّلِع على VideoOptions للحصول على تعليمات حول كيفية التحكّم في إعدادات كتم الصوت. لا تتوفّر عناصر التحكّم المخصّصة بمستوى الصوت للإعلانات المدمجة.

إذا كان تطبيقك يتضمّن متطلبات خاصة، يمكنك ضبط SharedPreferences gad_has_consent_for_cookies الاختياري. ستفعّل حزمة SDK الإعلانات المحدودة (LTD) عندما يتم ضبط قيمة الإعداد المفضّل gad_has_consent_for_cookies على صفر.

Kotlin

val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context)
// Set the value to 0 to enable limited ads.
sharedPrefs.edit().putInt("gad_has_consent_for_cookies", 0).apply()

Java

Context activity = getActivity();
SharedPreferences sharedPreferences =
  PreferenceManager.getDefaultSharedPreferences(activity);
// Set the value to 0 to enable limited ads.
sharedPreferences.edit().putInt("gad_has_consent_for_cookies", 0).apply();