Getting started

The Android SDK enables you to create a fluent conversation experience in your Android app that fuels quality interactions with community and content and allows users to create valuable and engaging content. Benefits of the Android SDK include the following:

• SSO support
• Customizable Conversation appearance
• Realtime moderation
• Ability to continue a conversation started on your web pages

Requirements

• Android 6.0 (API level 23) or later
• OpenWeb account
• Android Studio

Add and initialize the Android SDK

To add a Conversation to your app, you must import the OpenWeb Android SDK and then configure your project.

Use the following steps to import the SDK from Maven:

1. From within Android Studio, open your app.
2. In the project build.gradle file, add Maven Central or Jitpack.

allprojects {
    repositories {
        ...
      mavenCentral()
    }
}

allprojects {
    repositories {
        ...
      maven { url 'https://jitpack.io' }
    }
}

3. In the app build.gradle file, add the dependency below.

dependencies {
    ...
    implementation 'io.github.spotim:spotim-sdk:1.19.1-BetaSDK'
}

dependencies {
    ...
    implementation 'com.github.spotim.spotim-android-sdk:spotim-sdk:1.19.1'
}

4. In the AndroidManifest.xml file, add the permissions to use the Internet and to enable users to add images to comments from a camera or photo library.

   AndroidManifest.xml

   <uses-feature android:name="android.hardware.camera" android:required="false" />
   
   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.CAMERA"/>
    
     <application
   
   		...
       
     </application>
   
   

5. In onCreate() of the application class, initialize the OpenWeb SDK with your Spot ID. You can also initialize the OpenWeb SDK with a callback. The callback indicates if the initialization has been successful.

SpotIm.init(
    this,
    "SPOT_ID"
)

SpotIm.init(
    this,
    "SPOT_ID",
    object: SpotVoidCallback {
        override fun onSuccess(fragment: Fragment) {
            // All good...
        }

        override fun onFailure(exception: SpotException) {
            when(exception) {
                is SPServerErrorException -> { } // do something
                is SPNoInternetConnectionException -> { } // do something
                is SPSdkDisabeledException -> { } // do something
                else -> { } // do something 
            }
        }
    }
)