您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

Unity3D 開發筆記:在 iOS 平台接入 Google Admob(上)

編輯:iOS 開發綜合

Unity 要呼叫原生 iOS 功能其實不難,流程都是「寫 Objective-C → 包成 C 函式 → 在 C# 中用 DllImport 叫回來」。這篇先把 iOS 端的 Admob 封裝做完,下一篇再處理 Unity 側的呼叫。

準備工作

先到 Admob 後台下載 iOS SDK 並申請 App ID,把 SDK 的 header 與靜態庫加進 Xcode 專案。這一步的細節請參考官方文件。

一、Admob 本體封裝

// 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

三、註冊 C 函式給 Unity 呼叫

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 處理插頁與獎勵廣告,接入新專案時請以官方最新文件為準。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved