iOS

This article will help you to start building your iOS application with Voximplant.

There are two ways to add Voximplant libraries to your Xcode project: Cocoapods and Swift Package Manager.

1. Install CocoaPods (See CocoaPods getting started guide)
2. If you do not have a podfile, create it by running pod init in the project directory
3. Add VoxImplantSDK dependency in the Podfile:

platform: ios, '11.0'
use_frameworks!

target 'MyApp' do
    // other dependencies and configurations
    pod 'VoxImplantSDK'
end

4. Run the pod install command in the project directory to install the SDK
5. From now on, open your project via the newly created .xcworkspace file

Alternatively, you can use Swift Package Manager to add the dependencies to your project.

1. Open your project in Xcode
2. Go File → Swift Packages → Add Package Dependency
3. Add the iOS SDK github repository contents.
4. Select the SDK version
5. Declare the package in the Package.swift file's dependencies section:

dependencies: [
    .package(url: "https://github.com/voximplant/ios-sdk-releases.git", .upToNextMinor(from: "2.53.0"))
]

1. If you need to use the camera and microphone in your app, open the Info.plist file in your project and add the following keys:

Provide values to the added keys. The value is what a device shows when it prompts for camera or microphone access.

2. Declare four Background modes. Go to your project's main file, Singing & Capabilities tab, click the "+" button on the top, and choose "Background modes". To enable calls and push notification functionality, choose the following modes as you see on the screenshot:

Now you are ready to create a Voximplant client instance. To do so, import VoxImplantSDK to your swift class and create an instance of VIClient as shown below:

To create a client instance and to connect, import VoxImplantSDK to your swift class. Also, your class should support the VIClientSessionDelegate protocol.

On the class initialization, create a Voximplant client instance and declare your class as a session delegate for the client instance (see the code example below). Then call the connect method to connect to the cloud.

In the clientSessionDidConnect function, call the login(password) method to log in to the platform with a password or the login(oneTimeKey) to log in with one-time key.

Refer to this code example to understand the login process:

Now you have your application and SDK set up and successfully connected to the Voximplant cloud. To start implementing desired functionality, such as calls, conferences, messages, and more, go to the Guides section of our documentation and pick the features you need.

Implement the desired functionality by following step-by-step Guides or download and test our latest iOS SDK here: