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

Выберите платформу: 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 равно нулю, 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();