Ustawienia globalne

Klasa MobileAds zawiera ustawienia globalne dla Google Mobile Ads SDK.

Kontrolowanie głośności reklam wideo

Jeśli aplikacja ma własną regulację głośności (np. głośność niestandardowej muzyki lub efektów dźwiękowych), ujawnienie głośności aplikacji pakietowi SDK do reklam mobilnych Google umożliwi reklamom wideo dostosowanie się do ustawień głośności aplikacji.Google Mobile Ads SDK Dzięki temu użytkownicy będą mogli oglądać reklamy wideo z oczekiwanym poziomem głośności.

Głośność urządzenia, kontrolowana za pomocą przycisków głośności lub suwaka głośności na poziomie systemu operacyjnego, określa głośność wyjścia audio urządzenia. Aplikacje mogą jednak niezależnie dostosowywać poziom głośności względem głośności urządzenia, aby dostosować wrażenia dźwiękowe. W przypadku formatów reklam wyświetlanych przy otwarciu aplikacji, banerów, reklam pełnoekranowych, reklam z nagrodą i reklam pełnoekranowych z nagrodą możesz zgłosić względną głośność aplikacji do pakietu SDK za pomocą statycznej metody setAppVolume(). Prawidłowe wartości głośności reklamy mieszczą się w zakresie od 0.0 (cisza) do 1.0 (bieżąca głośność urządzenia). Oto przykład zgłaszania względnej głośności aplikacji do pakietu 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();
}

Aby poinformować pakiet SDK, że głośność aplikacji została wyciszona, użyj metody setAppMuted():

Kotlin

MobileAds.setAppMuted(true)

Java

MobileAds.setAppMuted(true);

Domyślnie głośność aplikacji jest ustawiona na 1 (bieżąca głośność urządzenia), a aplikacja nie jest wyciszona.

Reklamy natywne

Instrukcje dotyczące kontrolowania ustawień wyciszenia znajdziesz w artykule VideoOptions. Niestandardowa regulacja głośności nie jest obsługiwana w przypadku reklam natywnych.

Jeśli Twoja aplikacja ma specjalne wymagania, możesz ustawić opcjonalną SharedPreferences gad_has_consent_for_cookies. Gdy preferencja gad_has_consent_for_cookies jest ustawiona na zero, pakiet SDK włączy ograniczone wyświetlanie reklam.

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