Let's integrate Plugin for Flutter

Quick Start

Chat Plugin for Flutter

With CONTUS MirrorFly Chat Plugin for Flutter, you can easily add real-time chat features to your client app within 30 minutes. Through our client SDK, you can initialize and configure chat into your app with minimal efforts.

Note : If you're looking for the fastest way to build your app’s UI with MirrorFly Chat Plugin, you can use our sample apps. To get our sample apps, click here

Requirements

The requirements for Android are:

• Android Lollipop 5.0 (API Level 21) or above
• Java 7 or higher
• Gradle 4.1.0 or higher The minimum requirements for Chat SDK for iOS
• iOS 12.1 or later

Things to be Noted Before Making a Start

Mirrorfly License Key

Follow the below steps to get your license key:

Step 1: Sign up into MirrorFly Console page (https://console.mirrorfly.com/register) for free MirrorFly account, If you already have a MirrorFly account, sign into your account

Step 2: Once you’re in! You get access to your MirrorFly account ‘Overview page’ where you can find a license key for further integration process

Step 3: Copy the license key from the ‘Application info’ section

Install UIKit

Create Android dependency

Step 4: Add the following to your root build.gradle file in your Android folder.

allprojects {

repositories {

google()

mavenCentral()

jcenter()

maven {

url "https://repo.mirrorfly.com/snapshot/"

}

}

}

Add the following dependencies in the app/build.gradle file.

android {

packagingOptions {

exclude 'META-INF/AL2.0'

exclude 'META-INF/DEPENDENCIES'

exclude 'META-INF/LICENSE'

exclude 'META-INF/LICENSE.txt'

exclude 'META-INF/license.txt'

exclude 'META-INF/NOTICE'

exclude 'META-INF/NOTICE.txt'

exclude 'META-INF/notice.txt'

exclude 'META-INF/ASL2.0'

exclude 'META-INF/LGPL2.1'

exclude("META-INF/*.kotlin_module")

}

}

Create iOS dependency

Step 5: Check and Add the following code at end of your ios/Podfile

post_install do |installer|

installer.pods_project.targets.each do |target|

flutter_additional_ios_build_settings(target)

target.build_configurations.each do |config|

config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '12.1'

config.build_settings['ENABLE_BITCODE'] = 'NO'

config.build_settings['APPLICATION_EXTENSION_API_ONLY'] = 'No'

config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'

config.build_settings["EXCLUDED_ARCHS[sdk=iphonesimulator*]"] = "arm64"

end

end

end

Step 6: Now, enable all the below mentioned capabilities into your project.

Goto Project -> Target -> Signing & Capabilities -> Click + at the top left corner -> Search for the capabilities below

Capabilities
App Groups

Create Flutter dependency

Step 7: Add the below dependencies in pubspec.yaml.

dependencies:

mirrorfly_plugin: ^0.0.7

STEP 8: Run flutter pub get command in your project directory. You can use all classes and methods just with the following import statement

import 'package:mirrorfly_plugin/mirrorfly.dart';

Initialize MirrorFly Plugin

To initialize the plugin, place the below code in your main.dart file inside main function before runApp().

void main() {

WidgetsFlutterBinding.ensureInitialized();

Mirrorfly.init(

baseUrl: 'https://api-preprod-sandbox.mirrorfly.com/api/v1/',

licenseKey: 'Your_Mirrorfly_Licence_Key',

iOSContainerID: 'Your_iOS_app_Group_id');

runApp(const MyApp());

}

Chat init Function Description

Function	Parameter Type	Description
baseUrl	String	Url is provided to make API calls
licenseKey	String	License key is required to proceed with registration
iOSContainerID	String	Create App groups and assign the obtained group container id. Plugin uses this string to create the path for the local storage.

caution

The base URL must have the Http/Https protocol which must be closed with a ‘slash (/)’, if not an exception - a bug message will pop up.

Registration

Use the below method to register a user in sandbox Live mode.

Unless you log out the session, make a note that should never call the registration method more than once in an application

Note: While registration, the below registerUser method will accept the FCM_TOKEN as an optional param and pass it across. The connection will be established automatically upon completion of registration and not required for seperate login.

Mirrorfly.registerUser(userIdentifier).then((value) {

// you will get the user registration response

var userData = registerModelFromJson(value);

}).catchError((error) {

// Register user failed print throwable to find the exception details.

debugPrint(error.message);

});

Argument	Type	Description
userIdentifier	String	A unique Id to Register the User. We accept only the AlphaNumeric String
token	String	A registration token that is generated by FCM Plugin for the user's app instance to send message for free

Terminology

Some of the most common terminologies used in MirrorFly Plugin with description

keyword	Explanation
userID/userBareID	Unique ID assigned for each user Ex: 12345678 (any alphanumeric). The below characters is not allowed in userId: U+0022 (") U+0026 (&) U+0027 (') U+002F (/) U+003A (:) U+003C (<) U+003E (>) U+0040 (@) userID should follow below specification: https://xmpp.org/extensions/xep-0106.html
userJid (or) JID	userID+@+domain of the chat server Ex. 12345678@xmpp.chatsystem.dev.contus.us
groupID/groupBareID	Unique ID assigned for each group Ex: group123456 (any alphanumeric). GroupJID = groupID +@mix.+domain of the chat server Ex: group123456@mix.xmpp.mirrorfly.dev.contus.us`

Plugin will have built-in functions to prepare the JID, Group JID, and more.

Send a One-to-One Message

Use the below method to send a text message to other user,

Note: To generate a unique user jid by username, you must call the below method

var userJid = await Mirrorfly.getJid(username);

Mirrorfly.sendTextMessage(message, jid).then((value) {

// you will get the message sent success response

var chatMessage = sendMessageModelFromJson(value);

});

Argument	Type	Description
jid	String	JID of the end user
message	String	Indicates the text message that needs to be sent
replyMessageId	String	Specifies the Message ID of replied message (Optional)

Receive a One-to-One Message

Here the listeners would be called only when a new message is received from other user. To get more details please visit this callback listeners

Mirrorfly.onMessageReceived.listen(result){

// you will get the new messages

var chatMessage = sendMessageModelFromJson(result)

}