Ringer Interactive SDK - iOS

Ringer is a swift package that allows the mobile app to save and update contacts along with notifications. The end result is such that the app can push fullscreen images to call recipients' mobile phones, and the SDK can provide information on the call recipient's device, such as OS version of Device, Device Name, and Timezone of Device.

Here are the instructions to implement this sdk within your own mobile application.

Step 1

Please visit the Releases to get latest package. Add the package using swift package manager in to your project.

Step 2

Firebase is required for this SDK. If there is already an existing Firebase pod in the project, please uninstall it.

Step 3

Add delegate (ringerInteractiveDelegate) into file to access notifications on the target device.

Step 4

Configure Firebase using FirebaseApp.configure() Add GoogleService-Info.plist file downloaded from firebase configuration.

Step 5

Create the object of RingerInteractiveNotification.

	let ringerObject = RingerInteractiveNotification()

Register notifications by using the RingerInteractiveNotification object name.

	ringerObject.notificationRegister()

Add delegate to self.

	ringerObject.ringerInteractiveDelegate = self

Step 6

Add contact usage description in Info.plist using give lines as below :-

	<key>NSContactsUsageDescription</key>
	<string>Our application needs to your contacts</string>

Step 7

Login into the SDK by using RingerInteractiveNotification object (example below):-

	ringerObject.ringerInteractiveLogin(username: “”, password: “”, CompanyName: “”, MobileNumber: “”)

Note :- CompanyName and MobileNumber are optional.

Step 8

Add these methods into AppDelegate to save and update contacts through notifications.

	func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification) {
		ringerObject.ringerInteractiveGetContact()
	}
    
	func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse) {
		ringerObject.ringerInteractiveGetContact()
	}
    
	func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any],fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
		ringerObject.ringerInteractiveGetContact()
		DispatchQueue.global().asyncAfter(deadline: .now() + 45.0) {
		    completionHandler(.newData)
		}
	}

Note :- iOS version above 11 is required to use this sdk.