Setup

An in-depth guide on how to configure CometChat.

Get your Application Keys

Signup for CometChat and then:

  1. Create a new app on the dashboard

🚧

Important

Please follow the key concepts guide to create V3 apps.

  1. Head over to the API & Auth Keys section and note the Auth Key, App ID & Region

Add the CometChat Dependency

Install the package as NPM module:

npm install @cometchat-pro/[email protected] --save

In order to integrate the CometChat Pro React Native SDK, you need to install one more dependency

  1. Async-Storage:
npm install @react-native-async-storage/async-storage

📘

Important

v2.4+ onwards, Voice & Video Calling functionality has been moved to a separate library. In case you plan to use the calling feature, please install the Calling dependency (@cometchat-pro/react-native-calls).

npm install @cometchat-pro/[email protected] --save

The calling component requires some configuration. Please follow the steps mentioned here.

Calling Component Configuration

Android

Goto ./android folder and open project level build.gradle file. And all repository URLs in the repositories block under the allprojects section.

allprojects {
  repositories {
    maven {
            url "https://dl.cloudsmith.io/public/cometchat/cometchat-pro-android/maven/"
        }
  }
}

Also in the same file in the buildscript section in the ext block make sure you have set minSdkVersion to 24

buildscript {
    ext {
        buildToolsVersion = "29.0.2"
        minSdkVersion = 24
        compileSdkVersion = 29
        targetSdkVersion = 29
    }
}

Initialize CometChat

The init() method initializes the settings required for CometChat.

The init() method takes the below parameters:

  1. APP_ID - You CometChat App ID
  2. appSettings - An object of the AppSettings class can be created using the AppSettingsBuilder class. The region field is mandatory and can be set using the setRegion() method.

The AppSettings class allows you to configure two settings:
a. Region of the App: The Region code for the app. (For example, eu for Europe)
b. Presence Subscription.

You need to call init() before calling any other method from CometChat.

var appId = "APP_ID";
let cometChatSettings = new CometChat.AppSettingsBuilder().subscribePresenceForAllUsers().setRegion('us').build();
CometChat.init(appId, cometChatSettings)
  .then(
    () => {
      console.log("Initialization completed successfully");
      //You can now call login function.
    },
    error => {
      console.log("Initialization failed with error:", error);
      //Check the reason for error and take apppropriate action.
    }
  );

Parameter

Description

appID

CometChat App ID

appSetting

An object of the AppSettings class.


Did this page help you?