Let's integrate our SDK in few minutes
#
Quick Start#
Call SDKs for iOSMake an easy and efficient way with CONTUS MirrorFly Call SDK for iOS - simply integrate the call features and functionalities into a client's app.
With client-side implementation, our call SDK lets you initialize and configure them easily. With the server-side, Our solution ensures the most reliable infra-management services for the calls within the app. Furthermore, we will let you know how to install the call SDK in your app for a better in-app call experience.
Note : To obtain a fastest way in action using CONTUS MirrorFly Call SDKs, you must try our trial app to enhance your Call app. So, just download our sample app and start with your app development. Click here to download the sample app.
#
RequirementsThe below are the requirements for call SDK for iOS,
- Xcode 13 or later
- iOS 12.1 or later
- Swift 5.0 or later
#
Points to be Noted Before Making a Move#
SDK License KeyBefore proceeding with CONTUS MirrorFly Call SDK integration, there must be an SDK license key that needs to be obtained for your MirrorFly application.
This SDK must be authenticated by the MirrorFly server by making use of the license key for further processing.
To obtain your license key you need to follow the below steps:
Step 1: Signup into MirrorFly Console page (https://console.mirrorfly.com/register) to create a free MirrorFly account.
Step 2: You can provide your basic details like your name, organization details, work email, and contact number while creating an account
Step 3: Once you get into the account! You get access to navigate all the content on your MirrorFly account. Now, click on the ‘Overview page’ and get access to the license key and downloadable iOS SDK file to proceed further with integration process
Step 4: Copy license key under "Application info" in "Overview" page
Step 5: To download the frameworks, click on the ‘Download’ button, this will take you to the top of this guided documentation page. Here, click on the given ‘Download button’ and extract the frameworks from the ZIP folder
Step 6: After downloading the files, You have to create a new project to start with integration process to build your chat app for iOS
#
Integrate Call SDKSince the SDKs were compiled into multiple XCFramework binary packages you need to start with SDK integration. Thus, you have to follow the below given steps,
Step 1: First extract the xcframework files from the downloaded zip file that is provided at the top of this guided documentation. Once extracted you get the following xcframeworks.
- FlyCall.xcframework
- FlyCore.xcframework
- FlyCommon.xcframework
- FlyNetwork.xcframework
- FlyDatabase.xcframework
- FlyXmpp.xcframework
- FlyTranslate.xcframework
Step 2: Add all the extracted xcframeworks to your project.
Step 3 : Now, disable the bitcodes for your project
Step 4: If you have not initiated any pods project before, then initiate the one. Now, add the required pods that are necessary for the SDK to execute the process perfectly.
Step 5: Add the below given pod hook code block at the end of the pod file and thus, finally install the pods.
Step 6: Now, enable all the below mentioned capabilities into your project.
Capabilities |
---|
App Groups |
Background Modes |
Now, go to the background mode and enable the below given modes
Background Modes |
---|
Audio,Airplay, and Picture in Picture |
Voice over IP |
Background fetch |
Remote notifications |
Step 7: Enable Audio and Video record permisions.
Provide Microphone and Camera usage description in the plist file of your project.
#
Configure the SDK server & DataNow, configure the server details in SDK and access the data globally using the AppDelegate class.
#
Initialize Data for CallsTo start using the sdk, there are a few basic pieces of data that must be made available for the SDKs to function perfectly.
Thus, we utilize the usage of the ChatSDK
builder class making the data available for SDKs. Furthermore, in your project you must use the AppDelegate
class within the didFinishLaunchingWithOptions
method and also provide required data to build the ChatSDK Builder. Let's have a look at the example given below.
- Swift
- Objective-C
#
Chat Builder Function DescriptionFunction | Parameter Type | Description |
---|---|---|
setAppGroupContainerID | String | Pass group container id of the project that stores UserDefaults and Database |
setLicenseKey | String | Used to proceed with Registration |
isTrialLicense | Bool | If the obtained license key is a trial license key - display the message as true else false |
setDomainBaseUrl | String | Url required to make API calls |
buildAndInitialize | n/a | Initialize the chat configuration |
caution
The base url must have Http/Https protocol which should be closed with a slash (/)
, or else will display an exception bug message
.
#
RegistrationThe below method should be called to register a new user. This method will take care of both Sandbox
mode registration as well as Live
mode registration based on isTrialLicense
provided in the ChatSDK.Builder
class.
info
Unless you logged out of a session, make sure that you have called the Registration
method only once in an application
Note: If the below
registerApiService
methods are available at the time of registration then can be passed across for further processing wherein, can be accepted as an optional param.
- APNS_DEVICE_TOKEN
- VOIP_TOKEN
- IS_EXPORT
- Swift
- Objective-C
Argument | Type | Description |
---|---|---|
USER_IDENTIFIER | String | Unique Id to Register the User |
APNS_DEVICE_TOKEN | String | Token to register APNS device (optional) |
VOIP_DEVICE_TOKEN | String | Token to register VoIP device (optional) |
IS_EXPORT | Bool | When API is export, the text will be displayed as true else false |
CALLBACK | FlyCompletionHanlder | FlyCompletionHanlder is implemented and expressed as lambda expression for easy reading |
To know more about
FlyCompletionHanlder
clickhere
#
Initialize Call SDKAfter successful registration, call the below method to initialize the Call SDK.
- Swift
- Objective-C
info
Also call the above method in the AppDelegate's didFinishLaunchingWithOptions
with a condition of isLoggedin
or isUserId available logic based on your app.
#
Connect to the Chat ServerIn order to transfer the initial call data payload, we can make use of Chat server for that you have to establish a connection to the chat server using the below given method.
- Swift
- Objective-C
#
Disconnect Chat ServerUse the below given method to disconnect from the chat server call.
- Swift
- Objective-C
#
Observe Connection EventsThe connection status can be observed and tracked by confirming the ConnectionEventDelegate
. To do that you need to set ‘delegate’ in your ViewController
's viewDidAppear
method like below.
- Swift
- Objective-C
Once the ConnectionEventDelegate
has been set, you will be able to receive the connection status in the delegate method as mentioned below. Learn more about this method @ ConnectionEventDelegate
.
- Swift
- Objective-C
#
TerminologyThe below given are some of the common keyword/terminologies used in the Chat SDK with description
Keyword | Description |
---|---|
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` |
info
SDK here provides the built-in functions to prepare the JID and Group JID.
#
Observe Call EventsTo observe Call events create and set a Singleton Class that conforms to the CallManagerDelegate
of FlyCall framework, and pass that object to the below method.
- Swift
- Objective-C
Argument | Type |
---|---|
CALLMANAGER_DELEGATE | CallManagerDelegate |
#
Setup Call UITo set the Call UI that has to be presented during an outgoing call, call the below method. An instantiated view controller object has to be passed in the method.
- Swift
- Objective-C
Argument | Type | Description |
---|---|---|
CALL_VIEW_CONTROLLER | UIViewController | A class that conforms to UIViewController |
#
Presenting the call UICall SDK handles the UI presentation for an outgoing call. Call the below method after declaring the Call SDK and or before making a call.The below method sets the view on top of which the call ui will be presented.
- Swift
- Objective-C
Argument | Description |
---|---|
VIEW_TO_PRESENT | ViewController in which Call UI has to be presented. |
info
Setting the CallManager.setViewToPresentController
is optional else the Call SDK will present the UI for an outgoing call in the project's root viewcontroller.
#
Make a Voice CallTo make a one to one voice call, call the below method.
- Swift
- Objective-C
Argument | Type | Description |
---|---|---|
USER_ID | String | Unique Id/userId/Jid of another registered user |
caution
To make and receive a voice/video call, Microphone and Camera usage permissions were required. Call SDK also provides method to check those permissions like CallManager.isAudioCallPermissionsGranted()
and CallManager.isVideoCallPermissionsGranted()
. We can also make use of these methods too.
caution
If one to one call feature unavailable for your plan then it will throw 403 exception.
#
Receive a callCall SDK will take care of receiving and processing the received call payload and triggering the CallKit
if you are connected to the server in foreground state.
Once the CallKit is being presented with Accept/Reject Call buttons, we can either choose to attend or reject the call. If we attend the call the below method of the CallManagerDelegate
will be triggered, and the status wil be of the case ATTENDED
. Inside that method we can present the incoming call UI.
- Swift
- Objective-C
Argument | Type | Description |
---|---|---|
CALLSTATUS | CALLSTATUS enum | An enum class defines the current status of the call |
USER_ID | String | For this CALLSTATUS our own userId will be returned from SDK |
info
To know more about the CallManagerDelegate
protocol and its delegate methods visit here
#
Push and Voip NotificationsTo receive calls in the background and in killed state, kindly register for remote as well for voip notification by conforming to the following delegates in the AppDelegate UNUserNotificationCenterDelegate
PKPushRegistryDelegate
.
Call the below methods when an APNS token or VOIP token gets updated.
- Swift
- Objective-C
Argument | Description |
---|---|
TOKEN | Apns or Voip Token |
In class that extends the UNNotificationServiceExtension
after validating whether the received payload is for call or not, call the below method
to process the call further.
- Swift
- Objective-C
Argument | Type | Description |
---|---|---|
NOTIFICATION_CONTENT | UNMutableNotificationContent | Notification request content |
COMPLETION_BLOCK | (UNMutableNotificationContent?) -> Void | Completion Block |
Send the payload received through VOIP from the method didReceiveIncomingPushWith
to the method below to process the call further.
- Swift
- Objective-C
Argument | Description |
---|---|
PAYLOAD | Payload Dictionary |