إعدادات عامة

توفّر فئة MobileAds إعدادات عامة لـ Google Mobile Ads SDK (Legacy).

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

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

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

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

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

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

  new Thread(
          () -> {
            // Initialize Google Mobile Ads SDK (Legacy) 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():

MobileAds.setAppMuted(true)

MobileAds.setAppMuted(true);

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

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

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

الموافقة على ملفات تعريف الارتباط

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

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

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();