> ## Documentation Index
> Fetch the complete documentation index at: https://www.cometchat.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup

> CometChat Calling SDK v4 - Stable Release - Setup for Android

## Get your Application Keys

[Signup for CometChat](https://app.cometchat.com/signup) and then:

1. Create a new app
2. Head over to the API Keys section and note the Auth Key, App ID & Region

<Note>
  Minimum Requirement

  * Android API Level 21
  * Android API level 24 (in case you are using the calls SDKS)
  * Androidx Compatibility
</Note>

## 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:

<Tabs>
  <Tab title="Groovy">
    ```java theme={null}
    allprojects {
      repositories {
        maven {
            url "https://dl.cloudsmith.io/public/cometchat/cometchat/maven/"
        }
      }
    }
    ```
  </Tab>
</Tabs>

Then, add CometChatCalls to the app level `build.gradle` file in the `dependencies` section.

<Tabs>
  <Tab title="Groovy">
    ```java theme={null}
    dependencies {
      implementation 'com.cometchat:calls-sdk-android:4.3.3'
    }
    ```
  </Tab>
</Tabs>

## 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()` and `setRegion()` 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.

<Tabs>
  <Tab title="Java">
    ```java theme={null}
    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) {

            }
        }
    )
    ```
  </Tab>

  <Tab title="Kotlin">
    ```kotlin theme={null}
    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) {

            }
        }
    )
    ```
  </Tab>
</Tabs>

| Parameter         | Description                            |
| ----------------- | -------------------------------------- |
| `context`         | Android context for your application   |
| `callAppSettings` | An object of the CallAppSettings class |