
上一篇把 iOS 端的廣告封裝與 C 橋接寫完了,這篇要做的就是在 Unity 的 C# 世界裡把它叫起來。
using UnityEngine;
using System.Collections;
using System.Runtime.InteropServices;
public enum GADAdSize : int {
// iPhone / iPod Touch 標準 banner,約 320x50
kGADAdSizeBanner = 1,
// 加高的 banner,約 320x100
kGADAdSizeLargeBanner,
// iPad 用的中矩形,約 300x250
kGADAdSizeMediumRectangle,
// iPad 用的全幅 banner,約 468x60
kGADAdSizeFullBanner,
// iPad 的看板,約 728x90
kGADAdSizeLeaderboard,
// 摩天大樓型,僅中介服務支援,約 120x600
kGADAdSizeSkyscraper,
// 直向智能 banner:橫跨全寬,iPhone 上高約 50,iPad 上約 90
kGADAdSizeSmartBannerPortrait,
// 橫向智能 banner:iPhone 上高約 32,iPad 上約 90
kGADAdSizeSmartBannerLandscape
}
public class LHiOSAdmob : MonoBehaviour {
[DllImport("__Internal")]
private static extern void startRequestAdmob(string admobId, int adSizeId, float pixelX, float pixelY);
[DllImport("__Internal")]
private static extern void setAdmobHidden(bool isHidden);
public static LHiOSAdmob Instance;
private GADAdSize adSize;
void Awake() {
if (Instance != null) {
Debug.LogError("Multiple instances of LHiOSAdmob");
}
Instance = this;
}
// 初始化,約 5 秒後才會真的發出請求,取得後自動顯示
public void InitAdmob(string admobId, GADAdSize size, Vector2 pos) {
#if UNITY_IPHONE
int adSizeId = (int)size;
startRequestAdmob(admobId, adSizeId, pos.x, pos.y);
#else
Debug.Log("Admob only run on iPhone platform");
#endif
}
// 控制顯示或隱藏
public void SetAdmobVisible(bool isVisible) {
#if UNITY_IPHONE
setAdmobHidden(!isVisible);
#else
Debug.Log("Admob only run on iPhone platform");
#endif
}
}
這是一個單例類,內部負責呼叫 iOS 的橋接函式,對外只開兩個方法。使用時可以做成一個 Prefab 並掛上這個腳本,拖進場景即可;在需要顯示廣告的場景呼叫 InitAdmob。
using UnityEngine;
public class TestAdmob : MonoBehaviour {
void Start () {
LHiOSAdmob.Instance.InitAdmob("your admob id",
GADAdSize.kGADAdSizeSmartBannerLandscape,
new Vector2(0, 150));
}
}
這樣就可以 Build iOS 專案了。
1. Other Linker Flags 加上 -ObjC
少了這個旗標,Objective-C 的分類與部分靜態庫內容不會被連結進來,最典型的症狀是執行期直接崩潰並抱怨找不到某個類別。
2. Link Binary With Libraries 補上相依框架
到 Targets → Build Phases → Link Binary With Libraries 加入:
上面這套流程概念仍然適用,但細節已經改變不少,直接照抄現在會遇到問題:
第一,Google 早已停用 UAC 舊版 SDK,現行版本要透過 CocoaPods 或 Swift Package Manager 整合 Google Mobile Ads SDK,並在 Info.plist 加入 GADApplicationIdentifier 與 SKAdNetworkItems,否則 App 一啟動就會被系統終止。
第二,Apple 要求所有面向兒童或涉及個資的 App 明確聲明 ATT(App Tracking Transparency)同意狀態, request 時機與文案都有規範。
第三,Unity 版本若較新,DllImport("__Internal") 的 iOS 插件仍然支援,但建議改用 Native Plug-in 的 .mm 檔放在 Plugins/iOS 並搭配 UNITY_IOS 巨集,同時把 ARC 打開、移除所有手動 release,會省下不少記憶體問題。
第四,位置參數在 retina 螢幕上要留意單位:iOS 原生 API 吃的是 point,Unity 的 Input 與螢幕座標多半是 pixel,兩者混用會導致廣告跑到看不見的地方。範例中直接傳 Unity 座標其實是個隱藏的坑,正式實作時應該換算過再傳。