Globale Einstellungen

Plattform auswählen: Android iOS Unity Android (Legacy)

Die Klasse MobileAds enthält globale Einstellungen für GMA Next-Gen 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 festlegenGMA Next-Gen SDK, dass Videoanzeigen an die jeweils gewählte Lautstärke angepasst werden. So werden Videoanzeigen in der erwarteten Lautstärke ausgeliefert.

Die Lautstärke für die Audioausgabe von Geräten wird über die Gerätelautstärke gesteuert, die über die Lautstärketasten oder den Lautstärkeregler auf Betriebssystemebene eingestellt wird. Apps können die Lautstärkepegel jedoch unabhängig von der Gerätelautstärke anpassen, um das Audioerlebnis zu optimieren. Bei den Anzeigenformaten App-Start-Anzeigen, Banner- und Interstitial-Anzeigen sowie Anzeigen mit Prämie und Interstitial-Anzeigen mit Prämie können Sie das relative App-Volumen über die statische Methode setUserControlledAppVolume() an das SDK melden. Gültige Werte für das Anzeigenvolumen reichen von 0.0 (lautlos) bis 1.0 (aktuelles Gerätevolumen). Hier sehen Sie ein Beispiel dafür, wie Sie das relative App-Volumen an das SDK melden:

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 Ad Manager 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 Ad Manager 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();
}

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

Kotlin

MobileAds.setUserMutedApp(true)

Java

MobileAds.setUserMutedApp(true);

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

Wenn Ihre App spezielle Anforderungen hat, können Sie die optionale SharedPreferences gad_has_consent_for_cookies festlegen. Das SDK aktiviert eingeschränkte Anzeigen (Limited Ads, LTD), 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();