# Cocos2d-x

## Quick Start

最新バージョンダウンロード

{% embed url="<https://github.com/naver/navergame-sdk-cocos2dx/releases/tag/1.3.7>" %}

## **既存プロジェクトにNavergame SDKを適用する**

本ガイドは、Cocos2d-x 3.17.2バージョンを基準に作成されています。

### **1. プログインの構成**

* サンプルプロジェクト内のPluginsフォルダにはSDKに必要なファイルが入っています。

![](https://2139408215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F62NAlL66NlO6fj2tpGNj%2Fuploads%2FHTgQ9uDy8MFMInRTDJAt%2F27.png?alt=media\&token=58ad12fc-5af6-4d6c-8dce-2d9fb7b49b02)

1. android : android buildに必要なファイルが入っています。
2. ios : ios buildに必要なファイルが入っています。
3. navergamesdk : cocos2d-xプロジェクトとandroid、iosなど各プラットフォームに連動する必要のあるファイルが入っています。

### **2. プログインのインストール**

* 貴社のCocos2d-xプロジェクトとSDKを連動させるためには、**Plugins内のnavergamesdkフォルダ**を以下のように**貴社のプロジェクト内のClassesフォルダの中**にコピーしてください。

![](https://2139408215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F62NAlL66NlO6fj2tpGNj%2Fuploads%2Fpf3d3lg0EQ9BTnLXaDaK%2F28.png?alt=media\&token=d1674b37-ebec-4a5c-a0d1-507973c8bbbe)

* 貴社のプロジェクトで**android或いはiosプラットフォームを一つだけリリースする予定**の場合は、platform画面下のandroid或いはiosフォルダのうち**該当するフォルダのみを残して削除すると良いでしょう。**

#### **2-1. NaverGameSDK.h**

* 当該ファイル内にはsdk連動に必要なコードが作成されています。

![](https://2139408215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F62NAlL66NlO6fj2tpGNj%2Fuploads%2FEOGkK6d3cjrXCKMuzgXC%2F29.png?alt=media\&token=0a3385cf-bde1-42f1-9229-efea5ce5c90c)

### **3. プロフインの適用**

貴社のプロジェクト内でsdkを使用したい場所にヘッダファイルをincludeさせてください。

(サンプルプロジェクトではHelloWorldScene.hに適用されています。)

```
#include "NaverGameSDK.h"
```

* NaverGameSDK.hが見つからないと表示された場合は、rootProject/CmakeLists.txtにヘッダファイルを下の画像のように追加してください。

![ヘッダファイルとcppファイルを登録してください。](https://2139408215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F62NAlL66NlO6fj2tpGNj%2Fuploads%2FRaK44w67HvwJFz0e5AUW%2F30.png?alt=media\&token=21f60b3b-050b-461f-8199-748bd8a25bb8)

![navergamesdkフォルダを登録してください。](https://2139408215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F62NAlL66NlO6fj2tpGNj%2Fuploads%2F6PjkVT6BWvokZgK59nPB%2F31.png?alt=media\&token=dcd9bfe8-c218-478a-a27a-8793a2a21dec)

#### **3-1. SDKの初期化**

SDKを初期化するときは、以下のように初期化オプションを設定してinit()メソッドを呼び出してください。

* ClientId: [NAVER IDでログイン開発者センター](https://developers.naver.com/products/login/api)にアプリケーションを登録時に受け取ったクライアントID
* ClientSecret: [NAVER IDでログイン開発者センター](https://developers.naver.com/products/login/api)にアプリケーションを登録時に受け取ったクライアントシークレット
* LoungeId: 公式ラウンジを申請時に受け取ったLoungeId

```
nng::NaverGameSDK::init("UKvNABLDsyEJusJGsXL2", "rK4suc_Qd0", "naver_game_4developer");
```

#### **3-2. SDKイベントリスナーの登録**

SDKが送信する様々なイベントを受け取るためにはリスナーを登録しなければなりません。

```
//리스너는 NaverGameSDK.h 에 선언되어있습니다.
nng::NaverGameSDK::setSdkListener(this);
```

#### **3-3. SDK対応Funtionを確認する**

1. ホームバナーを呼び出す

```
nng::NaverGameSDK::startHomeBanner();
```

2\. 点検バナーを呼び出す

```
nng::NaverGameSDK::startSorryBanner();
```

3\. 特定の掲示板を呼び出す

```
nng::NaverGameSDK::startBoard(boardId);
```

4\. 特定の投稿を呼び出す

登録された投稿の番号ですぐに実行するメソッドです。**予約機能によって登録された予約投稿**の場合は、予約投稿の番号をFeedIDに入力してIsTempFeedIdを**True**と入力してください。

```
nng::NaverGameSDK::startFeed(feedId, isTempFeedId);
```

5\. sdkを終了させる

```
nng::NaverGameSDK::stopSdk
```

6\. 国コードを呼び出す

モバイル機器のcountryCodeを取得します。必ず**init()メソッドが呼び出した後**に呼び出した場合のみ正常値を得ることができます。

```
nng::NaverGameSDK::getCountryCode();
```

countryCodeは2文字のアルファベットで構成された国コード([ISO 3166-1 alpha-2](https://ko.wikipedia.org/wiki/ISO_3166-1_alpha-2))です。これを活用すると、**コード内で国別に分岐処理することができます**。主な国コードは以下のとおりです。その他の国コードは[リンク](https://ko.wikipedia.org/wiki/ISO_3166-1_alpha-2)をご参考にしてください。

| 国コード | 国  |
| ---- | -- |
| CN   | 中国 |
| JP   | 日本 |
| KR   | 韓国 |
| TH   | タイ |
| US   | 米国 |

## **AndroidプロジェクトにNavergame SDKを適用させる**

以下はサンプルプロジェクトのAndroidビルド環境です。ご参考にしてください。

* Cocos2d-x **3.17.2**
* Android Studio **4.2**
* Gradle **4.9 (proj.android/gradle/wrapper/gradle-wrapper.properties)**
* Ndk **16.1.4479499**
* Cmake **3.10.2.4988404 (**&#x77;ith Ninja **1.10.2)**

**​**

### **1. Cocos2d-xとAndroidを連結するブリッジファイル(コード)を追加する**

**サンプルプロジェクトのPlugins**フォルダです。

![](https://2139408215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F62NAlL66NlO6fj2tpGNj%2Fuploads%2F1aulvtDGbM7v7OlDuTBu%2F32.png?alt=media\&token=00c6d63f-ac14-4960-a021-6a941b7a01a3)

**Pluginsフォルダ内のandroid**フォルダの内容です。

![](https://2139408215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F62NAlL66NlO6fj2tpGNj%2Fuploads%2Fu1wgRsodmQyAOObFoKpO%2F33.png?alt=media\&token=01951b3b-c972-47b9-88b1-769e4afc2104)

1. com...フォルダ内の端には、androidでcocosプロジェクトとブリッジの役割をする**NNGSdk.javaファイル**が入っています。
2. navergame-sdk-gradle-x.x.x.aarは**Navergame sdkライブラリ**です。

**サンプルプロジェクトディレクトリの構造**です。

![](https://2139408215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F62NAlL66NlO6fj2tpGNj%2Fuploads%2F8nfOzyw9DEAsPEhJ7ZTs%2F34.png?alt=media\&token=63581f8e-e8e9-4442-b5b3-50fc62a08bc7)

#### **1-1. navergame-sdk-gradle-x.x.x.aar**

Naver Game SDKライブラリです。

* rootProject/proj.android/app/libsフォルダに貼り付けてください。libsフォルダがない場合は作成してください。

#### **1-2. NNGSdk.java**

AndroidでCocos2d-xプロジェクトとSDKを連結させるブリッジコードが作成されたファイルです。

* rootProject/proj.android/app/srcフォルダに貼りつけてださい。com..ではじまるフォルダ全体を貼り付けてください。

#### **1-3. NaverGameSDK.cpp**

Cocos2d-xでAndroidプロジェクトと連結させるブリッジコードが作成されたファイルです。

* rootProject/Classes/navergamesdk/platform/android/NaverGameSDK.cppファイルがあるか確認して、ない場合はPluginsフォルダで探して貼り付けてください。
* cocos2d-xバージョンによってJniHelperが別の名前で作成されている場合があるので、バージョンが異なる場合は確認してみてください。

```
#include "NaverGameSDK.h"
#include "platform/android/jni/JniHelper.h"

using namespace cocos2d;

namespace nng {
    static bool getStaticMethod(JniMethodInfo &methodinfo, const char *methodName, const char *paramCode) {
        static const char* kCafeSdkClass = "com/navercorp/nng/cocos2dx/sample/NNGSdk";
        return JniHelper::getStaticMethodInfo(methodinfo, kCafeSdkClass, methodName, paramCode);
    }

    static NaverGameSDKListener* sdkListener = nullptr;

    void NaverGameSDK::setSdkListener(NaverGameSDKListener* listener) {
        sdkListener = listener;
    }

    void NaverGameSDK::init(std::string clientId, std::string clientSecret, std::string loungeId) {
        JniMethodInfo t;
        if (getStaticMethod(t, "init","(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;)V")) {
            jstring _clientId = t.env->NewStringUTF(clientId.c_str());
            jstring _clientSecret = t.env->NewStringUTF(clientSecret.c_str());
            jstring _loungeId = t.env->NewStringUTF(loungeId.c_str());

            t.env->CallStaticVoidMethod(t.classID, t.methodID, _clientId, _clientSecret, _loungeId);

            t.env->DeleteLocalRef(_clientId);
            t.env->DeleteLocalRef(_clientSecret);
            t.env->DeleteLocalRef(_loungeId);
            t.env->DeleteLocalRef(t.classID);
        }
    }

    .
    .
    .

    extern "C" {
        JNIEXPORT void JNICALL
        Java_com_navercorp_nng_cocos2dx_sample_NNGSdk_onSdkStarted(JNIEnv* env, jclass thiz) {
            if (sdkListener == nullptr) return;
            sdkListener->onSdkStarted();
        }

        .
        .
        .
    }
}   /* namespace nng */
```

* kCafeSdkClass = "**com/navercorp/nng/cocos2dx/sample/NNGSdk**";
  * NNGSdk.javaファイルのロケーションパスです。NNGSdk.javaのロケーションパスを変更した場合は、当該ロケーションに合わせて修正してください。
* Java\_**com\_navercorp\_nng\_cocos2dx\_sample\_NNGSdk**\_
  * NNGSDK.javaファイルのロケーションパスです。NNGSdk.javaのロケーションパスを変更した場合は、当該ロケーションに合わせて修正してください。

### **2. Androidでビルドするための設定**

#### **1-1. AndroidManifest.xml**

* rootProject/proj.android/app/AndroidManifest.xmlファイル内にSDKで必要な権限を追加してください。

```
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
```

#### **1-2. build.gradle**

* rootProject/proj.android/app/build.gradleファイル内にSDKとSDKで必要なライブラリを追加してください。

```
dependencies {
    implementation project(':libcocos2dx')
    /**
     * Navergame sdk와 필요한 libraries
     */
    implementation files('libs/navergame-sdk-gradle-1.1.0.aar')
    implementation "org.jetbrains.kotlin:kotlin-stdlib:1.3.72"            // Kotlin
    implementation "androidx.viewpager2:viewpager2:1.0.0"
    implementation "androidx.swiperefreshlayout:swiperefreshlayout:1.1.0"
    implementation "com.github.bumptech.glide:glide:3.7.0"                // Glide
    implementation "com.squareup.retrofit2:retrofit:2.6.4"                // Retrofit, Gson
    implementation "com.squareup.retrofit2:converter-gson:2.7.2"          // Retrofit, Gson
}
```

#### **1-3. ndkとcmakeのインストール**

* Android Studioの利用方法
  * Android Studio -> Preferences -> 検索でsdkを検索後、sdk toolsタブでndkとcmakeをダウンロードしてください。(Show Package Detailsをチェックしてください。)

![ocos-3.17.2バージョン基準でndk-16.1.4479499、cmake-3.10.2.4988404バージョンを使用しました。](https://2139408215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F62NAlL66NlO6fj2tpGNj%2Fuploads%2FEhsXeEqVxencPeuSMhi5%2F35.png?alt=media\&token=a73585f2-e3cf-4092-9c3d-7f6549d0550d)

#### **1-4. ndk、cmakeの適用**

* rootProject/proj.android/local.propertiesファイルにndk、cmakeインストールファイルパスを入力してください。

![](https://2139408215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F62NAlL66NlO6fj2tpGNj%2Fuploads%2FNw3aVFNQTVbrOHN5gb6c%2F36.png?alt=media\&token=49abeed4-bb8e-4cf3-96ab-d2501c96ad08)

### **3. Androidでビルドする**

Cocos2d-xプロジェクトをAndroidで**ビルドする方法は2つ**あります。

* cmake
* ndk

正確な名称はcocos2d-xのバージョンによって異なることがあるので確認してください。3.17.2バージョン基準では、build.gradleファイル内で確認できます。

![3.17.2バージョン基準で「ndk-build」と「cmake」です。](https://2139408215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F62NAlL66NlO6fj2tpGNj%2Fuploads%2F06zdhj8IRqbt0BSGNJqd%2F37.png?alt=media\&token=45c9704f-881c-4dab-98e0-87c3dcaaa1ae)

#### **3-0. ビルドタイプの適用方法**

rootProject/proj.android/gradle.propertiesファイル内の**PROP\_BUILD\_TYPE**プロパティで定めることができます。

![](https://2139408215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F62NAlL66NlO6fj2tpGNj%2Fuploads%2FIDua0XoLVQobmt0Qp4PR%2F38.png?alt=media\&token=78971ad4-b4b3-45ef-ae56-22ec45e582ee)

* cmakeでビルドする場合は、**PROP\_BUILD\_TYPE=cmake**に設定してください。

#### **3-1. CMAKEでビルドする**

* rootProject/proj.android/gradle.properties内の**PROP\_BUILD\_TYPE=cmake**を確認してください。
* rootProject/CmakeList.txtに[SDKに必要なファイルとフォルダパスが正しく追加されたか確認してください。](https://app.gitbook.com/@navergame/s/naver-game/integration-guide/cocos2d-x#3)​
* rootProject/proj.andorid/local.propertiesにcmakeとndkのインストールファイルパスが正しく入力されたか確認してください。
* cmakeでビルドするためにはNinjaが必要です。ninjaのインストールを確認してください。
* **ビルドボタンをクリック！**

#### **3-2. NDKでビルドする**

* rootProject/proj.android/gradle.properties内の**PROP\_BUILD\_TYPE=ndk-build**を確認してください。
* rootProject/proj.android/app/jni/Android.mkに**SDKに必要なファイルとフォルダパス**を追加してください。

![](https://2139408215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F62NAlL66NlO6fj2tpGNj%2Fuploads%2Fk6TqfYDi60fA7ObeMtlz%2F39.png?alt=media\&token=ac5757b3-b7fc-46eb-b634-264f38d7518d)

* rootProject/proj.andorid/local.propertiesにndkのインストールファイルパスが正しく入力されたか確認してください。
* **ビルドボタンをクリック！**

## **iOSプロジェクトにNavergame SDKを適用する**

{% hint style="info" %}
NAVERゲームのiOS SDKは、iOS 12.0以降のバージョンに対応しています。
{% endhint %}

NAVERゲームSDKを使用する場合は、XCodeで以下のように開発環境を設定してください。

* **TARGETS**項目のうち実行されるアプリを選択してください。
* **Build Setting**タブを選択して**Linking**項目で**Other Linker Flags**を探してください。
  * **Basic**または**Customized**モードの場合は、**Other Linker Flag**が見えない場合があります。この場合は、**All**モードを選択してください。
  * 画面右上にある検索ウィンドウに**Other Linker Flag**を入力すると容易に見つけることができます。
* **Other Linker Flags**&#x306B;**-ObjC**オプション&#x3068;**-lc++**&#x30AA;プションを追加してください。

![](https://2139408215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F62NAlL66NlO6fj2tpGNj%2Fuploads%2FXgbzwgnd2bwguNTnD1M4%2F40.png?alt=media\&token=2ea6a7d5-3adb-4183-8d38-8f44fe6da9c6)

&#x20;

* **Info.plist**に以下のユーザー権限獲得オプションを追加してください。
  * Privacy - Camera Usage Description
  * Privacy - Photo Library Usage Description

![](https://2139408215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F62NAlL66NlO6fj2tpGNj%2Fuploads%2F6gqZyxVvvsetjnvtiKyx%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202021-03-18%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%203.55.04.png?alt=media\&token=5d04d2a7-be9c-4b48-8a05-5c031c16c64f)

* **TARGETS**項目のうち実行されるアプリを選択して**Info**タブの**URL Types**項目に**Identifier**値と**URL Schemes**値を入力してください。
* **Identifier**値は当該**TARGET**の**General**タブで確認できます。
* **URL Schemes**値には[NAVER IDでログイン開発者センター](https://developers.naver.com/apps/#/register?api=nvlogin)にアプリケーションを登録時に入力した[URL Scheme](https://developers.naver.com/apps/#/myapps)値を入力してください。

![](https://2139408215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F62NAlL66NlO6fj2tpGNj%2Fuploads%2FN0LczJSSmhYPGvVi4rzM%2F43.png?alt=media\&token=44f12e08-f79c-4033-b659-f78a34fbf0a1)

![](https://2139408215-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F62NAlL66NlO6fj2tpGNj%2Fuploads%2FvU7N2Fj9ZMPVGHyC2Gcm%2F44.png?alt=media\&token=e1bcd0a5-2142-4a35-afbd-09f5b9fe7a91)

&#x20;

&#x20;
