# Quick Start

# Integration

AIHelp Cocos2dx SDK is an encapsulation for Android and iOS with bridge files to the native code.

For starters, download (opens new window) the AIHelp Cocos2dx demo and import the bridge files under the /Classes folder into your project. Afterwards, you can integrate Android and iOS SDK according the following guide.

# Android

Android is using Gradle under the hood, you can find the dependency code in the build.gradle:

dependencies {
    implementation 'net.aihelp:android-aihelp-aar:5.1.+'
}

The third-party-library used by AIHelp are as follows: androidx.recyclerView, okhttp3, okio.

If you're only integrating AIHelp AAR file, please make sure you've got all these libraries in your dependency.

# iOS

iOS is using .framework library under the hood, download (opens new window) the latest version of 4.x.

Add Privacy - Photo Library Usage Description declaration to your info.plist.
Add -ObjC to the Other Linker Flags field in your Build Settings in Xcode.

# API

WARNING

Please ensure you are doing the initialization job at the very beginning of your application's lifecycle, otherwise there maybe unintended runtime exception.

# initialize()

You can do the AIHelp initialization job by calling this method:

if (USER_FROM_MAINLAND_CHINA) {
    AIHelpSupport::additionalSupportFor(PublishCountryOrRegion::CN);
}
AIHelpSupport::init(
    "THIS IS YOUR APP DOMAIN",
    "THIS IS YOUR APP ID",
    "THIS IS YOUR DEFAULT LANGUAGE(OPTIONAL)"
);

AIHelp provides additional domain support for specific country or region, check here to learn more.

# registerAsyncEventListener()

We also provide API for you to register SDK's events, including initialize status:

AIHelpSupport::registerAsyncEventListener(
        EventType::INITIALIZATION,
        [](const char *jsonData, Acknowledge ignored) {
            // When init job is done, you can get callback here
            // `jsonData`: { "isSuccess": true, "message": "Success" }
        }
);

# Definition

# domain / appId

Type: string
Details: Required. You can get these parameters at here:

# language

Type: string
Default: device's locale language
Details: Optional. This is AIHelp's default initialize language; If you are not Setting this, we will use device's locale language to initialize AIHelp SDK.
See also: Check here to learn language code you may need. Going International?

# Code Example

Please ensure you are initializing AIHelp in your AppDelegate::applicationDidFinishLaunching() method

The code examples are as follows:

#include "AIHelpSupport.h"

bool AppDelegate::applicationDidFinishLaunching() {
    if (USER_FROM_MAINLAND_CHINA) {
        AIHelpSupport::additionalSupportFor(PublishCountryOrRegion::CN);
    }
    
    AIHelpSupport::initialize(
        "THIS IS YOUR APP DOMAIN",
        "THIS IS YOUR APP ID",
        "THIS IS YOUR DEFAULT LANGUAGE(OPTIONAL)"
    );        

    AIHelpSupport::registerAsyncEventListener(
        EventType::INITIALIZATION,
        [](const char *jsonData, Acknowledge ignored) {
            // When init job is done, you can get callback here
            // `jsonData`: { "isSuccess": true, "message": "Success" }
        }
    );
}

Events →