Globale Einstellungen

Die Klasse MobileAds bietet globale Einstellungen für das 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 festlegen, dass Videoanzeigen an die jeweils gewählte Lautstärke angepasst werden. So werden Nutzern Videoanzeigen in der erwarteten Lautstärke präsentiert.

Die Lautstärke des Geräts, 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 unabhängig voneinander die Lautstärkepegel relativ zur 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 die Lautstärke von Anzeigen reichen von 0.0 (stumm) bis 1.0 (aktuelle Gerätelautstärke). 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 AdMob 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 AdMob 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 setUserMutedApp()-Methode, um das SDK darüber zu informieren, dass die Lautstärke der App 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.

Hinweis :Videoanzeigen, die nicht mit stummgeschalteten Audioinhalten ausgeliefert werden dürfen, werden nicht für Anzeigenanfragen zurückgegeben, die gestellt werden, wenn die App-Lautstärke als stummgeschaltet gemeldet oder auf den Wert 0 festgelegt ist. Dadurch wird möglicherweise die Auslieferung einer Teilmenge des gesamten Pools von Videoanzeigen eingeschränkt.

Einwilligung für Cookies

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