Impostazioni globali

La classe MobileAds fornisce le impostazioni globali per l'SDK Google Mobile Ads.

Controllo del volume degli annunci video

Se la tua app ha i propri controlli del volume (ad esempio volumi di musica o effetti sonori personalizzati), la comunicazione del volume dell'app all'SDK Google Mobile Ads consente agli annunci video di rispettare le impostazioni di volume dell'app. In questo modo, gli utenti ricevono annunci video con il volume audio previsto.

Il volume del dispositivo, controllato tramite i pulsanti del volume o il dispositivo di scorrimento del volume a livello di sistema operativo, determina il volume dell'uscita audio del dispositivo. Tuttavia, le app possono regolare in modo indipendente i livelli del volume in base al volume del dispositivo per personalizzare l'esperienza audio. Per i formati di annunci apertura app, banner, interstitial, con premio e interstitial con premio, puoi segnalare all'SDK il volume relativo dell'app tramite il metodo setAppVolume() statico. I valori validi per il volume degli annunci sono compresi tra 0.0 (senza audio) e 1.0 (volume attuale del dispositivo). Ecco un esempio di come segnalare il volume relativo di app all'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)
    ...
}

Per comunicare all'SDK che il volume dell'app è stato disattivato, utilizza il metodo setAppMuted():

Java

MobileAds.setAppMuted(true);

Kotlin

MobileAds.setAppMuted(true)

Per impostazione predefinita, il volume dell'app è impostato su 1 (il volume attuale del dispositivo) e l'audio dell'app non è disattivato.

Annunci nativi

Consulta la pagina VideoOptions per istruzioni su come controllare le impostazioni di disattivazione audio. Il controllo personalizzato del volume non è attualmente supportato per gli annunci nativi.

Se la tua app ha requisiti speciali, puoi impostare il valore facoltativo SharedPreferences gad_has_consent_for_cookies. L'SDK attiverà annunci con limitazioni (LTD) se la preferenza gad_has_consent_for_cookies è impostata su 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()