Configurações globais

A classe MobileAds oferece configurações globais do SDK dos anúncios para dispositivos móveis do Google.

Controle de volume do anúncio em vídeo

Se o app tiver controles de volume próprios, como volumes personalizados de música ou de efeitos sonoros, a divulgação do volume do app para o SDK dos anúncios para dispositivos móveis do Google permitirá que os anúncios em vídeo respeitem as configurações de volume do app. Isso garante que os usuários recebam anúncios em vídeo com o volume de áudio esperado.

O volume do dispositivo, controlado pelos botões de volume ou pelo controle deslizante de volume no nível do SO, determina o volume da saída de áudio do dispositivo. No entanto, os apps podem ajustar os níveis de volume de forma independente em relação ao volume do dispositivo para personalizar a experiência de áudio. Para formatos de anúncio de abertura do app, banner, intersticial, premiado e intersticial, é possível informar o volume relativo do app ao SDK usando o método setAppVolume() estático. Os valores de volume do anúncio válidos vão de 0.0 (silencioso) a 1.0 (volume atual do dispositivo). Veja um exemplo de como informar o volume relativo do app ao SDK:

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_my);
    
    MobileAds.initialize(this, new OnInitializationCompleteListener() {
        @Override
        public void onInitializationComplete(InitializationStatus initializationStatus) {}
    });
    
    // Set app volume to be half of current device volume.
    MobileAds.setAppVolume(0.5f);
    ...
}

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    
    MobileAds.initialize(this) {}
    
    // Set app volume to be half of current device volume.
    MobileAds.setAppVolume(0.5f)
    ...
}

Para informar o SDK de que o volume do app foi desativado, use o método setAppMuted():

Java

MobileAds.setAppMuted(true);

Kotlin

MobileAds.setAppMuted(true)

Por padrão, o volume do app é definido como 1 (o volume atual do dispositivo), e o app não é silenciado.

Anúncios nativos

Consulte VideoOptions para ver instruções sobre como controlar as configurações de silenciamento. No momento, o controle de volume personalizado não é compatível com anúncios nativos.

Se o app tiver requisitos especiais, você pode definir o gad_has_consent_for_cookies opcional SharedPreferences. O SDK vai ativar anúncios limitados (LTD) quando a preferência gad_has_consent_for_cookies estiver definida como zero.

Java

Context activity = getActivity();
SharedPreferences sharedPreferences =
  PreferenceManager.getDefaultSharedPreferences(activity);
sharedPreferences.edit().putInt("gad_has_consent_for_cookies", 0).apply();

Kotlin

val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context)
sharedPrefs.edit().putInt("gad_has_consent_for_cookies", 0).apply()