The Webex Android SDK is distributed via maven. To integrate the SDK into your app, you need to add the following dependency to your app's build.gradle file:

1. Add the following repository to your top-level build.gradle file:

   allprojects {
       repositories {
           maven {
               url 'https://devhub.cisco.com/artifactory/webexsdk/'
           }
       }
   }
   

2. The Android meetings SDK comes in two variants. If your use case involves only meeting flows, consider using the size-optimized Meeting SDK. If you need features beyond meetings, you will need to use the full SDK.

   Add the required webexsdk library as a dependency for your app in the build.gradle file:

   • For the full SDK:

     dependencies {
         implementation 'com.ciscowebex:webexsdk:3.16.2'
     }
     

   • For the meetings only SDK:

     dependencies {
         implementation 'com.ciscowebex:webexsdk-meeting:3.16.2'
     }
     

anchorAndroid SDK v3.16+ Permission Behavior Changes

From Android SDK v3.16 onwards, runtime permission handling is app-owned:

• The SDK does not include dangerous permissions in the library manifest.
• The SDK does not show permission dialogs.
• Your app must declare required permissions and request them at runtime before SDK operations.
• If permissions are missing, SDK APIs return WebexError.ErrorCode.PERMISSION_REQUIRED and include missing permissions in error.data.

The SDK also includes support for 16 KB memory page size on Android; no app code change is required for that part.

Common meetings permissions

<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.CAMERA" />

Runtime permission check example

val needed = arrayOf(Manifest.permission.RECORD_AUDIO, Manifest.permission.CAMERA)
// request missing permissions before dial/answer
webex.phone.dial(address, MediaOption.audioVideo(/* views */)) { result ->
    // Handle result. If permission is missing, SDK returns PERMISSION_REQUIRED.
}

Screen-sharing consent flow

For screen sharing, obtain MediaProjection user consent and pass the consent data into startSharing(...):

val mgr = ctx.getSystemService(Context.MEDIA_PROJECTION_SERVICE) as MediaProjectionManager
val consentIntent = mgr.createScreenCaptureIntent()
launcher.launch(consentIntent)
// In activity result callback:
call.startSharing(notification, notifId, data /* consent */, callback, shareConfig)