تنظیمات سراسری

کلاس MobileAds تنظیمات سراسری برای Google Mobile Ads SDK (Legacy) ارائه می‌دهد.

کنترل میزان صدای آگهی ویدیویی

اگر برنامه شما کنترل‌های میزان صدای خود را دارد (مانند میزان صدای موسیقی سفارشی یا جلوه صوتی)، آشکار کردن میزان صدای برنامه به Google Mobile Ads SDK (Legacy) به آگهی‌های ویدیویی امکان می‌دهد تنظیمات میزان صدای برنامه را رعایت کنند. این کار تضمین می‌کند که کاربران آگهی‌های ویدیویی را با حجم صدای موردانتظار دریافت کنند.

میزان صدای دستگاه که ازطریق دکمه‌های صدا یا لغزنده صدای سطح سیستم‌عامل کنترل می‌شود، میزان صدای خروجی صوتی دستگاه را تعیین می‌کند. بااین‌حال، برنامه‌ها می‌توانند به‌طور مستقل سطوح صدا را نسبت به صدای دستگاه تنظیم کنند تا تجربه صوتی را سفارشی کنند. برای قالب‌های آگهی باز کردن برنامه، برنمایی، بینابینی، پاداش‌دار، و بینابینی پاداش‌دار، می‌توانید حجم نسبی برنامه را ازطریق روش ایستا setAppVolume() به «کیت توسعه نرم‌افزار» گزارش کنید. مقادیر معتبر حجم آگهی از 0.0 (بی‌صدا) تا 1.0 (حجم فعلی دستگاه) متغیر است. در اینجا مثالی از نحوه گزارش حجم نسبی برنامه به کیت توسعه نرم‌افزار آورده شده است:

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

برای اطلاع دادن به کیت توسعه نرم‌افزار که صدای برنامه بی‌صدا شده است، از روش setAppMuted() استفاده کنید:

MobileAds.setAppMuted(true)

MobileAds.setAppMuted(true);

به‌طور پیش‌فرض، صدای برنامه روی 1 (صدای فعلی دستگاه) تنظیم می‌شود و برنامه بی‌صدا نمی‌شود.

آگهی‌های بومی

برای دستورالعمل‌های مربوط به نحوه کنترل تنظیمات بی‌صدا کردن، VideoOptions را ببینید. کنترل میزان صدای سفارشی برای آگهی‌های بومی پشتیبانی نمی‌شود.

موافقت با کوکی‌ها

اگر برنامه شما الزامات ویژه‌ای دارد، می‌توانید SharedPreferences gad_has_consent_for_cookies اختیاری را تنظیم کنید. وقتی اولویت gad_has_consent_for_cookies روی صفر تنظیم شود، کیت توسعه نرم‌افزار آگهی‌های محدود (LTD) را فعال می‌کند.

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