Global ayarlar

MobileAds sınıfı, GMA Next-Gen SDK için genel ayarlar sağlar.

Video reklam ses düzeyi kontrolü

Uygulamanızın kendi ses seviyesi kontrolleri (özel müzik veya ses efekti gibi) varsa uygulama ses seviyesini GMA Next-Gen SDK ile paylaşmak, video reklamların uygulamadaki ses seviyesi ayarlarına uymasına olanak tanır. Bu sayede kullanıcılar video reklamları beklenen ses düzeyinde alır.

Ses düğmeleri veya işletim sistemi düzeyindeki ses düzeyi kaydırıcısı aracılığıyla kontrol edilen cihaz ses düzeyi, cihaz ses çıkışının ses düzeyini belirler. Ancak uygulamalar, ses deneyimini özelleştirmek için ses düzeylerini cihazın ses düzeyine göre bağımsız olarak ayarlayabilir. Uygulama açılış, banner, geçiş reklamı, ödüllü ve ödüllü geçiş reklamı biçimleri için statik setUserControlledAppVolume() yöntemiyle göreceli uygulama ses seviyesini SDK'ya bildirebilirsiniz. Geçerli reklam ses düzeyi değerleri 0.0 (sessiz) ile 1.0 (mevcut cihaz ses düzeyi) arasındadır. Göreli uygulama ses düzeyini SDK'ya nasıl bildireceğinize dair bir örneği aşağıda bulabilirsiniz:

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

Java

@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'ya uygulama sesinin kapatıldığını bildirmek için setUserMutedApp() yöntemini kullanın:

Kotlin

MobileAds.setUserMutedApp(true)

Java

MobileAds.setUserMutedApp(true);

Varsayılan olarak, uygulama ses düzeyi 1 (mevcut cihaz ses düzeyi) olarak ayarlanır ve uygulamanın sesi kapatılmaz.

Uygulamanızın özel şartları varsa isteğe bağlı SharedPreferences gad_has_consent_for_cookies ayarını yapabilirsiniz. gad_has_consent_for_cookies tercihi sıfır olarak ayarlandığında SDK, sınırlı reklamları (SR) etkinleştirir.

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