MobileAds
類別提供 Google Mobile Ads SDK 的通用設定。
影片廣告音量控制
如果應用程式有專屬的音量控制項 (例如自訂音樂或音效音量),則在 Google Mobile Ads SDK 中揭露應用程式音量,即可讓影片廣告遵循應用程式音量設定。這可確保使用者接收到影片廣告時,廣告的音量符合預期。
裝置音量可透過音量鍵或作業系統層級的音量滑桿控制,用於決定裝置音訊輸出的音量。不過,應用程式可以獨立調整相對於裝置音量的音量,以提供客製化的音訊體驗。針對應用程式開啟頁面廣告、橫幅廣告、插頁式廣告、獎勵廣告和插頁式獎勵廣告格式,您可以透過靜態 setAppVolume()
方法,向 SDK 回報相對應用程式量。有效的廣告音量值範圍從 0.0
(靜音) 到 1.0
(目前裝置音量)。以下是如何向 SDK 回報相對應用程式音量值的範例:
Kotlin
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)
}
}
Java
@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()
方法:
Kotlin
MobileAds.setAppMuted(true)
Java
MobileAds.setAppMuted(true);
根據預設,應用程式音量會設為 1
(目前裝置音量),且應用程式不會設為靜音。
原生廣告
如需控制靜音設定的操作說明,請參閱 VideoOptions
。原生廣告不支援自訂音量控制項。
Cookie 同意聲明
如果應用程式有特殊需求,您可以設定選用的 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();