تنظیمات جهانی

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

کنترل صدای تبلیغات ویدیویی

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

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

کاتلین 

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() استفاده کنید:

کاتلین 

MobileAds.setUserMutedApp(true)

جاوا 

MobileAds.setUserMutedApp(true);

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

اگر برنامه شما الزامات خاصی دارد، می‌توانید تنظیمات اختیاری SharedPreferences gad_has_consent_for_cookies تنظیم کنید. SDK زمانی که تنظیمات 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();