-
Notifications
You must be signed in to change notification settings - Fork 24
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #24 from webex/master-v3
Base cleanup for sdk v3 example
- Loading branch information
Showing
155 changed files
with
70 additions
and
9,380 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,79 +1,86 @@ | ||
# Cisco Webex Android SDK Example | ||
|
||
This "Kitchen Sink" demo employs Cisco Webex service through [Webex Android SDK](https://github.com/webex/webex-android-sdk). It provides a developer friendly sample implementation of Webex client SDK and showcases all SDK features. It focuses on how to call and use "Webex-SDK" APIs. Developers could directly cut, paste, and use the code from this sample. It basically implements “Webex-SDK” APIs by sequence. | ||
This *Kitchen Sink* demo employs Cisco Webex service through [Webex Android SDK](https://github.com/webex/webex-android-sdk). It provides a developer friendly sample implementation of Webex client SDK and showcases all SDK features. It focuses on how to call and use *Webex-SDK* APIs. Developers could directly cut, paste, and use the code from this sample. It basically implements *Webex-SDK* APIs by sequence. | ||
|
||
This demo support Android device with **Android 6.0** or later | ||
This demo support Android device with **Android 7.0** or later | ||
|
||
## Table of Contents | ||
|
||
- [Setup](#setup) | ||
- [Install](#install) | ||
- [Integration](#integration) | ||
- [Usage](#usage) | ||
- [Note](#note) | ||
|
||
|
||
## Screenshots | ||
<ul> | ||
<img src="https://github.com/jpjpjp/webex-android-sdk-example/blob/master/docs/Screenshot_Kitchensink_Android_MainPage.jpg" width="22%" height="23%"> | ||
<img src="https://github.com/jpjpjp/webex-android-sdk-example/blob/master/docs/Screenshot_Kitchensink_Android_CallPage.jpg" width="22%" height="23%"> | ||
<img src="https://github.com/jpjpjp/webex-android-sdk-example/blob/master/docs/Screenshot_Kitchensink_Android_MessagePage.jpg" width="22%" height="23%"> | ||
<img src="images/Picture1.jpg" width="22%" height="23%"> | ||
<img src="images/Picture2.png" width="22%" height="20%"> | ||
<img src="images/Picture3.jpg" width="22%" height="23%"> | ||
<img src="images/Picture4.jpg" width="22%" height="23%"> | ||
<img src="images/Picture5.png" width="22%" height="23%"> | ||
<img src="images/Picture6.png" width="22%" height="23%"> | ||
<img src="images/Picture7.png" width="22%" height="23%"> | ||
<img src="images/Picture8.png" width="22%" height="23%"> | ||
</ul> | ||
|
||
1. ScreenShot-1: Main page of Application, listing main functions of this demo. | ||
2. ScreenShot-2: Initiate call page, contains call configuration options. | ||
3. ScreenShot-3: Show messaing APIs with present payloads. | ||
|
||
## Setup | ||
|
||
- Install Java SE Development Kit 7u45 or later (Java 8 is OK) | ||
|
||
http://www.oracle.com/technetwork/java/javase/downloads/index.html | ||
|
||
- Android Studio 2.3 or later | ||
|
||
https://developer.android.com/sdk/installing/studio.html | ||
|
||
- Android Plugin for Gradle 3 or later | ||
|
||
If you upgrade your gradle plugin newer than 3.0.0, make sure to add google repository and remove retrolambda plugin in your build.gradle file: | ||
``` | ||
allprojects { | ||
repositories { | ||
jcenter() | ||
google() | ||
... | ||
} | ||
} | ||
``` | ||
|
||
- Select tools->Android->SDK Manager in Android Studio, and install the following packages: | ||
* Android SDK Tools | ||
* Android SDK Platform-Tools | ||
* Android SDK Build-Tools (latest) | ||
* Android 7.1.1 (latest) | ||
* Support Repository: Android Support Repository | ||
* Support Repository: ConstraintLayout for Android | ||
* Support Repository: Google Repository | ||
|
||
|
||
## Install | ||
|
||
1. Clone or download project to your computer. | ||
``` | ||
git clone https://github.com/webex/webex-android-sdk-example | ||
``` | ||
2. Import project | ||
In Android Studio,open "File" -> "Open", select project. | ||
3. Connect your device with debug enabled | ||
4. Build & Run | ||
2. ScreenShot-2: Initiate call page. | ||
3. ScreenShot-3: Show call controls when call is connected. | ||
4. ScreenShot-4: Video calling screen | ||
5. ScreenShot-5: Teams listing screen | ||
6. ScreenShot-6: Space related option screen | ||
7. ScreenShot-7: Space listing screen | ||
8. ScreenShot-8: Send Message screen | ||
|
||
## Integration | ||
|
||
### Option 1 | ||
1. Put AAR file in libs folder of your Android project | ||
2. Open the project level Gradle file and add the following lines under the repositories tag, which is nested under allprojects. | ||
|
||
``` | ||
allprojects { | ||
repositories { | ||
jcenter() | ||
google() | ||
flatDir { dirs 'aars'} //add this line | ||
} | ||
} | ||
``` | ||
3. Add the following dependency in module level Gradle file and press sync-now | ||
``` | ||
implementation files('libs/WebexSDK.aar') | ||
``` | ||
### Option 2 | ||
1. Add the following repository to your top-level `build.gradle` file: | ||
``` | ||
allprojects { | ||
repositories { | ||
jcenter() | ||
maven { | ||
url 'https://devhub.cisco.com/artifactory/webexsdk/' | ||
} | ||
} | ||
} | ||
``` | ||
2. Add the `webex-android-sdk` library as a dependency for your app in the `build.gradle` file: | ||
``` | ||
dependencies { | ||
implementation 'com.ciscowebex:androidsdk:3.0.0@aar' | ||
} | ||
``` | ||
## Usage | ||
### Authorize | ||
**Webex ID** | ||
If you have a Webex ID (your email address), you can choose "**Webex ID**" to authorize your device. | ||
**Guest ID** | ||
If you have a Guest ID (a string token), choose "**Guest ID**" in the first page, then you need to enter your App JWT token and login. | ||
For example see [README.md](https://github.com/webex/webex-android-sdk/README.md) | ||
## Note | ||
Please update below constants in gradle.properties | ||
``` | ||
CLIENT_ID="" | ||
CLIENT_SECRET="" | ||
REDIRECT_URI="" | ||
``` |
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
26 changes: 0 additions & 26 deletions
26
app/src/androidTest/java/com/ciscowebex/androidsdk/kitchensink/ExampleInstrumentedTest.java
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
Oops, something went wrong.