# General

### Get TapTalk Implementation Type

You can check the TapTalk.io implementation type used in your application by calling `getTapTalkImplementationType()`.

{% tabs %}
{% tab title="Java" %}

```java
import io.taptalk.TapTalk.Helper.TapTalk;
import io.taptalk.TapTalk.Helper.TapTalk.TapTalkImplementationType;

...

TapTalkImplementationType implementationType = TapTalk.getTapTalkImplementationType();
```

{% endtab %}

{% tab title="Kotlin" %}

```kotlin
import io.taptalk.TapTalk.Helper.TapTalk
import io.taptalk.TapTalk.Helper.TapTalk.TapTalkImplementationType

...

var implementationType = TapTalk.getTapTalkImplementationType()
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
**IMPLEMENTATION\_TYPE**

TapTalk implementation consists of 3 types which are:

* TapTalkImplementationTypeUI: used for implementation with only TapUI
* TapTalkImplementationTypeCore: used for implementation with only TapCore
* TapTalkImplementationTypeCombine: used for implementation with both of TapCore and TapUI combined
  {% endhint %}

### Update Application Badge Count

Calling `updateApplicationBadgeCount()` will refresh the number of unread messages in the application and trigger the callback `onTapTalkUnreadChatRoomBadgeCountUpdated()` present in [TapListener](https://docs.taptalk.io/powertalk-chat-sdk-documentation/event-listener#taplistener).

{% tabs %}
{% tab title="Java" %}

```java
import io.taptalk.TapTalk.Helper.TapTalk;

...

TapTalk.updateApplicationBadgeCount();
```

{% endtab %}

{% tab title="Kotlin" %}

```kotlin
import io.taptalk.TapTalk.Helper.TapTalk

...

TapTalk.updateApplicationBadgeCount()
```

{% endtab %}
{% endtabs %}

### Remote Configs

A TapTalk.io project owns a remote configuration, which consists of 3 configuration types: **Core Configs**, **Project Configs**, and **Custom Configs**. A configuration value can be obtained with the respective configuration type's getter method, and will return a **Map** object. To get a specific value, call the `get()` method from the returned Map with the respective key. The value obtained will always be in a **String** format and should be converted each according to their uses. Each configuration type will be explained below.

### Core Configs

| Config Key             | Value                                                                        |
| ---------------------- | ---------------------------------------------------------------------------- |
| chatMediaMaxFileSize   | Number of maximum allowed chat media file size in bytes                      |
| roomPhotoMaxFileSize   | Number of maximum allowed group chat room profile picture file size in bytes |
| userPhotoMaxFileSize   | Number of maximum allowed user profile picture file size in bytes            |
| groupMaxParticipants   | Number of maximum allowed participants in a group chat room                  |
| channelMaxParticipants | Number of maximum allowed participants in a channel                          |

Below is an example to get the value of chatMediaMaxFileSize:

{% tabs %}
{% tab title="Java" %}

```java
import io.taptalk.TapTalk.Helper.TapTalk;

...

Map<String, String> coreConfigs = TapTalk.getCoreConfigs();
String maxFileSizeString = coreConfigs.get("chatMediaMaxFileSize");
long maxFileSizeValue = Long.valueOf(maxFileSize);
```

{% endtab %}

{% tab title="Kotlin" %}

```kotlin
import io.taptalk.TapTalk.Helper.TapTalk

...

val coreConfigs = TapTalk.getCoreConfigs()
val maxFileSizeString = coreConfigs["chatMediaMaxFileSize"]
val maxFileSizeValue = maxFileSize?.toLong()
```

{% endtab %}
{% endtabs %}

### Project Configs

| Config Key         | Value                                                                                                                                           |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| usernameIgnoreCase | <p><strong>"0"</strong> if username in the project is case sensitive<br><strong>"1"</strong> if username in the project is case insensitive</p> |

An example to obtain usernameIgnoreCase value:

{% tabs %}
{% tab title="Java" %}

```java
import io.taptalk.TapTalk.Helper.TapTalk;

...

Map<String, String> projectConfigs = TapTalk.getProjectConfigs(); 
String usernameIgnoreCase = projectConfigs.get("usernameIgnoreCase");
boolean isUsernameIgnoreCase;
if (usernameIgnoreCase.equals("0")) {
    isUsernameIgnoreCase = false;
}
else if (usernameIgnoreCase.equals("1")) {
    isUsernameIgnoreCase = true;
}
```

{% endtab %}

{% tab title="Kotlin" %}

```kotlin
import io.taptalk.TapTalk.Helper.TapTalk

...

val projectConfigs = TapTalk.getProjectConfigs()
val usernameIgnoreCase = projectConfigs["usernameIgnoreCase"]
val isUsernameIgnoreCase: Boolean
if (usernameIgnoreCase == "0") {
    isUsernameIgnoreCase = false
}
else if (usernameIgnoreCase == "1") {
    isUsernameIgnoreCase = true
}
```

{% endtab %}
{% endtabs %}

### Custom Configs

Custom config values are specified by the user, and can be customized through the TapTalk.io Dashboard. To get the project's custom configs, call the `getCustomConfigs()` method.JavaKotlin

{% tabs %}
{% tab title="Java" %}

```java
import io.taptalk.TapTalk.Helper.TapTalk;

...

Map<String, String> customConfigs = TapTalk.getCustomConfigs();
```

{% endtab %}

{% tab title="Kotlin" %}

```kotlin
import io.taptalk.TapTalk.Helper.TapTalk

...

val customConfigs = TapTalk.getCustomConfigs()
```

{% endtab %}
{% endtabs %}

### Refresh Remote Configs

To refresh remote configs with the latest updated values, call the `refreshRemoteConfigs()` method in TapTalk.io class.

{% tabs %}
{% tab title="Java" %}

```java
import io.taptalk.TapTalk.Helper.TapTalk;
import io.taptalk.TapTalk.Listener.TapCommonListener;

...

TapTalk.refreshRemoteConfigs(new TapCommonListener() {
    @Override
    public void onSuccess(String successMessage) {
        // Updated configs successfully
    }

    @Override
    public void onError(String errorCode, String errorMessage) {
        
    }
});
```

{% endtab %}

{% tab title="Kotlin" %}

```kotlin
import io.taptalk.TapTalk.Helper.TapTalk
import io.taptalk.TapTalk.Listener.TapCommonListener

...

TapTalk.refreshRemoteConfigs(object : TapCommonListener() {
    override fun onSuccess(successMessage: String?) {
        // Updated configs successfully
    }

    override fun onError(errorCode: String?, errorMessage: String?) {

    }
})
```

{% endtab %}
{% endtabs %}

### Enable / Disable Auto Contact Sync

If you are using UI implementation method in your application, TapTalk.io provides a feature to automatically sync your user's phone contacts with their TapTalk.io contacts. You can choose to enable or disable auto contact sync by calling these methods. If auto contact sync is enabled, TapTalk.io will automatically sync your user's phone contacts and add them to TapTalk.io contacts if their phone number is registered to TapTalk.io when the application is opened. Please note that the **default value** is **enabled**.JavaKotlin

{% tabs %}
{% tab title="Java" %}

```java
import io.taptalk.TapTalk.Helper.TapTalk;

...

@Override
public void onCreate() {
    ...
    
    // Call this method to enable or disable auto contact sync
    // The default value is set to enabled if you do not set this method
    TapTalk.setAutoContactSyncEnabled(IS_ENABLED);
}
```

{% endtab %}

{% tab title="Kotlin" %}

```kotlin
import io.taptalk.TapTalk.Helper.TapTalk

...

override fun onCreate(savedInstanceState: Bundle?) {
    ...
    
    // Call this method to enable or disable auto contact sync
    // The default value is set to enabled if you do not set this method
    TapTalk.setAutoContactSyncEnabled(IS_ENABLED)
}
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
**Parameters**\
\&#xNAN;**`IS_ENABLED`**: (boolean) set to true to enable auto contact sync
{% endhint %}

### Get Auto Contact Sync Status

Use this method to obtain auto contact sync status. This method will return `true` if auto contact sync is enabled.

{% tabs %}
{% tab title="Java" %}

```java
import io.taptalk.TapTalk.Helper.TapTalk;

...

boolean isAutoContactSyncEnabled = TapTalk.isAutoContactSyncEnabled();
```

{% endtab %}

{% tab title="Kotlin" %}

```kotlin
import io.taptalk.TapTalk.Helper.TapTalk

...

val isAutoContactSyncEnabled = TapTalk.isAutoContactSyncEnabled()
```

{% endtab %}
{% endtabs %}

### Get Current Activity / Fragment in TapUI

You can obtain the currently showing room list fragment, chat activity, or any TapTalk activity from **TapUI** using the following methods:

{% tabs %}
{% tab title="Java" %}

```java
import io.taptalk.TapTalk.Manager.TapUI;
import io.taptalk.TapTalk.View.Fragment.TapUIRoomListFragment;
import io.taptalk.TapTalk.View.Activity.TapUIChatActivity;

...

// Obtain TapUIRoomListFragment
TapUIRoomListFragment currentTapTalkRoomListFragment = TapUI.getInstance().getCurrentTapTalkRoomListFragment();

// Obtain currently showing TapUIChatActivity
TapUIChatActivity currentTapTalkChatActivity = TapUI.getInstance().getCurrentTapTalkChatActivity();

// Obtain any AppCompatActivity in the foreground
AppCompatActivity currentForegroundTapTalkActivity = TapUI.getInstance().getCurrentForegroundTapTalkActivity();
```

{% endtab %}

{% tab title="Kotlin" %}

```kotlin
import io.taptalk.TapTalk.Manager.TapUI
import io.taptalk.TapTalk.View.Fragment.TapUIRoomListFragment
import io.taptalk.TapTalk.View.Activity.TapUIChatActivity

...

// Obtain TapUIRoomListFragment
val currentTapTalkRoomListFragment = TapUI.getInstance().getCurrentTapTalkRoomListFragment()

// Obtain currently showing TapUIChatActivity
val currentTapTalkChatActivity = TapUI.getInstance().getCurrentTapTalkChatActivity()

// Obtain any AppCompatActivity in the foreground
val currentForegroundTapTalkActivity = TapUI.getInstance().getCurrentForegroundTapTalkActivity()
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
Note: the methods above may return `null` if the selected activity or fragment is not found.
{% endhint %}

### Set Image Compression Quality

You can customize the compression quality of images used for upload and download. The range of the compression quality is set between 10 and 100. The higher the quality, the better the images will look, but they will also take more storage space as their size increases.

{% tabs %}
{% tab title="Java" %}

```java
import io.taptalk.TapTalk.Helper.TapTalk;

...

TapTalk.setImageCompressionQuality(IMAGE_COMPRESSION_QUALITY);
```

{% endtab %}

{% tab title="Kotlin" %}

```kotlin
import io.taptalk.TapTalk.Helper.TapTalk

...

TapTalk.setImageCompressionQuality(IMAGE_COMPRESSION_QUALITY)
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
**Parameters**\
\&#xNAN;**`IMAGE_COMPRESSION_QUALITY`**: (int) image compression quality between 10 to 100
{% endhint %}

### Smart Local Cache Management

In order to optimize storage usage and performance, TapTalk.io cleans any local data of messages that are older than 1 month. This cleanup runs on a scheduled interval. Deleted messages can later be retrieved from the server when required.

### Encrypted Chat

TapTalk.io SDK encrypts all message contents before sending them to the server to protect any sensitive content contained in the messages. All messages received and stored in the server will stay encrypted. Messages will be decrypted once fetched in end user's local device in order to show their contents. TapTalk.io uses **AES Crypt** combined with secure local password to encrypt and decrypt message contents.