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

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

Регулировка громкости видеорекламы

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

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

Котлин 

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

  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)
  }
}

Ява 

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);

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

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

Котлин 

MobileAds.setAppMuted(true)

Ява 

MobileAds.setAppMuted(true);

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

Нативная реклама

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

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

Котлин 

val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context)
// Set the value to 0 to enable limited ads.
sharedPrefs.edit().putInt("gad_has_consent_for_cookies", 0).apply()

Ява 

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