Globale Einstellungen

Plattform auswählen: Android (Beta) Neu Android iOS Unity

Die Klasse MobileAds enthält globale Einstellungen für Google Mobile Ads SDK.

Lautstärkeregelung für Videoanzeigen

Wenn in Ihrer App die Lautstärke separat eingestellt werden kann, z. B. für Musik oder Toneffekte, können Sie die App-Lautstärke an das Google Mobile Ads SDK weitergeben, damit Videoanzeigen an die jeweils gewählte Lautstärke angepasst werden. So sehen Nutzer Videoanzeigen in der erwarteten Lautstärke.

Die Gerätelautstärke, die über die Lautstärketasten oder den Lautstärkeregler auf Betriebssystemebene gesteuert wird, bestimmt die Lautstärke für die Audioausgabe des Geräts. Apps können jedoch die Lautstärke unabhängig von der Gerätelautstärke anpassen, um das Audioerlebnis zu optimieren. Für die Anzeigenformate App-Start-Anzeigen, Banner- und Interstitial-Anzeigen sowie Anzeigen mit Prämie und Interstitial-Anzeigen mit Prämie können Sie die relative App-Lautstärke über die statische Methode setAppVolume() an das SDK melden. Gültige Werte für die Anzeigenlautstärke reichen von 0.0 (stumm) bis 1.0 (aktuelle Gerätelautstärke). Hier ein Beispiel für die Meldung der relativen App-Lautstärke an das SDK:

Kotlin

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

  val backgroundScope = CoroutineScope(Dispatchers.IO)
  backgroundScope.launch {
    // Initialize 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)
  }
}

Java

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

  new Thread(
          () -> {
            // Initialize 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();
}

Verwenden Sie die Methode setAppMuted(), um dem SDK mitzuteilen, dass die App-Lautstärke stummgeschaltet wurde:

Kotlin

MobileAds.setAppMuted(true)

Java

MobileAds.setAppMuted(true);

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

Native Anzeigen

Siehe VideoOptions für Anweisungen zum Steuern der Stummschaltungseinstellungen. Die benutzerdefinierte Lautstärkeregelung wird für native Anzeigen nicht unterstützt.

Wenn Ihre App spezielle Anforderungen hat, können Sie die optionale SharedPreferences gad_has_consent_for_cookies festlegen. Das SDK aktiviert eingeschränkte Anzeigen , wenn die Einstellung gad_has_consent_for_cookies auf null gesetzt ist.

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