アイコン型広告 - fan-ADN/nendSDK-cocos2d-x GitHub Wiki

事前準備

まだ広告枠作成、SDKダウンロードを行っていない場合、下記リンク先を参照してください。

SDKの組み込み

プロジェクトにSDK、モジュールを追加します。

アイコン型広告の表示 ※ Androidのみ

Cocos2d-x のソースファイルにアイコン型広告を表示するプログラムを実装します。 手順は以下の通りです。

  1. ヘッダーファイルの宣言を追加
  2. 広告を表示する処理を呼び出す

ヘッダーファイルの宣言を追加

広告を表示する scene のソースファイルにヘッダーファイルの宣言を追加します。

例) HelloWorldScene.cpp（一部）ヘッダーファイル宣言部分

#include "HelloWorldScene.h"
#include "NendIconModule.h"

USING_NS_CC;

CCScene* HelloWorld::createScene() {
...
}

広告を表示する処理を呼び出す

広告を表示するメソッドを呼び出します。
以下の手順で広告の表示を行います

  1. NADIconLoaderの生成 (createNADIconLoader メソッド)
  2. アイコンの生成 (createNADIconView メソッドなど)
  3. 広告の load (load メソッド)

ver1.2.1から

複数のアイコン広告を表示する場合は、それぞれ別の広告枠ID（apiKey と spotID）を指定して、上記のメソッドを広告枠ID毎に実装してください。
複数の広告を表示する方法については、複数広告を同時に表示する例を参照ください。

アイコンの生成は呼び出すメソッドによって広告を表示する場所が異なります。

メソッド名 説明
createNADIconView 位置を指定してアイコン広告を表示
createNADIconViewBottom 画面下部中央にアイコン広告を表示
createNADIconViewTop 画面上部中央にアイコン広告を表示

各メソッドの詳細はNendIconModule の内容を参照ください。

例) HelloWorldScene.cpp（一部）- HelloWorld::init()

// on "init" you need to initialize your instance
bool HelloWorld::init()
{
    ...
    // add the sprite as a child to this layer
    this->addChild(pSprite, 0);

    // 画面上部中央に広告を表示する例
    char iconApiKey[] = "管理画面より発行された apiKey";
    char iconSpotID[] = "管理画面より発行された spotID";
    NendIconModule::createNADIconLoader(iconApiKey, iconSpotID);
    NendIconModule::createNADIconViewTop();
    NendIconModule::load();

    return true;
}

タイトル文字列の設定 (ver1.2.1で追加)

アイコン下部に表示されるタイトル文字列に対して、次のように設定を行うことが出来ます。

表示/非表示

bool値でtrueまたはfalseを指定します。

値 説明
true タイトル文字列を表示します
false タイトル文字列を非表示にします

タイトル文字列を表示する例

NendIconModule::createNADIconViewTop("管理画面より発行された spotID", true, true, Color3B::BLACK);

タイトル文字列を非表示にする例

NendIconModule::createNADIconViewTop("管理画面より発行された spotID", false, true, Color3B::BLACK);

文字色設定

デフォルトの文字色は黒になります。
文字色の設定には、cocos2dx-v3.0以上で利用可能なColor3Bの構造体で設定します。 Color3Bに用意されている色またはRGBの10進数で設定できます。

デフォルトの文字色(黒)となる場合

NendIconModule::createNADIconViewTop();

タイトル文字色を白にする例

NendIconModule::createNADIconViewTop("管理画面より発行された spotID", true, true, Color3B::WHITE);

または

NendIconModule::createNADIconViewTop("管理画面より発行された spotID", true, true, Color3B(255, 255, 255));

余白の設定 (ver1.2.1で追加)

bool値でtrueまたはfalseを指定します。 余白を有効にする場合はtrue（デフォルト）、無効にする場合はfalseを設定します。

値 説明
true 余白有りでアイコンを表示します
false 余白無しでアイコンを表示します

余白有りで表示する例

NendIconModule::createNADIconViewTop("管理画面より発行された spotID", true, true, Color3B::BLACK);

余白無しで表示する例

NendIconModule::createNADIconViewTop("管理画面より発行された spotID", true, false, Color3B::BLACK);

nendSDK Cocos2d-x の内容

検証