Класс MobileAds предоставляет глобальные настройки для Google Mobile Ads SDK.
Регулировка громкости видеорекламы
Если в вашем приложении есть собственные регуляторы громкости (например, пользовательская музыка или звуковые эффекты), предоставление данных о громкости приложения в Google Mobile Ads SDK позволит видеорекламе учитывать настройки громкости приложения. Это гарантирует, что пользователи будут видеть видеорекламу с ожидаемой громкостью звука.
Громкость звука устройства, управляемая кнопками регулировки громкости или ползунком на уровне ОС, определяет громкость звука устройства. Однако приложения могут самостоятельно регулировать громкость относительно громкости устройства, чтобы адаптировать звучание. Для форматов рекламы при открытии приложения, баннеров, полноэкранных объявлений, объявлений с вознаграждением и полноэкранных объявлений с вознаграждением вы можете сообщить SDK относительную громкость приложения с помощью статического метода setAppVolume() . Допустимые значения громкости рекламы находятся в диапазоне от 0.0 (без звука) до 1.0 (текущая громкость устройства). Вот пример того, как сообщить SDK относительную громкость приложения:
Котлин
overridefunonCreate(savedInstanceState:Bundle?){super.onCreate(savedInstanceState)valbackgroundScope=CoroutineScope(Dispatchers.IO)backgroundScope.launch{// Initialize Google Mobile Ads SDK on a background thread.MobileAds.initialize(this@MainActivity){}// Set app volume to be half of current device volume.MobileAds.setAppVolume(0.5f)}}
Ява
@OverrideprotectedvoidonCreate(BundlesavedInstanceState){super.onCreate(savedInstanceState);newThread(()->{// Initialize Google Mobile Ads SDK on a background thread.MobileAds.initialize(this,initializationStatus->{});// Set app volume to be half of current device volume.MobileAds.setAppVolume(0.5f);}).start();}
Чтобы сообщить SDK об отключении звука приложения, используйте метод setAppMuted() :
Котлин
MobileAds.setAppMuted(true)
Ява
MobileAds.setAppMuted(true);
По умолчанию громкость приложения установлена на 1 (текущая громкость устройства), и приложение не отключается.
Нативная реклама
Инструкции по управлению настройками отключения звука см. в разделе VideoOptions . Для нативной рекламы индивидуальная регулировка громкости не поддерживается.
Согласие на файлы cookie
Если у вашего приложения особые требования, вы можете установить необязательный параметр SharedPreferencesgad_has_consent_for_cookies . SDK включит ограниченный показ рекламы (LTD) , если параметр gad_has_consent_for_cookies установлен в нулевое значение.
Котлин
valsharedPrefs=PreferenceManager.getDefaultSharedPreferences(context)// Set the value to 0 to enable limited ads.sharedPrefs.edit().putInt("gad_has_consent_for_cookies",0).apply()
Ява
Contextactivity=getActivity();SharedPreferencessharedPreferences=PreferenceManager.getDefaultSharedPreferences(activity);// Set the value to 0 to enable limited ads.sharedPreferences.edit().putInt("gad_has_consent_for_cookies",0).apply();
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-09-03 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eMobileAds\u003c/code\u003e class provides global settings for the Google Mobile Ads SDK, including video ad volume and consent for cookies.\u003c/p\u003e\n"],["\u003cp\u003eYou can control video ad volume by setting the app volume relative to the device volume using \u003ccode\u003eMobileAds.setAppVolume()\u003c/code\u003e and muting with \u003ccode\u003eMobileAds.setAppMuted()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eIf your app has special requirements for cookies, you can enable limited ads by setting the \u003ccode\u003egad_has_consent_for_cookies\u003c/code\u003e SharedPreference to 0.\u003c/p\u003e\n"],["\u003cp\u003eNative ads have separate video options and do not support custom volume control.\u003c/p\u003e\n"]]],["The `MobileAds` class manages the Google Mobile Ads SDK settings. Apps can adjust video ad volume by using `setAppVolume()`, with values from 0.0 (silent) to 1.0 (device volume), ensuring video ads respect app volume. `setAppMuted()` mutes the app volume. For limited ads (LTD), setting the `gad_has_consent_for_cookies` preference to 0 enables them. The SDK default volume is 1, and the app is not muted initially. Native ads have distinct volume controls, via `VideoOptions`.\n"],null,["Select platform: [Android](/admob/android/global-settings \"View this page for the Android platform docs.\") [iOS](/admob/ios/global-settings \"View this page for the iOS platform docs.\") [Unity](/admob/unity/global-settings \"View this page for the Unity platform docs.\")\n\n\u003cbr /\u003e\n\nThe `MobileAds` class provides global settings for Google Mobile Ads SDK.\n\nVideo ad volume control\n\nIf your app has its own volume controls (such as custom music or sound effect\nvolumes), disclosing app volume to Google Mobile Ads SDK allows video ads to\nrespect app volume settings. This ensures users receive video ads with the\nexpected audio volume.\n\nThe device volume, controlled through volume buttons or OS-level volume slider,\ndetermines the volume for device audio output. However, apps can independently\nadjust volume levels relative to the device volume to tailor the audio\nexperience. For app open, banner, interstitial, rewarded, and rewarded\ninterstitial ad formats, you can report the relative app volume to the SDK\nthrough the static `setAppVolume()` method. Valid ad volume values range from\n`0.0` (silent) to `1.0` (current device volume). Here's an example of how to\nreport the relative app volume to the SDK: \n\nKotlin \n\n override fun onCreate(savedInstanceState: Bundle?) {\n super.onCreate(savedInstanceState)\n\n val backgroundScope = CoroutineScope(Dispatchers.IO)\n backgroundScope.launch {\n // Initialize Google Mobile Ads SDK on a background thread.\n MobileAds.initialize(this@MainActivity) {}\n \n // Set app volume to be half of current device volume.\n MobileAds.setAppVolume(0.5f)\n }\n }\n\nJava \n\n @Override\n protected void onCreate(Bundle savedInstanceState) {\n super.onCreate(savedInstanceState);\n\n new Thread(\n () -\u003e {\n // Initialize Google Mobile Ads SDK on a background thread.\n MobileAds.initialize(this, initializationStatus -\u003e {});\n \n // Set app volume to be half of current device volume.\n MobileAds.setAppVolume(0.5f);\n })\n .start();\n }\n\nTo inform the SDK that the app volume has muted, use the `setAppMuted()`\nmethod: \n\nKotlin \n\n MobileAds.setAppMuted(true)\n\nJava \n\n MobileAds.setAppMuted(true);\n\nBy default, the app volume is set to `1` (the current device volume), and the\napp is not muted.\n| **Note:** Video ads that are ineligible to be shown with muted audio are not returned for ad requests made when the app volume is reported as muted or set to a value of `0`. This may restrict a subset of the broader video ads pool from serving.\n\nNative ads\n\nSee\n[`VideoOptions`](/admob/android/native/video-ads#videooptions)\nfor instructions on how to control the mute settings. Custom volume control is\nnot supported for native ads.\n\nConsent for cookies\n\nIf your app has special requirements, you can set the optional\n[`SharedPreferences`](//developer.android.com/reference/android/content/SharedPreferences)\n`gad_has_consent_for_cookies`. The SDK will enable\n\n[limited ads (LTD)](//support.google.com/admob/answer/10105530)\n\nwhen the `gad_has_consent_for_cookies` preference is set to zero. \n\nKotlin \n\n val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context)\n // Set the value to 0 to enable limited ads.\n sharedPrefs.edit().putInt(\"gad_has_consent_for_cookies\", 0).apply()\n\nJava \n\n Context activity = getActivity();\n SharedPreferences sharedPreferences =\n PreferenceManager.getDefaultSharedPreferences(activity);\n // Set the value to 0 to enable limited ads.\n sharedPreferences.edit().putInt(\"gad_has_consent_for_cookies\", 0).apply();"]]