تنظیمات کلی

کلاس MobileAds تنظیمات سراسری را برای GMA Next-Gen SDK ارائه می‌دهد.

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

اگر برنامه‌تان کنترل‌های میزان صدای خودش را دارد (مانند میزان صدای موسیقی یا جلوه صوتی سفارشی)، شفاف‌سازی میزان صدای برنامه برای GMA Next-Gen SDK به آگهی‌های ویدیویی امکان می‌دهد تنظیمات میزان صدای برنامه را رعایت کنند. این کار تضمین می‌کند که کاربران آگهی‌های ویدیویی را با میزان صدای موردانتظار دریافت کنند.

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

Kotlin

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

  val backgroundScope = CoroutineScope(Dispatchers.IO)
  backgroundScope.launch {
    // Initialize GMA Next-Gen SDK on a background thread.
    MobileAds.initialize(
      this@MainActivity,
      // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
      InitializationConfig.Builder("SAMPLE_APP_ID").build()
    ) {}
    
    // Set app volume to be half of current device volume.
    MobileAds.setUserControlledAppVolume(0.5f)
  }
}

جاوا

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

  new Thread(
          () -> {
            // Initialize GMA Next-Gen SDK on a background thread.
            MobileAds.initialize(
                this,
                // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
                new InitializationConfig.Builder("SAMPLE_APP_ID")
                    .build(),
                initializationStatus -> {
                });
            
            // Set app volume to be half of current device volume.
            MobileAds.setUserControlledAppVolume(0.5f);
          })
      .start();
}

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

Kotlin

MobileAds.setUserMutedApp(true)

جاوا

MobileAds.setUserMutedApp(true);

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

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

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

جاوا

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