MobileAds
類別提供 Google Mobile Ads SDK 的通用設定。
在 Unity 主執行緒上引發廣告事件
Google Mobile Ads SDK 在與 Unity 主執行緒不同的執行緒上引發事件。如果您導入廣告事件並與 Unity 物件互動,就必須將 Mobile Ads SDK 事件與 Unity 主執行緒同步處理。
如果您想讓 Mobile Ads SDK 為您處理這個執行緒問題,請將 MobileAds.RaiseAdEventsOnUnityMainThread
設為 true
。這會強制 SDK 在 Unity 主執行緒上引發所有事件和回呼。
...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
public void Start()
{
// When true all events raised by GoogleMobileAds will be raised
// on the Unity main thread. The default value is false.
MobileAds.RaiseAdEventsOnUnityMainThread = true;
}
}
影片廣告音量控制項
如果應用程式有自己的音量控制選項 (例如自訂音樂或音效音量),向 Google Mobile Ads SDK 揭露應用程式音量即可讓影片廣告遵循應用程式音量設定。這樣可確保使用者接收到預期音訊音量的影片廣告。
裝置音量 (透過音量按鈕或作業系統層級音量滑桿控制) 會決定裝置音訊輸出的音量。不過,應用程式可以根據裝置音量獨立調整音量,打造專屬的音訊體驗。
您可以呼叫 SetApplicationVolume()
方法,向 Google Mobile Ads SDK 回報相對應用程式音量。有效廣告音量值介於 0.0
(靜音) 到 1.0
(目前裝置音量) 之間。以下範例說明如何向 SDK 回報相對的應用程式數量:
// Set app volume to be half of current device volume.
MobileAds.SetApplicationVolume(0.5f);
如要告知 SDK 應用程式音量已設為靜音,請使用 SetApplicationMuted()
方法:
// Set app to be muted.
MobileAds.SetApplicationMuted(true);
根據預設,應用程式音量設為 1
、目前裝置音量,應用程式未設為靜音。
Cookie 同意聲明
如果您的應用程式有特殊規定,您可以將選用的 ApplicationPreferences
金鑰 gad_has_consent_for_cookies
設為零,啟用受限制的廣告 (LTD):
// Enable limited ads (LTD)
ApplicationPreferences.SetInt("gad_has_consent_for_cookies", 0);
Android 壓縮
這個 Unity 發布選項可讓您啟用 Java 程式碼壓縮。如果啟用壓縮功能,您也需要建立自訂 ProGuard 檔案,以保留 SDK 參照的類別。
啟用自訂 Proguard 檔案
依序前往「Project Settings」>「Player」>「Android」>「Publish Settings」>「Build」,然後選取:
- 自訂 Proguard 檔案
開啟
/Assets/Plugins/Android/proguard-user.txt
並新增下列項目:
-keep class com.google.** { public *; }