Paramètres globaux

La classe MobileAds fournit des paramètres généraux pour le SDK Google Mobile Ads.

Contrôle du volume des annonces vidéo

Si votre application dispose de ses propres commandes de volume (telles que des volumes de musique ou d'effet sonore personnalisés), divulguer le volume de l'application au SDK Google Mobile Ads permet aux annonces vidéo de respecter les paramètres de volume de l'application. Ainsi, les utilisateurs reçoivent des annonces vidéo avec le volume audio attendu.

Le volume de l'appareil, contrôlé via les boutons de volume ou le curseur de volume au niveau du système d'exploitation, détermine le volume de la sortie audio de l'appareil. Cependant, les applications peuvent ajuster indépendamment les niveaux de volume en fonction du volume de l'appareil pour personnaliser l'expérience audio. Pour les formats d'annonces à l'ouverture, de bannières, interstitielles, avec récompense et interstitielles avec récompense, vous pouvez signaler le volume d'application relatif au SDK via la méthode statique setAppVolume(). Les valeurs valides pour le volume d'annonces sont comprises entre 0.0 (silencieux) et 1.0 (volume actuel de l'appareil). Voici un exemple de signalement du volume d'application relatif au SDK:

@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);
    ...
}

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)
    ...
}

Pour informer le SDK que le volume de l'application a été coupé, utilisez la méthode setAppMuted():

MobileAds.setAppMuted(true);

MobileAds.setAppMuted(true)

Par défaut, le volume de l'application est défini sur 1 (le volume actuel de l'appareil), et le son de l'application n'est pas coupé.

Annonces natives

Consultez VideoOptions pour savoir comment contrôler les paramètres de désactivation du son. Le contrôle personnalisé du volume n'est actuellement pas compatible avec les annonces natives.

Consentement pour les cookies

Si votre application présente des exigences particulières, vous pouvez définir l'gad_has_consent_for_cookies SharedPreferences (facultatif). Le SDK active les annonces limitées (LTD) lorsque la préférence gad_has_consent_for_cookies est définie sur zéro.

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

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