
Unity 要呼叫原生 iOS 功能其實不難,流程都是「寫 Objective-C → 包成 C 函式 → 在 C# 中用 DllImport 叫回來」。這篇先把 iOS 端的 Admob 封裝做完,下一篇再處理 Unity 側的呼叫。
先到 Admob 後台下載 iOS SDK 並申請 App ID,把 SDK 的 header 與靜態庫加進 Xcode 專案。這一步的細節請參考官方文件。
// IOSAdmob.h #import <Foundation/Foundation.h> #import "GADBannerView.h" #import "GADBannerViewDelegate.h" @interface IOSAdmob : NSObject <GADBannerViewDelegate> - (void)startRequestAdmob:(NSString *)admobId AdSize:(GADAdSize)size Position:(CGPoint)pos; - (void)setAdmobHidden:(BOOL)isHidden; @end
// IOSAdmob.m
#import "IOSAdmob.h"
@interface IOSAdmob ()
@property (nonatomic) BOOL isHidden;
@property (nonatomic) CGRect adRect;
@property (nonatomic, readonly, strong) UIViewController *rootViewController;
@property (nonatomic, readonly, strong) GADBannerView *adBannerView;
@end
@implementation IOSAdmob
- (id)init {
self = [super init];
if (self != nil) {
_isHidden = NO;
_adRect = CGRectZero;
_rootViewController = [[[UIApplication sharedApplication] keyWindow] rootViewController];
_adBannerView = nil;
}
return self;
}
- (void)dealloc {
[_rootViewController release];
[_adBannerView release];
[super dealloc];
}
- (void)startRequestAdmob:(NSString *)admobId AdSize:(GADAdSize)size Position:(CGPoint)pos {
if (_adBannerView) {
return; // 避免重複建立
}
_adBannerView = [[GADBannerView alloc] initWithAdSize:size];
_adRect = CGRectMake(pos.x, pos.y,
_adBannerView.frame.size.width,
_adBannerView.frame.size.height);
_adBannerView.adUnitID = admobId;
_adBannerView.delegate = self;
[_adBannerView setRootViewController:_rootViewController];
_adBannerView.frame = _adRect;
[_rootViewController.view addSubview:_adBannerView];
// 延遲 5 秒再請求,避開啟動畫面
double delayInSeconds = 5.0;
dispatch_time_t popTime = dispatch_time(DISPATCH_TIME_NOW, (int64_t)(delayInSeconds * NSEC_PER_SEC));
dispatch_after(popTime, dispatch_get_main_queue(), ^(void){
NSLog(@"Retrying to load request");
[_adBannerView loadRequest:[self createRequest]];
});
}
- (void)setAdmobHidden:(BOOL)isHidden {
_isHidden = isHidden;
if (_adBannerView) {
[_adBannerView setHidden:_isHidden];
}
}
#pragma mark GADRequest
- (GADRequest *)createRequest {
GADRequest *request = [GADRequest request];
return request;
}
#pragma mark GADBannerViewDelegate
- (void)adViewDidReceiveAd:(GADBannerView *)adView {
NSLog(@"Received ad");
_adBannerView.frame = _adRect;
[_adBannerView setHidden:_isHidden];
}
- (void)adView:(GADBannerView *)view didFailToReceiveAdWithError:(GADRequestError *)error {
NSLog(@"Failed to receive ad with error: %@", [error localizedFailureReason]);
// 失敗後隔 5 秒重試
double delayInSeconds = 5.0;
dispatch_time_t popTime = dispatch_time(DISPATCH_TIME_NOW, (int64_t)(delayInSeconds * NSEC_PER_SEC));
dispatch_after(popTime, dispatch_get_main_queue(), ^(void){
NSLog(@"Retrying to load request");
[_adBannerView loadRequest:[self createRequest]];
});
}
@end
// IOSAdmobManager.h @interface IOSAdmobManager : NSObject + (IOSAdmobManager *)getInstance; - (void)startRequestAdmob:(NSString *)admobId AdSizeId:(NSInteger)adSizeId Position:(CGPoint)pos; - (void)setAdmobHidden:(BOOL)isHidden; @end
// IOSAdmobManager.m
#import "IOSAdmobManager.h"
#import "IOSAdmob.h"
@interface IOSAdmobManager ()
@property (nonatomic, readonly, strong) IOSAdmob *admob;
@end
@implementation IOSAdmobManager
+ (IOSAdmobManager *)getInstance {
static IOSAdmobManager *mgr = nil;
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
mgr = [[self alloc] init];
});
return mgr;
}
- (id)init {
self = [super init];
if (self) {
_admob = [[IOSAdmob alloc] init];
return self;
}
return nil;
}
// 用整數編號對應 banner 尺寸,方便 C# 端以 enum 傳值
- (void)startRequestAdmob:(NSString *)admobId AdSizeId:(NSInteger)adSizeId Position:(CGPoint)pos {
switch (adSizeId) {
case 1: [_admob startRequestAdmob:admobId AdSize:kGADAdSizeBanner Position:pos]; break;
case 2: [_admob startRequestAdmob:admobId AdSize:kGADAdSizeLargeBanner Position:pos]; break;
case 3: [_admob startRequestAdmob:admobId AdSize:kGADAdSizeMediumRectangle Position:pos]; break;
case 4: [_admob startRequestAdmob:admobId AdSize:kGADAdSizeFullBanner Position:pos]; break;
case 5: [_admob startRequestAdmob:admobId AdSize:kGADAdSizeLeaderboard Position:pos]; break;
case 6: [_admob startRequestAdmob:admobId AdSize:kGADAdSizeSkyscraper Position:pos]; break;
case 7: [_admob startRequestAdmob:admobId AdSize:kGADAdSizeSmartBannerPortrait Position:pos]; break;
case 8: [_admob startRequestAdmob:admobId AdSize:kGADAdSizeSmartBannerLandscape Position:pos]; break;
default: [_admob startRequestAdmob:admobId AdSize:kGADAdSizeBanner Position:pos]; break;
}
}
- (void)setAdmobHidden:(BOOL)isHidden {
[_admob setAdmobHidden:isHidden];
}
@end
Unity 的 DllImport("__Internal") 只能對應 C 函式,因此要多一層 extern "C" 的橋接檔(副檔名 .mm,確保以 C++ 模式編譯)。
// LHAdmob.mm
#import "IOSAdmobManager.h"
extern C {
void startRequestAdmob(const char *admobId, int adSizeId, float pixelX, float pixelY) {
[[IOSAdmobManager getInstance] startRequestAdmob:[NSString stringWithUTF8String:admobId]
AdSizeId:adSizeId
Position:CGPointMake(pixelX, pixelY)];
}
void setAdmobHidden(bool isHidden) {
[[IOSAdmobManager getInstance] setAdmobHidden:isHidden];
}
}
ARC 設定:Unity 匯出的 Xcode 專案預設沒有開啟 ARC,所以以上程式碼採用手動記憶體管理(retain/release/dealloc)。若要改用 ARC,到 Targets → Build Settings → Objective-C Automatic Reference Counting 設為 YES,並把 dealloc 中的 release 全部刪掉。
用哪一種專案:任意 Xcode 專案都可以,寫完直接編譯;也可以建立 iOS → Framework & Library → Cocoa Touch Static Library,產出 .a 靜態庫。
怎麼放進 Unity:直接把原始檔丟進 Assets/Plugins/iOS,Unity 會自動參與編譯;若是靜態庫,則把 Product → Archive 產生的 .a 複製到同一個目錄。
最後提醒,範例用的是舊版 GADBannerView API。目前的 Google Mobile Ads SDK 已改為 GADRequest/GADMobileAds 體系,並以 GADFullScreenContentDelegate 處理插頁與獎勵廣告,接入新專案時請以官方最新文件為準。