全局设置

MobileAds 类为 Google 移动广告 SDK 提供了全局设置。

如果您的应用有自己的音量控制,例如自定义的音乐或音效音量,那么向 Google 移动广告 SDK 报告应用的音量后,视频广告会遵循相关的应用音量设置。这可确保用户收到符合预期的视频广告音量。

设备音量由音量按钮或操作系统级的音量滑块控制,它决定了设备的音频输出音量。但是,应用可相对于该设备音量独立调节自己的音量水平,从而定制音频体验。对于开屏广告、横幅广告、插页式广告、激励广告和插页式激励广告格式,您可以通过静态 setAppVolume() 方法向 SDK 报告相对的应用音量。广告音量的有效值范围为 0.0(静音)至 1.0(当前设备音量)。以下示例展示了如何将相对的应用音量报告给该 SDK:

override fun onCreate(savedInstanceState: Bundle?) {
 
super.onCreate(savedInstanceState)

 
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)
 
}
}
@Override
protected void onCreate(Bundle savedInstanceState) {
 
super.onCreate(savedInstanceState);

 
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();
}

如需向 SDK 通知应用已静音,请使用 setAppMuted() 方法:

MobileAds.setAppMuted(true)
MobileAds.setAppMuted(true);

应用音量的默认设置为 1(当前设备音量),且应用不是静音状态。

原生广告

如需了解如何控制静音设置,请参阅 VideoOptions。原生广告不支持自定义音量控制。

如果您的应用有特殊要求,您可以设置可选的 SharedPreferences gad_has_consent_for_cookies。当 gad_has_consent_for_cookies 偏好设置设为 0 时,SDK 将会启用受限广告 (LTD)

val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context)
// Set the value to 0 to enable limited ads.
sharedPrefs
.edit().putInt("gad_has_consent_for_cookies", 0).apply()
Context activity = getActivity();
SharedPreferences sharedPreferences =
 
PreferenceManager.getDefaultSharedPreferences(activity);
// Set the value to 0 to enable limited ads.
sharedPreferences
.edit().putInt("gad_has_consent_for_cookies", 0).apply();