• Available for VideoEngager Standalone
• Supports Genesys Cloud
• To support Genesys Engage (estimated release date mid Jun 2021)
• Onmi-channel experience + click to chat, click to voice, click to video
• Localization (supports English (en_US), Spanish (es_ES), Portuguese (pt_PT), German (de_DE), and Bulgarian (bg_BG))
• Video on/off + Front/back camera rotation
• Mic on/off + multiple audio sources (automatic and manual selection)
• Secure File Transfer 
• Torch control

Prerequisites

- Android Developer Studio 4.1 or higher
- Androidx.core:core-ktx:1.3.2 or higher
- Android 21 (Android 5.0 "Lollipop")  or higher

Integration

The VideoEngager SDK can be integrated in three steps:

• Step 1: SDK Installation
• Step 2: SDK Initialization
• Step 3: Connect Native app buttons

Step 1 - SDK Installation

Installation of VideoEngager is currently performed by adding videoengager-sdk-release.aarto  libs project's lib directory.

In addition, all the dependencies shall be added to the project, as follows:

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar','*.aar'])
    implementation 'com.google.code.gson:gson:2.8.6' 
    implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:2.3.0" 
    implementation 'com.squareup.picasso:picasso:2.8' 
    implementation 'org.webrtc:google-webrtc:1.0.22270'
}

Step 2 - SDK Initialization for Genesys Cloud

The SDK initialization process is consisting of three sub-steps.

1. Initialization Sub-Step 1: Configure SDK to use your Genesys Cloud Organization 

If you want to configure the demo app to run with your own Genesys Cloud organization, then assets/params.json file shall be updated to provide the correct parameters of your organization.

 

2. Initialization Sub-Step 2: SDK configuration at run time

import com.videoengager.sdk.VideoEngager
import com.videoengager.sdk.model.Settings
import com.videoengager.sdk.tools.LangUtils
import com.videoengager.sdk.model.Settings

data class Params(
  val genesys_cloud_params_init:Settings,
  val generic_params_init:Settings,
  val genesys_engage_params_init:Settings
)

//....
lateinit var params:Params;
override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  //load params.json from assets folder using Gson lib
  val params = Gson().fromJson(assets.open("params.json").reader(Charsets.UTF_8),Params::class.java)
  //...
}

3. Initialization Sub-Step 3: Add SDK delegates

 

val myAwesomeMessage = "Hola Agent!"
video?.SendMessage(myAwesomeMessage)

val listener = object : VideoEngager.EventListener(){  
    
    override fun onMessageReceived(message: String) {  
         //fires when agent send chat message
    }  

}

// ....


findViewById<Button>(R.id.button_audio).setOnClickListener {
  //allow more verbose debug Logcat messages 
  VideoEngager.SDK_DEBUG=true
  //change some additional values like preferred Language
  params.genesys_cloud_params_init!!.Language=VideoEngager.Language.ENGLISH
  val video = VideoEngager(this, params.genesys_cloud_params_init!!, VideoEngager.Engine.genesys)
  if (video.Connect(VideoEngager.CallType.audio)) {
      //handle events with event listener
    video.onEventListener = listener
  } else Toast.makeText(this, "Error from connection", Toast.LENGTH_SHORT).show()
}

findViewById<Button>(R.id.button_video).setOnClickListener {
  //allow more verbose debug Logcat messages 
  VideoEngager.SDK_DEBUG=true
  //change some additional values like preferred Language
  params.genesys_cloud_params_init!!.Language=VideoEngager.Language.ENGLISH
  val video = VideoEngager(this, params.genesys_cloud_params_init!!, VideoEngager.Engine.genesys)
  if (video.Connect(VideoEngager.CallType.video)) {
    //handle events with event listener
    video.onEventListener = listener
  } else Toast.makeText(this, "Error from connection", Toast.LENGTH_SHORT).show()
}

minSdkVersion for the Android SDK is 21 (Android 5.0 "Lollipop").

Demo App

We offer a demo app to help minimize onboarding time of app developers. The demo app contains detailed instructions in a README.md file. 

We listen to our customers 

We, the VideoEngager team, believe that addressing customer pains in timely manner is of utmost importance and key to success for all stakeholders. Our team is highly responsive to customer request. We would like to encourage you to share any suggestions for improvement of troubleshooting  guide. To do so, please contact us by sending email to our support team.