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

Выберите платформу: Android (бета-версия) Новоизбранный Android iOS Unity

Класс MobileAds предоставляет глобальные настройки для GMA Next-Gen SDK.

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

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

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

Котлин 

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

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

Котлин 

MobileAds.setUserMutedApp(true)

Java 

MobileAds.setUserMutedApp(true);

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

Если у вашего приложения есть особые требования, вы можете установить необязательный 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()

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