Android版Cocos2d-X應用的AnySDK集成Admob管理庫教程

一：要求
1:Cocos2d-X的最新版本
2: AnySDK框架v1.2.3或更高版本
3:AnySDK程序包工具

二:將AnySDK導入到遊戲中
AnySDK快速入門指南詳細介紹瞭如何在 C++和Android 級別導入AnySDK，請查看該指南以瞭解相關信息。

三:AnySDK Ads System API
成功導入AnySDK 後，您能夠參閱廣告系統指南，編寫針對AnySDK廣告系統的代碼。
AdMob支持AD_TYPE_BANNER和AD_TYPE_FULLSCREEN格式。咱們將介紹一些集成 AdMob的經常使用方法。

1:橫幅廣告
要請求和展現橫幅廣告，請使用AD_TYPE_BANNER廣告類型的showAds方法。
AdsPlugin * ads = AgentManager::getInstance()->getAdsPlugin();
ads->showAds(AD_TYPE_BANNER);

要中止展現橫幅廣告，請使用hideAds方法。ads->hideAds(AD_TYPE_BANNER);

2:插頁式廣告
在您顯式展現插頁式廣告以前，應該使用AD_TYPE_FULLSCREEN廣告類型的preloadAds方法預加載相應的廣告。
AdsPlugin * ads = AgentManager::getInstance()->getAdsPlugin();
ads->preloadAds(AD_TYPE_FULLSCREEN);

當您稍後要展現插頁式廣告時，請調用showAds。
ads->showAds(AD_TYPE_FULLSCREEN);

3:使用多個橫幅廣告或插頁式廣告
若是您須要使用多個橫幅廣告尺寸或不一樣的廣告單元 ID，則能夠向showAds、hideAds和preloadAds方法傳遞一個索引。如下是一些示例：
ads->showAds(AD_TYPE_BANNER, 2); // show banner #2
ads->hideAds(AD_TYPE_BANNER, 2); // hide banner #2
ads->showAds(AD_TYPE_FULLSCREEN, 2); // preload interstitial #2
ads->preloadAds(AD_TYPE_FULLSCREEN, 2); // show interstitial #2
若是不指定索引，則默認爲1。

當您稍後使用AnySDK程序包工具配置AdMob時，能夠設置每一個橫幅廣告的廣告單元 ID、廣告尺寸以及展現位置，還能夠設置每一個插頁式廣告的廣告單元ID。

注意：假設您的遊戲有4個橫幅廣告展現位置和2個插頁式廣告展現位置。您應該將橫幅廣告從1到4進行編號，將插頁式廣告從1到2進行編號。AnySDK程序包工具但願您使用這種編號方案。

4:監聽廣告事件
若是須要得到廣告事件的通知（例如成功接收到廣告），請指定實現AdsListener的類。它只提供一個方法（即onAdsResult），該方法會通知您全部事件。

AdMob支持如下廣告事件：
1:kAdsReceived  2:kAdsShown   3:kAdsDismissed     4:kNetworkError    5:kUnknownError

onAdsResult方法的典型實現框架以下所示：
void onAdsResult(AdsResultCode code, const char * msg) {
switch(code) {
  case kAdsReceived:
   // Ad has been received.
   break;
  case kAdsShown:
   // Ad is presenting a full screen view.
   break;
  case kAdsDismissed:
   // A full screen ad view is being dismissed.
   break;
  case kNetworkError:
   // Ad failed due to network error.
   break;
  case kUnknownError:
   // Ad failed.
   break;
   default:
   break;
}

}

在這裏，您能夠決定針對各個事件採起的措施。

最後，請注意設置廣告插件的廣告監聽器，以便告知 AnySDK 哪些類應該接收廣告事件：
AgentManager::getInstance()->getAdsPlugin()->setAdsListener(this);

四:使用 AnySDK 程序包工具
將您的應用配置爲使用AnySDK廣告系統後，請使AnySDK程序包工具啓用 AdMob 以填充您的廣告空間。您必須分別針對 Android 配置 AnySDK，針對這兩個平臺的配置過程以下所述：
1:Android
在AnySDK應用配置的SDK Management（SDK 管理）部分，指定 AdMob做爲廣告提供商，並選擇您的應用支持哪些格式。

2:在Parameter Config（參數配置）部分，爲橫幅廣告和/或插頁式廣告輸入 Android廣告單元ID，還請輸入廣告尺寸和展現位置（若是您使用的是橫幅廣告）。

若是您的應用設置爲使用多個橫幅廣告（參見使用多個橫幅廣告或插頁式廣告部分），請點擊」+」標籤爲每一個橫幅廣告配置廣告單元。另請針對插頁式廣告執行相同操做。

3:最後，在Publishing（發佈）標籤中，選擇Browse（瀏覽）並找到應用的.apk文件。而後點擊Start（開始）。

就這麼簡單！此步驟會生成一個包含 AdMob的項目版本！

由於Cocos2d-X的缺點是程序庫比較複雜，而且不穩定；雖說是個引擎，也提供了些輔助工具，但沒有系統化，實際只是個程序庫；惟獨他最大的優勢就 在於開發的產品能夠跨平臺發行。因此利用他的優點能夠集成KeyMob平臺。該平臺將整合國內外主流移動廣告平臺，並對廣告功能進行統一管理、動態配置， 廣告主和開發者均可以經過簡單的操做輕鬆實現對多家廣告平臺的搭配使用。並能輔助開發者過市場審覈。