General

Get TapTalk Implementation Type

You can get your current TapTalk.io implementation type by using this method.

Objective-C

#import <TapTalk/TapTalk.h>
  
// Get current used implementation Type
[[TapTalk sharedInstance] getTapTalkImplementationType];

Note:

TapTalkImplementationType consists of 3 types which are : TapTalkImplementationTypeUI: used for implementation with only TapUITapTalkImplementationTypeCore: used for implementation with only TapCoreTapTalkImplementationTypeCombine: used for implementation with both of TapCore and TapUI combined

Check TapTalk Initialized

You can check whether TapTalk instance has completed initialization by calling the method below.

Objective-C

#import <TapTalk/TapTalk.h>
  
BOOL isInitialized = [[TapTalk sharedInstance] checkTapTalkInitialized];

Update Application Badge Count

You can get your current TapTalk.io implementation type by using this method.

Objective-C

#import <TapTalk/TapTalk.h>
  
[[TapTalk sharedInstance] updateApplicationBadgeCount];

To listen to changes of application badge, please see the explanation in event delegate page usingtapTalkUnreadChatRoomBadgeCountUpdatedmethod

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

Objective-C

#import <TapTalk/TapTalk.h>
  
NSDictionary *coreConfigsDictionary = [[TapTalk sharedInstance] getCoreConfigs];
NSString *maxFileSizeString = [coreConfigsDictionary objectForKey:@"maxFileSize"];
NSInteger maxFileSizeValue = [maxFileSizeString integerValue];

Project Configs

Config Key	Value
usernameIgnoreCase	"0" if username in the project is case sensitive "1" if username in the project is case insensitive

An example to obtain usernameIgnoreCase value:

Objective-C

#import <TapTalk/TapTalk.h>
  
NSDictionary *projectConfigsDictionary = [[TapTalk sharedInstance] getProjectConfigs];
NSString *usernameIgnoreCaseString = [projectConfigsDictionary objectForKey:@"usernameIgnoreCase"];
BOOL usernameIgnoreCase = [usernameIgnoreCaseString boolValue];

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.

Objective-C

#import <TapTalk/TapTalk.h>
  
NSDictionary *customConfigsDictionary = [[TapTalk sharedInstance] getCustomConfigs];

Refresh Remote Configs

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

Objective-C

#import <TapTalk/TapTalk.h>
  
[[TapTalk sharedInstance] refreshRemoteConfigs];

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.

Objective-C

#import <TapTalk/TapTalk.h>
  
// Enable or disabled auto contact sync
// Value is enabled by default if you do not set this method
[[TapTalk sharedInstance] setAutoContactSyncEnabled:IS_ENABLED];

Parameter IS_ENABLED: (BOOL) set to TRUE/YES to enable auto contact sync

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.

Objective-C

#import <TapTalk/TapTalk.h>
  
BOOL isAutoContactSyncEnabled = [[TapTalk sharedInstance] isAutoContactSyncEnabled];

Obtain Current Navigation Controller in TapUI

To refresh remote configs with the latest updated values, call the refreshRemoteConfigs method in TapTalk.If you are using TapUI and want to integrate with your app, you can get the current active view controller or navigation controller by using the following codes.

Objective-C

#import <TapTalk/TapUI.h>

// Get TapTalk.io current active view controller
UIViewController *activeViewController = [[TapUI sharedInstance] getCurrentTapTalkActiveViewController];

// Get TapTalk.io current active navigation controller
UINavigationController *activeNavigationController = [[TapUI sharedInstance] getCurrentTapTalkActiveNavigationController];

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 0.1f and 1.0f. The higher the quality, the better the images will look, but they will also take more storage space as their size increases.

Objective-C

#import <TapTalk/TapTalk.h>

[[TapTalk sharedInstance] setImageCompressionQuality:IMAGE_COMPRESSION_QUALITY];

Parameters IMAGE_COMPRESSION_QUALITY: (CGFloat) image compression quality between 0.1f to 1.0f

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.