Setup
Get your Application Keys
Signup for CometChat and then:
- Create a new app
- Head over to the API Keys section and note the Auth Key, App ID & Region
info
- Android API Level 21
- Android API level 24 (in case you are using the calls SDKS)
- Androidx Compatibility
Add the CometChatCalls Dependency
Gradle
First, add the repository URL to the project level build.gradle
file in the repositories
block under the allprojects
section:
- Groovy
allprojects {
repositories {
maven {
url "https://dl.cloudsmith.io/public/cometchat/cometchat-pro-android/maven/"
}
}
}
Then, add CometChatCalls to the app level build.gradle
file in the dependencies
section.
- Groovy
dependencies {
implementation 'com.cometchat:pro-android-calls-sdk:3.0.1'
}
Initialize CometChatCalls
The init()
method initialises the settings required for CometChatCalls. The init()
method takes the below parameters:
- context - Your activity context
- callAppSettings - An object of the CallAppSettings class can be created using the CallAppSettingBuilder class. The appId and region field is mandatory and can be set using the
setAppId()
andsetRegion()
method.
The CallAppSettings
class allows you to configure three settings:
- App ID: CometChat app ID.
- Region: The region where you app was created.
- Host(host: string): This method takes the client URL as input and uses this client URL instead of the default client URL. This can be used in case of dedicated deployment of CometChat.
We suggest you call the init()
method on activity onCreate()
method.
- Java
- Kotlin
private Context context = this;
private String appID = "APP_ID"; //Replace with your App ID
private String region = "REGION"; //Replace with your App Region ("eu" or "us")
CallAppSettings callAppSettings = CallAppSettingBuilder()
.setAppId(appID)
.setRegion(region)
.build();
CometChatCalls.init(
context,
callAppSettings,
new CometChatCalls.CallbackListener<String>() {
override public void onSuccess(String successMessage) {
}
override public void onError(CometChatException e) {
}
}
)
val context:Context = this //Replace with your App Region ("eu" or "us")
val appID:String ="APP_ID" //Replace with your App ID
val region:String ="REGION" //Replace with your App Region ("eu" or "us")
val callAppSettings = CallAppSettingBuilder()
.setAppId(appID)
.setRegion(region).build()
CometChatCalls.init(
context,
callAppSettings,
object : CometChatCalls.CallbackListener<String>() {
override fun onSuccess(s: String?) {
}
override fun onError(e: CometChatException) {
}
}
)
Parameter | Description |
---|---|
context | Android context for your application |
callAppSettings | An object of the CallAppSettings class |