# 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:4.6.+'
}

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.

  1. Add Privacy - Photo Library Usage Description declaration to your info.plist.

  2. 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.

# init()

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 KEY",
    "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.

# setOnAIHelpInitializedCallback()

We also provide apis for you to monitor SDK's initialization status:


 
 
 


 


#include "AIHelpSupport.h"
void AIHelp_onAIHelpInit(const bool isSuccess, const char * message) {
    // do something you want
}

bool AppDelegate::applicationDidFinishLaunching() {
    AIHelpSupport::setOnAIHelpInitializedCallback(AIHelp_onAIHelpInit);
}

# Definition

# appKey / 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?

# onAIHelpInitializedCallback

  • Type: void (*OnAIHelpInitializedCallback)(const bool isSuccess, const char * message)
  • Default: null
  • Details: Optional. AIHelp's initialization callback, you'll get notified when the init job is done.

# Code Example

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

The code examples are as follows:







 
 
 
 
 
 
 
 
 
 


#include "AIHelpSupport.h"
void AIHelp_onAIHelpInit(const bool isSuccess, const char * message) {
    // do something you want
}

bool AppDelegate::applicationDidFinishLaunching() {
    if (USER_FROM_MAINLAND_CHINA) {
        AIHelpSupport::additionalSupportFor(PublishCountryOrRegion::CN);
    }
    AIHelpSupport::init(
        "THIS IS YOUR APP KEY",
        "THIS IS YOUR APP DOMAIN",
        "THIS IS YOUR APP ID",
        "THIS IS YOUR DEFAULT LANGUAGE(OPTIONAL)"
    );        
    AIHelpSupport::setOnAIHelpInitializedCallback(AIHelp_onAIHelpInit);
}
Last Updated: 4/1/2024, 4:08:57 AM