MobileAds
类为 Google 移动广告 SDK 提供了全局设置。
视频广告音量控制
如果您的应用有自己的音量控件(例如自定义的音乐或音效音量),那么向 Google 移动广告 SDK 报告应用的音量后,视频广告便可以遵循应用的音量设置。这样可确保用户接收到的视频广告的音量符合预期。
设备音量由音量按钮或操作系统级的音量滑块控制,决定了设备音频输出的音量。不过,应用可相对于设备音量独立调整音量水平,以定制音频体验。对于开屏广告、横幅广告、插页式广告、激励广告和插页式激励广告格式,您可以通过静态 setAppVolume()
方法向 SDK 报告相对的应用音量。广告音量的有效值范围为 0.0
(静音)到 1.0
(当前设备音量)。以下示例展示了如何向 SDK 报告相对的应用音量:
Java
@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_my); new Thread( () -> { // Initialize the 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(); }
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) val backgroundScope = CoroutineScope(Dispatchers.IO) backgroundScope.launch { // Initialize the 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) } }
如需通知 SDK 应用已静音,请使用 setAppMuted()
方法:
Java
MobileAds.setAppMuted(true);
Kotlin
MobileAds.setAppMuted(true)
默认情况下,应用音量设置为 1
(当前设备音量),应用不会设为静音。
原生广告
如需了解如何控制静音设置,请参阅 VideoOptions
。原生广告目前不支持自定义音量控制。
使用 Cookie 征得用户同意
如果您的应用有特殊要求,您可以设置可选的 SharedPreferences
gad_has_consent_for_cookies
。当 gad_has_consent_for_cookies
偏好设置设为 0 时,SDK 将启用
受限广告 (LTD)
。
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()