Installation guide


Android support

Code nameVersionAPI Level
Jelly Bean4.1+API Level 16

Importing dependencies into your project

Mobile SDK is built using following frameworks: Retrofit, OkHttp, RxJava/RxAndroid, Gson, and Jetty Server. In order to use CMMobileSDK you should import mentioned frameworks as well:

dependencies {
    // Retrofit
    implementation 'com.squareup.retrofit2:retrofit:2.5.0'
    implementation 'com.squareup.retrofit2:adapter-rxjava2:2.2.0'
    implementation 'com.squareup.retrofit2:converter-gson:2.2.0'
    implementation 'com.squareup.retrofit2:converter-scalars:2.5.0'
    implementation 'com.squareup.retrofit2:converter-simplexml:2.5.0'
    // OkHttp
    implementation 'com.squareup.okhttp3:okhttp:3.4.1'
    implementation 'com.squareup.okhttp3:logging-interceptor:3.4.1'
    // Rx
    implementation 'io.reactivex.rxjava2:rxandroid:2.2.0'
    implementation 'io.reactivex.rxjava2:rxjava:2.1.0'
    // Gson
    implementation ''
    // Jetty Server
    implementation 'org.eclipse.jetty:jetty-server:8.1.17.v20150415'
    implementation 'org.eclipse.jetty:jetty-servlet:8.1.17.v20150415'
    implementation 'org.eclipse.jetty:jetty-client:8.1.17.v20150415'

Importing CMMobileSDK into your project

  • Add CMMobileSDK.aar file to your project (libs directory).
  • Add next lines at the build.gradle file where you plan to use it:
repositories {
    flatDir {
        dirs 'libs'
dependencies {
    implementation(name:'CMMobileSDK', ext:'aar')

Usage examples


The demo app includes implementation of multiview and fullscreen mode as well. Please note that there are a lot of ways to implement this feature. Take you project architecture into consideration while using sample code.

// set access token provider so mobile SDK will be able to retrieve access token when needed.
AccessTokenProvider accessTokenProvider = new AccessTokenProviderImpl();
/* sniffing cameras */
CameraSniffer cameraSniffer = new CameraSniffer(getContext(), new CameraSnifferListenerImpl());
/* adding camera */
CameraWizard cameraWizard = new CameraWizard(new CameraWizardListenerImpl());
cameraWizard.addDevice(someDeviceReturnedBySniffer, "My awesome camera", 1234);
/* streaming live video */
// init live streamer item
long cameraId = 1234;
StreamerItem streamerItem = StreamerItem.createItem(cameraId);
// init recording streamer item
long cameraId = 1234;
long recordingId = 5678;
StreamerItem streamerItem = StreamerItem.createItem(cameraId, recordingId);
// init streamer
CameraStreamer cameraStreamer = new CameraStreamer(getContext(), surface);
cameraStreamer.setCameraStreamerListener(new CameraStreamerListenerImpl());
// set streamer item
// the streamer will start playing after the streamer item is ready;
// seek to middle of recording
cameraStreamer.seekTo(streamer.getDuration() / 2 );