Globale Einstellungen

Die Klasse MobileAds stellt globale Einstellungen für das Google Mobile Ads SDK bereit.

Lautstärkeregelung für Videoanzeigen

Wenn Ihre App über eigene Lautstärkeregler verfügt (z. B. benutzerdefinierte Lautstärken für Musik oder Soundeffekte) und die App-Lautstärke im Google Mobile Ads SDK offenzulegen, können Videoanzeigen die App-Lautstärkeeinstellungen übernehmen. Nutzer erhalten dann Videoanzeigen mit der erwarteten Audiolautstärke.

Die Gerätelautstärke wird über die Lautstärketasten oder den Lautstärkeregler auf Betriebssystemebene gesteuert und bestimmt die Lautstärke der Audioausgabe des Geräts. Apps können die Lautstärke jedoch unabhängig von der Gerätelautstärke anpassen, um die Audioqualität anzupassen. Bei App-Start-Anzeigen, Bannern, Interstitials, Anzeigen mit Prämie und Interstitial-Anzeigen mit Prämie können Sie das relative App-Volumen über die statische setAppVolume()-Methode an das SDK melden. Gültige Werte für das Anzeigenvolumen reichen von 0.0 (Lautlos) bis 1.0 (aktuelle Gerätelautstärke). Hier ein Beispiel, wie Sie das relative App-Volumen an das SDK melden:

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  setContentView(R.layout.activity_my);

  new Thread(
          () -> {
            // Initialize the Google Mobile Ads SDK on a background thread.
            MobileAds.initialize(this, initializationStatus -> {});
            // Set app volume to be half of current device volume.
            MobileAds.setAppVolume(0.5f);
          })
      .start();
}

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  setContentView(R.layout.activity_main)

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

Mit der Methode setAppMuted() teilen Sie dem SDK mit, dass das App-Volume stummgeschaltet wurde:

Java

MobileAds.setAppMuted(true);

Kotlin

MobileAds.setAppMuted(true)

Standardmäßig ist die App-Lautstärke auf 1 (die aktuelle Gerätelautstärke) eingestellt und die App ist nicht stummgeschaltet.

Hinweis :Videoanzeigen, die nicht mit stummgeschaltetem Audio ausgeliefert werden können, werden nicht bei Anzeigenanfragen zurückgegeben, bei denen die App-Lautstärke als stummgeschaltet gemeldet oder auf den Wert 0 eingestellt ist. Dadurch kann ein Teil des gesamten Videoanzeigenpools nicht ausgeliefert werden.

Native Anzeigen

Eine Anleitung zum Steuern der Stummschaltungseinstellungen finden Sie unter VideoOptions. Die benutzerdefinierte Lautstärkeregelung wird für native Anzeigen derzeit nicht unterstützt.

Einwilligung zur Verwendung von Cookies

Wenn deine App besondere Anforderungen hat, kannst du das optionale SharedPreferences gad_has_consent_for_cookies festlegen. Das SDK aktiviert Eingeschränkte Anzeigenausrichtung , wenn die Einstellung gad_has_consent_for_cookies auf null gesetzt ist.

Java

Context activity = getActivity();
SharedPreferences sharedPreferences =
  PreferenceManager.getDefaultSharedPreferences(activity);
sharedPreferences.edit().putInt("gad_has_consent_for_cookies", 0).apply();

Kotlin

val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context)
sharedPrefs.edit().putInt("gad_has_consent_for_cookies", 0).apply()