Глобальные настройки

Класс MobileAds предоставляет глобальные настройки для Google Mobile Ads SDK (Legacy).

Управление громкостью видеорекламы

Если в вашем приложении есть отдельная функция управления громкостью (например, функция пользовательской настройки громкости или звуковых эффектов), вы можете сделать так, чтобы громкость видеорекламы зависела от настроек приложения. Для этого нужно передавать в Google Mobile Ads SDK (Legacy) информацию о громкости в приложении. Они нужны, чтобы видеореклама показывалась с тем же уровнем громкости, который задан в приложении.

Громкость звука на устройстве определяется кнопками регулировки громкости или соответствующим ползунком в ОС. Однако приложения могут самостоятельно регулировать уровень громкости относительно громкости устройства, чтобы настроить звук. Для форматов объявлений при запуске приложения, баннеров, межстраничных объявлений, объявлений с вознаграждением и межстраничных объявлений с вознаграждением вы можете передавать в SDK относительную громкость приложения с помощью статического метода setAppVolume(). Допустимые значения громкости: от 0.0 (без звука) до 1.0 (текущая громкость устройства). Вот пример того, как передать в SDK относительную громкость приложения:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)

  val backgroundScope = CoroutineScope(Dispatchers.IO)
  backgroundScope.launch {
    // Initialize Google Mobile Ads SDK (Legacy) 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 (Legacy) on a background thread.
            MobileAds.initialize(this, initializationStatus -> {});
            
            // Set app volume to be half of current device volume.
            MobileAds.setAppVolume(0.5f);
          })
      .start();
}

Чтобы сообщить SDK, что звук в приложении отключен, используйте метод setAppMuted():

Kotlin

MobileAds.setAppMuted(true)

Java

MobileAds.setAppMuted(true);

По умолчанию для приложения используется уровень громкости устройства (1), а звук приложения не отключен.

Нативные объявления

Инструкции по управлению настройками отключения звука приведены в VideoOptions. Специальный регулятор громкости не поддерживается в нативных объявлениях.

Если у вашего приложения есть особые требования, вы можете задать необязательный параметр SharedPreferences gad_has_consent_for_cookies. Если для параметра gad_has_consent_for_cookies задано значение 0, SDK включит ограниченный показ рекламы.

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