通用設定

MobileAds 類別提供 GMA Next-Gen SDK 的全域設定。

影片廣告音量控制選項

如果應用程式有專屬的音量控制項 (例如自訂音樂或音效音量)，請將應用程式音量提供給 GMA Next-Gen SDK，讓影片廣告採用應用程式音量設定。這樣一來，使用者接收到影片廣告時，廣告的音量就會符合預期。

裝置音量由音量鍵或 OS 層級的音量滑桿控制，決定裝置音訊輸出的音量。不過，應用程式可以根據裝置音量獨立調整音量，打造專屬的音訊體驗。如果是應用程式開啟頁面、橫幅、插頁式、獎勵和插頁式獎勵廣告格式，您可以透過靜態 setUserControlledAppVolume() 方法，向 SDK 回報相對應用程式音量。有效廣告音量值的範圍為 0.0 (靜音) 到 1.0 (目前裝置音量)。以下範例說明如何向 SDK 回報相對應用程式音量：

Kotlin

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

  val backgroundScope = CoroutineScope(Dispatchers.IO)
  backgroundScope.launch {
    // Initialize GMA Next-Gen SDK on a background thread.
    MobileAds.initialize(
      this@MainActivity,
      // Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713
      InitializationConfig.Builder("SAMPLE_APP_ID").build()
    ) {}
    
    // Set app volume to be half of current device volume.
    MobileAds.setUserControlledAppVolume(0.5f)
  }
}

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);

  new Thread(
          () -> {
            // Initialize GMA Next-Gen SDK on a background thread.
            MobileAds.initialize(
                this,
                // Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713
                new InitializationConfig.Builder("SAMPLE_APP_ID")
                    .build(),
                initializationStatus -> {
                });
            
            // Set app volume to be half of current device volume.
            MobileAds.setUserControlledAppVolume(0.5f);
          })
      .start();
}

如要通知 SDK 應用程式音量已靜音，請使用 setUserMutedApp() 方法：

Kotlin

MobileAds.setUserMutedApp(true)

Java

MobileAds.setUserMutedApp(true);

根據預設，應用程式音量會設為 1 (目前裝置音量)，且應用程式不會設為靜音。

如果應用程式有特殊需求，您可以設定選用的 SharedPreferences gad_has_consent_for_cookies。如果 gad_has_consent_for_cookies 偏好設定設為零，SDK 會啟用受限制的廣告 (LTD)。

Kotlin

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

Java

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