通用設定

MobileAds 類別提供 Google Mobile Ads SDK 的通用設定。

影片廣告音量控制項

如果應用程式有專屬的音量控制項 (例如自訂音樂或音效音量),則向 Google Mobile Ads SDK 揭露應用程式音量,即可按照應用程式音量設定放送影片廣告。以確保使用者收到符合預期音訊音量的影片廣告。

裝置音量 (透過音量按鈕或 OS 層級的音量滑桿控制) 會決定裝置音訊輸出的音量。不過,應用程式可以個別調整裝置音量的音量,以便提供專屬的音訊體驗。如果是應用程式開啟頁面、橫幅、插頁式、獎勵和獎勵插頁式廣告格式,您可以透過靜態 setAppVolume() 方法,向 SDK 回報相對應用程式數量。有效廣告音量值介於 0.0 (靜音) 到 1.0 (目前裝置音量) 之間。以下範例說明如何向 SDK 回報相對應用程式量:

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_my);
    
    MobileAds.initialize(this, new OnInitializationCompleteListener() {
        @Override
        public void onInitializationComplete(InitializationStatus initializationStatus) {}
    });
    
    // Set app volume to be half of current device volume.
    MobileAds.setAppVolume(0.5f);
    ...
}

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    
    MobileAds.initialize(this) {}
    
    // 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_cookiesgad_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()