Skip to content

Zoom Video SDK UI toolkit iOS package.

Notifications You must be signed in to change notification settings

gonativeio/videosdk-ui-toolkit-ios

 
 

Repository files navigation

Zoom Video SDK UI toolkit

The Zoom Video SDK UI toolkit is a prebuilt video chat user interface powered by the Zoom Video SDK.

The use of this UI Took Kit is subject to the beta program terms of use and the Video SDK terms of service. Copyright 2023 Zoom Video Communications, Inc. All rights reserved.

Prerequisites

  • Xcode
  • A physical 64-bit iOS device (iPhone or iPad) with iOS version 11.0+
  • A Zoom account with Video SDK credentials
  • A validated provisioning profile certificate

Installation

Currently, the Zoom Video SDK UI toolkit is available through Swift Package Manager.

https://github.com/zoom/videosdk-ui-toolkit-ios.git

Required App Permissions

In order for the camera and mic to work during the session, add the following:

Permission Required Optional Permission Key Description
Camera Required NSCameraUsageDescription Required for Video
Microphone Required NSMicrophoneUsageDescription Required for Audio
Bluetooth Required NSBluetoothPeripheralUsageDescription Required for Bluetooth audio devices

Authorize

Learn how to use your credentials to authenticate so you can connect.

See the Video SDK Auth Endpoint Sample for a sample app that shows how to quickly, easily, and securely generate a Video SDK JWT.

Usage

After understanding the authorization process, we can simply add Zoom Video SDK UI toolkit into your View Controller by following the 3 steps below.

Step 1. Create the SessionContext

Create the SessionContext that takes in the required parameters such as JWT, session name and username (display name). If your session requires a password, you can use the password parameter.

let sessionContext = SessionContext(jwt: String, sessionName: String, username: String)

// OR if password is required
let sessionContext = SessionContext(jwt: String, sessionName: String, sessionPassword: String?, username: String)

Step 2. Create the Zoom Video View Controller and present it

Create the UIToolkitVC that takes in the sessionContext and present it.

let vc = UIToolkitVC(sessionContext: sessionContext)
vc.delegate = self
vc.modalPresentationStyle = .fullScreen
present(toolkitVC, animated: true)

Step 3. Delegate

There is a delegate class UIToolkitDelegate which consists of important callbacks such as error, view is loaded and dismissed.

extension YourViewController: UIToolkitDelegate {
    func onError(_ errorType: UIToolkitError) {
        print("UIToolkitVC onError: \(errorType.rawValue) -> \(errorType.description)")
    }
    
    func onViewLoaded() {
        print("UIToolkitVC onViewLoaded")
    }
    
    func onViewDismissed() {
        print("UIToolkitVC onViewDismissed")
    }
}

See the Zoom Video SDK UI toolkit documentation for more.

Need help?

If you're looking for help, try Developer Support or our Developer Forum. Priority support is also available with Premier Developer Support plans.



Copyright 2023 Zoom Video Communications, Inc. All rights reserved.

About

Zoom Video SDK UI toolkit iOS package.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Objective-C 86.9%
  • C 12.2%
  • Other 0.9%