Die Klasse MobileAds
bietet globale Einstellungen für das 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 festlegen, dass Videoanzeigen an die jeweils gewählte Lautstärke angepasst werden. Dazu müssen Sie die App-Lautstärke an das Google Mobile Ads SDK weitergeben. 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 der Audioausgabe des Geräts. Apps können die Lautstärke jedoch unabhängig von der Gerätelautstärke anpassen, um das Audioerlebnis anzupassen. Für die Anzeigenformate App-Start-Anzeigen, Banner, Interstitial-Anzeigen, Anzeigen mit Prämie und Interstitial-Anzeigen mit Prämie können Sie das relative App-Volumen über die statische Methode setAppVolume()
an das SDK melden. Gültige Werte für die Lautstärke von Anzeigen reichen von 0.0
(stumm) bis 1.0
(aktuelle Gerätelautstärke). Hier ein Beispiel dafür, wie Sie das relative App-Volume an das SDK melden:
Kotlin
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
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)
}
}
Java
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
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();
}
Um das SDK darüber zu informieren, dass die App-Lautstärke stummgeschaltet wurde, verwende die Methode setAppMuted()
:
Kotlin
MobileAds.setAppMuted(true)
Java
MobileAds.setAppMuted(true);
Standardmäßig ist die App-Lautstärke auf 1
(die aktuelle Gerätelautstärke) eingestellt und die App ist nicht stummgeschaltet.
Native Anzeigen
Eine Anleitung zum Festlegen der Stummschaltungseinstellungen finden Sie unter VideoOptions
. Die benutzerdefinierte Lautstärkeregelung wird für native Anzeigen nicht unterstützt.
Einwilligung zur Verwendung von Cookies
Wenn Ihre App spezielle Anforderungen hat, können Sie die optionale SharedPreferences
gad_has_consent_for_cookies
festlegen. Das SDK aktiviert die eingeschränkte Anzeigenausrichtung, 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();