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