To add the SDK into your application, you can either use Carthage dependency manager, CocoaPods dependency manager, or the latest VoxeetSDK zip file available on the Voxeet GitHub.

Using Carthage dependency manager:

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.

1. Install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

2. To integrate Dolby Interactivity APIs iOS SDK into your Xcode project using Carthage, specify it in your Cartfile:

binary "https://raw.githubusercontent.com/voxeet/voxeet-sdk-ios/master/VoxeetSDK.json" ~> 3.0

3. Run carthage update to build the frameworks and drag VoxeetSDK.framework, WebRTC.framework, and Dvmc.framework into your Xcode project. For more information, see additional Carthage instructions.

Using CocoaPods dependency manager:

Go to the CocoaPods webpage and install the VoxeetSDK.

pod 'VoxeetSDK', '~> 3.0'

Using the latest zip file from the Voxeet GitHub:

1. Download the latest zip file.

2. Unzip the file and drag and drop frameworks into your project.

3. Select the Copy items if needed option and select the proper target.

4. Add the VoxeetSDK.framework, WebRTC.framework, and Dvmc.framework into Embedded Binaries in the general tab of your target.

import VoxeetSDK

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
    func fetchToken(completion: @escaping (_ token: String?) -> Void) {
        let url = URL(string: serverURL + "/api/token")!
        let task = URLSession.shared.dataTask(with: url) { data, _, _ in
            if let data = data,
              let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any],
              let accessToken = json["access_token"] as? String {
                completion(accessToken)
            } else {
                completion(nil)
            }
        }
        task.resume()
    }

    func application(
        application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {

        // Fetch access token.
        fetchToken { accessToken in
            guard let token = accessToken else { return }

            // Voxeet SDK OAuth initialization.
            VoxeetSDK.shared.initialize(accessToken: token) { refreshClosure in
                // VoxeetSDK calls this closure when the token needs to be refreshed.
                // See the next section for details.
            }
        }

        return true
    }
}

The last parameter passed to VoxeetSDK.initialize(accessToken:refreshTokenClosure:) is a closure that is called when the token needs to be refreshed. This closure is passed a single parameter, which is a VoxeetSDK closure, which the application calls with the refreshed access token:

import VoxeetSDK

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
    ...

    func application(
        application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {

        // Fetch access token.
        fetchToken { accessToken in
            guard let token = accessToken else { return }

            // Voxeet SDK OAuth initialization.
            VoxeetSDK.shared.initialize(accessToken: token) { refreshClosure in
                // VoxeetSDK calls this closure when the token needs to be refreshed.
                fetchToken { accessToken in
                    guard let token = accessToken else { return }

                    // Call the SDK’s refresh closure with the new token
                    refreshClosure(token)
                }
            }
        }

        return true
    }
}

Open a session for the participant using the following code:

let info = VTParticipantInfo(externalID: nil, name: "Username", avatarURL: nil)
VoxeetSDK.shared.session.open(info: info) { error in }

After the conference, you can close it using the following code:

Example

VoxeetSDK.shared.session.close { error in }