Demo App for SightCall Classic SDK Integration

Overview

This repository contains a demo Android application designed to showcase and test the functionalities of the SightCall Classic SDK. The app demonstrates how to effectively integrate the Classic SDK into an Android project.

For detailed documentation and guidance on the SDK, refer to the official SightCall Android SDK documentation.

Prerequisites

Before proceeding with the integration, ensure that your project meets the following requirements:

• Minimum SDK Version: minSdkVersion 26

• AndroidManifest Configuration:
  If your project includes android:allowBackup="false" in the <application> element of your AndroidManifest.xml, you may need to add the following attribute to avoid conflicts:

  <application
      tools:replace="android:allowBackup">
  
  

Implementation

Using Gradle Version Catalog (Modern Approach)

1. Add the Maven repository for SightCall SDK:

   maven("https://sightcall-maven.s3.amazonaws.com")
   

2. In your libs.versions.toml file, define the SDK version and dependency configuration:

    [versions]
    sightcallSdk = "7.5.2" # Replace with the latest version
   
    [libraries]
    sightcall-sdk = { group = "com.sightcall.universal", name = "universal-sdk", version.ref = "sightcallSdk" }
   

3. Add the dependency to your app-level build.gradle file:

   implementation(libs.sightcall.sdk)
   

Old Way (Without Version Catalog)

If you're not using the Gradle Version Catalog, follow these steps to add the SDK directly:

1. Add the Maven repository for SightCall SDK:

       allprojects {
        repositories {
            maven {
                url "https://sightcall-maven.s3.amazonaws.com"
            }
        }
     }
   

2. Add the dependency to your app-level build.gradle file:

   dependencies {
          implementation "com.sightcall.universal:universal-sdk:7.7.1" // Replace with the latest version
    }' 
   

AndroidManifest Configuration

Ensure that your AndroidManifest.xml file includes the necessary permissions for the SightCall SDK according the needed feature. The demo app's manifest file is already configured with the required permissions.

the full list of permission

```kotlin
    <!-- universal sdk permissions -->  
    <!--  full screen call style notification -->  
    <uses-permission android:name="android.permission.USE_FULL_SCREEN_INTENT" />  
    <!-- screen share -->  
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PROJECTION" />  
    <!--location permission-->  
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />  
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />  
    <!-- Use overlay -->  
    <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />  
    <!-- universal sdk permissions -->

Theme Configuration

Ensure your application's theme inherits from a MaterialComponents theme, for example, Theme.MaterialComponents.Light.NoActionBar. You can define this in your themes.xml file:

```xml
<resources>
    <style name="Theme.YourAppName" parent="Theme.MaterialComponents.Light.NoActionBar">
        <!-- Other theme attributes -->
    </style>
</resources>

Usage

To start the call : paste the call link in main activity then click Launch Call, the call is started using :

        Universal.start(uri)