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

Выберите платформу: Android iOS Unity Android (устаревшая версия)

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

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

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

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

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

Kotlin

MobileAds.setUserMutedApp(true)

Java

MobileAds.setUserMutedApp(true);

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

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