Cisco Webex iOS SDK

The Cisco Webex iOS SDK makes it easy to integrate secure and convenient Cisco Webex messaging and calling features in your iOS apps.

This SDK is written in Swift 4 and requires iOS 10 or later.

Table of Contents

• Install
• Usage
• License

Install

Assuming you already have an Xcode project, e.g. MyWebexApp, for your iOS app, here are the steps to integrate the Webex iOS SDK into your Xcode project using CocoaPods:

1. Install CocoaPods:

   gem install cocoapods

2. Setup CocoaPods:

   pod setup

3. Create a new file, Podfile, with following content in your MyWebexApp project directory:

   source 'https://github.com/CocoaPods/Specs.git'
   
   use_frameworks!
   
   target 'MyWebexApp' do
     platform :ios, '10.0'
     pod 'WebexSDK'
   end
   
   target 'MyWebexAppBroadcastExtension' do
       platform :ios, '11.2'
       pod 'WebexBroadcastExtensionKit'
   end

4. Install the Webex iOS SDK from your MyWebexApp project directory:

   pod install

Usage

To use the SDK, you will need Cisco Webex integration credentials. If you do not already have a Cisco Webex account, visit Webex for Developers to create your account and register your integration. Your app will need to authenticate users via an OAuth grant flow for existing Cisco Webex users or a JSON Web Token for guest users without a Cisco Webex account.

See the iOS SDK area of the Webex for Developers site for more information about this SDK.

Example

Here are some examples of how to use the iOS SDK in your app.

1. Create the Webex instance using Webex ID authentication (OAuth-based):

   let clientId = "$YOUR_CLIENT_ID"
   let clientSecret = "$YOUR_CLIENT_SECRET"
   let scope = "webex:all"
   let redirectUri = "Webexdemoapp://response"
   
   let authenticator = OAuthAuthenticator(clientId: clientId, clientSecret: clientSecret, scope: scope, redirectUri: redirectUri)
   let webex = Webex(authenticator: authenticator)
   
   if !authenticator.authorized {
       authenticator.authorize(parentViewController: self) { success in
           if !success {
               print("User not authorized")
           }
       }
   }

2. Create the Webex instance with Guest ID authentication (JWT-based):

   let authenticator = JWTAuthenticator()
   let webex = Webex(authenticator: authenticator)
   
   if !authenticator.authorized {
       authenticator.authorizedWith(jwt: myJwt)
   }

3. Register the device to send and receive calls:

   webex.phone.register() { error in
       if let error = error {
           // Device not registered, and calls will not be sent or received
       } else {
           // Device registered
       }
   }

4. Use Webex service:

   webex.spaces.create(title: "Hello World") { response in
       switch response.result {
       case .success(let space):
           // ...
       case .failure(let error):
           // ...
       }
   }
   
   // ...
   
   webex.memberships.create(spaceId: spaceId, personEmail: email) { response in
       switch response.result {
       case .success(let membership):
           // ...
       case .failure(let error):
           // ...
       }
   }

5. Make an outgoing call:

   webex.phone.dial("[email protected]", option: MediaOption.audioVideo(local: ..., remote: ...)) { ret in
       switch ret {
       case .success(let call):
           call.onConnected = {
               // ...
           }
           call.onDisconnected = { reason in
               // ...
           }
       case .failure(let error):
           // failure
       }
   }

6. Receive a call:

   webex.phone.onIncoming = { call in
       call.answer(option: MediaOption.audioVideo(local: ..., remote: ...)) { error in
       if let error = error {
           // success
       }
       else {
           // failure
       }
   }

7. Make an space call:

   webex.phone.dial(spaceId, option: MediaOption.audioVideo(local: ..., remote: ...)) { ret in
       switch ret {
       case .success(let call):
           call.onConnected = {
               // ...
           }
           call.onDisconnected = { reason in
               // ...
           }
           call.onCallMembershipChanged = { changed in
               switch changed {
               case .joined(let membership):
                   //
               case .left(let membership):
                   //
               default:
                   //
               }                
           }            
       case .failure(let error):
           // failure
       }
   }

8. Screen share (view only):

   webex.phone.dial("[email protected]", option: MediaOption.audioVideoScreenShare(video: (local: ..., remote: ...))) { ret in
       switch ret {
       case .success(let call):
           call.onConnected = {
               // ...
           }
           call.onDisconnected = { reason in
               // ...
           }
           call.onMediaChanged = { changed in
               switch changed {
                   ...
               case .remoteSendingScreenShare(let sending):
                   call.screenShareRenderView = sending ? view : nil
               }
           }
       case .failure(let error):
           // failure
       }
   }

9. Post a message:

   webex.messages.post(personEmail: email, text: "Hello there") { response in
       switch response.result {
       case .success(let message):
           // ...
       case .failure(let error):
           // ...
       }
   }
   

10. Receive a message:

    webex.messages.onEvent = { messageEvent in
        switch messageEvent{
        case .messageReceived(let message):
            // ...
            break
        case .messageDeleted(let messageId):
            // ...
            break
        }
    }
    

11. Screen share (sending):

    11.1 In your containing app:

    webex.phone.dial("[email protected]", option: MediaOption.audioVideoScreenShare(video: ..., screenShare: ..., applicationGroupIdentifier: "group.your.application.group.identifier"))) { ret in
        switch ret {
        case .success(let call):
            call.oniOSBroadcastingChanged = {
                event in
                if #available(iOS 11.2, *) {
                    switch event {
                    case .extensionConnected :
                        call.startSharing() {
                            error in
                            // ...
                        }
                        break
                    case .extensionDisconnected:
                        call.stopSharing() {
                            error in
                            // ...
                        }
                        break
                    }
                }
            }
            }
        case .failure(let error):
            // failure
        }
    }

    11.2 In your broadcast upload extension sample handler:

    override func broadcastStarted(withSetupInfo setupInfo: [String : NSObject]?) {
        // User has requested to start the broadcast. Setup info from the UI extension can be supplied but optional.
        WebexBroadcastExtension.sharedInstance.start(applicationGroupIdentifier: "group.your.application.group.identifier") {
            error in
            if let webexError = error {
               // ...
            } else {
                WebexBroadcastExtension.sharedInstance.onError = {
                    error in
                    // ...
                }
                WebexBroadcastExtension.sharedInstance.onStateChange = {
                    state in
                    // state change
                }
            }
        }
    }
    
    override func broadcastFinished() {
        // User has requested to finish the broadcast.
        WebexBroadcastExtension.sharedInstance.finish()
    }
    
    override func processSampleBuffer(_ sampleBuffer: CMSampleBuffer, with sampleBufferType: RPSampleBufferType) {
        switch sampleBufferType {
            case RPSampleBufferType.video:
                // Handle video sample buffer
                WebexBroadcastExtension.sharedInstance.handleVideoSampleBuffer(sampleBuffer: sampleBuffer)
                break
            case RPSampleBufferType.audioApp:
                // Handle audio sample buffer for app audio
                break
            case RPSampleBufferType.audioMic:
                // Handle audio sample buffer for mic audio
                break
        }
    }

    11.3 Get more technical details about the Containing App & Broadcast upload extension and Set up an App Group

Migrating from Cisco Spark IOS SDK

The purpose of this guide is to help you to migrate from Cisco Spark IOS SDK to Cisco Webex IOS SDK.

Install

Assuming you already have an IOS project with Spark IOS SDK integrated. For your IOS app, here are the steps to migrate to use Webex IOS SDK:

1. Update the sdk import info for your app:

   import SparkSDK => import WebexSDK

Usage

Here are API changes list from Spark IOS SDK to Webex IOS SDK.

Description	Spark IOS SDK	Webex IOS SDK
Create a new instance	let spark = Spark(authenticator: authenticator)	let webex = Webex(authenticator: authenticator)

License

© 2016-2018 Cisco Systems, Inc. and/or its affiliates. All Rights Reserved.

See LICENSE for details.