全局设置

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。原生广告目前不支持自定义音量控制。

如果您的应用有特殊要求，您可以设置可选的 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()