Android

Slike Android SDK v3

The Slike Player v3 is all new SDK with features including podcast playback, multiple media list playback, optimized events handling, faster media playback, media and ad playback, optional UI, PIP etc. The v3 player is optimized for multiple media handling especially for playback in listing.

Structure

The v3 player SDK consists 2 types of players. SlikePlayer2 and SlikePlayer3.

The SlikePlayer3 is a service based player can be played in background. The player is independent of UI lifecycle. The player can be used for podcast or view independent media playback. The can play all types of media excluding YouTube, DailyMotion, Gify and Meme. The player can play ad. The UI is optional.

The SlikePlayer2 is lifecycle dependent player. The player is fragment based player and can play all supported media. The player has inbuilt ad support system.

Compatibility

SDK supports minSdkVersion = 19 and targetSdkVersion = 31

Integration

For reference please clone the demo link as follows.

https://code.slike.in/android/v3demo.git

Current v3core is 6.7.4

Release Date: 18/10/2022

Current slikeversion is 5.5.5

Release Date: 10/11/2022

Step 1:

Add following lines in allProjects -> repositories.

        buildscript {
          ext.kotlin_version = '1.5.31'
          repositories {
              google()
              jcenter()
              maven {
                  url 'http://jenkins.slike.in:8081/artifactory/gradle-release'
                  credentials {
                      username = "${artifactory_user}"
                      password = "${artifactory_password}"
                  }
              }
              maven { url 'https://maven.fabric.io/public' }
          }
          dependencies {
              classpath 'com.android.tools.build:gradle:4.1.3'
              classpath "org.jfrog.buildinfo:build-info-extractor-gradle:4.24.22"
              classpath 'com.google.gms:google-services:4.3.10'
              classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
              // NOTE: Do not place your application dependencies here; they belong
              // in the individual module build.gradle files
          }
      }
      allprojects {
          repositories {
              google()
              jcenter()
              maven {
                  url 'https://vsnl.slike.in/jenkins/artifactory/slikerepo/'
              }
          }
      }
      
      ext {
          minSdkVersion = 19
          targetSdkVersion = 31
          compileSdkVersion = 31
          buildToolsVersion = '30.0.1'
          versionCode = 133
          versionName = '5.5.4'
          appcompatVersion = '1.4.1'
          runtimeVersion = '2.7.1'
          concurrentVersion = '1.1.0'
          volleyVersion = '1.2.1'
          analyticsVersion = '18.0.1'
          ktxVersion = '1.8.0'
          coroutinesVersion = '1.6.0'
          v3core = '6.7.4'
          imaSDK = '3.26.0'
          fanSDK = '5.6.1'
          comscore = '5.+'
          exoVersion = '2.17.1'
          okHttpVersion = '3.12.11'
          minifyEnabled = false
          shrinkResources = false
      }

Step 2:

Add following lines in gradle dependency

implementation "androidx.concurrent:concurrent-futures:$rootProject.concurrentVersion"
        implementation "androidx.work:work-runtime:$rootProject.runtimeVersion"
        implementation "com.android.volley:volley:$rootProject.volleyVersion"
        implementation "androidx.work:work-runtime:$rootProject.runtimeVersion"
        implementation "in.slike.player.v3core:v3core:$v3core"
        implementation "in.slike.player.v3:ui:$slikeversion"
        implementation "in.slike.player.v3:player:$slikeversion"
        implementation "in.slike.player.commoncore:commoncore:$commoncore"
        implementation "androidx.lifecycle:lifecycle-common-java8:2.4.0"
        
        implementation 'com.pierfrancescosoffritti.androidyoutubeplayer:core:10.0.5'
        implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
        implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.5.2"
        implementation "androidx.core:core-ktx:1.7.0"
        implementation "com.squareup.okhttp3:okhttp:$rootProject.okHttpVersion"
        implementation "com.squareup.okhttp3:logging-interceptor:$rootProject.okHttpVersion"
        
        implementation "com.google.android.exoplayer:exoplayer-core:$rootProject.exoVersion"
        implementation "com.google.android.exoplayer:exoplayer-hls:$rootProject.exoVersion"
        implementation "com.google.android.exoplayer:exoplayer-dash:$rootProject.exoVersion"
        implementation "com.google.android.exoplayer:extension-ima:$rootProject.exoVersion"
        implementation "com.google.android.exoplayer:extension-mediasession:$rootProject.exoVersion"
        implementation "com.google.android.gms:play-services-analytics:$rootProject.analyticsVersion"
        compileOnly 'org.checkerframework:checker-qual:3.5.1'
        implementation 'androidx.media:media:1.4.3'
        implementation 'androidx.localbroadcastmanager:localbroadcastmanager:1.1.0'
        implementation 'androidx.palette:palette:1.0.0'
        implementation 'org.jetbrains:annotations:16.0.1'

SDK Setup

Initialize config on time somewhere in either splash or in application onCreate.

ConfigLoader.get().init(apikey, canSendData, BuildConfig.DEBUG, in.slike.player.v3.BuildConfig.VERSION_NAME,(config, e) -> {});

//method signarure
public void init(@NonNull String apiKey, boolean isGDPREnabled, boolean enableDebug, @NonNull String playerVersion, @Nullable IConfigListener listener)

Create the player

Initialize player. Create a MediaConfig object.

If podcast or without UI player (SlikePlayer3) need to be initialise, use following method.

public static void playMedia(@Nullable RenderingObjects renderingObjects, @NonNull MediaConfig[] configs, @NonNull Pair position, @Nullable IMediaStatus mediaStatus);
eg. 
SlikePlayer3.playMedia(null, configs, new Pair<>(position, 0L), AudioMiniPlayer.this);

If normal player (SlikePlayer2) is initialized.

public void playMedia(final MediaConfig config, RenderingObjects renderingObjects, Pair position, IMediaStatus mediaStatus);

eg.
SlikePlayer2.get().playMedia(mediaConfig, renderingObjects, new Pair<>(0, 0L), this);

Initialize rendering object by providing framelayout/ slike PlayerView's layout container

RenderingObjects renderingObjects = new RenderingObjects(R.id.container, playerView.getLayoutContainer());

Player Control

In v3 player, playercontrol is not part of the SDK in this release. We are separately providing source code of control to modify the UI as per need.

The SDK can play many type of videos and has many third-party players like YouTube, DailyMotion, Facebook etc. All other players gives their own controls.

So, first check in K.MEDIAPLAYERDECIDED status to detect player type. Rest of the snippet as follows.

@Override
public void onStatus(@K.PlayerState int state, Status status){
  if (state == K.MEDIA_PLAYER_DECIDED){
        isTP = SlikePlayer2.get().getPlayerType() != K.PLAYER_EXO;
    ...
    }
    ...
    if(!isTP){
        control.onStatus(status);
    }
}

@Override
public void onAdStatus(AdsStatus status) {
    if (status == null) return;
  ...
  if (!isTP) {
    control.onAdStatus(status);
  }
}

@Override
public void onError(SAException err) {
    errorView.setText(err.getMessage());
  errorView.setVisibility(View.VISIBLE);
  control.onError(err);
  ...
}

Note: Refer to PlayerView in UI module regarding control implementation.

Features

Encrypted video playback
DVR playback. Live and DVR switching
Manifestless HLS playback.
VOD, podcast and live-stream playback
Live event
Cue point
Thumbnail preview on seek-bar
Supported media format: HLS, MP4, MP3, Memes & GIF
Low latency live event playback
Secure streaming
Gesture control for volume, brightness and media seek
Resume playback
Multiple player instances on a page
Geo-blocking
Central GA support
YouTube, DailyMotion & FB video support
Video playback with ExoPlayer
In-house rich media analytics
Video quality bucket selection
Playback speed control
Playlist feature to play multiple media files
Completely customizable UI
Custom autoplay feature
Advance media event callback
Multiple Language Support
Simulive Feature
Mute/UnMute Feature
Chapter Implementation

Monetization features

IMA support
Pre and post-roll ad
Mid-roll

Advance integration

Sample dependencies

dependencies {
    implementation fileTree(dir: "libs", include: ["*.jar"])
    implementation 'com.google.firebase:firebase-analytics:20.0.2'
    implementation "com.google.ads.interactivemedia.v3:interactivemedia:$rootProject.imaSDK"
    implementation 'com.google.android.gms:play-services-ads:20.5.0'
    implementation "androidx.appcompat:appcompat:$rootProject.appcompatVersion"
    implementation 'androidx.constraintlayout:constraintlayout:2.1.1'
    implementation "androidx.concurrent:concurrent-futures:$rootProject.concurrentVersion"
    implementation "androidx.work:work-runtime:$rootProject.runtimeVersion"
    implementation "com.android.volley:volley:$rootProject.volleyVersion"
    implementation "androidx.work:work-runtime:$rootProject.runtimeVersion"

    implementation "in.slike.player.v3core:v3core:$v3core"
    implementation "in.slike.player.v3:player:$slikeversion"
    implementation 'com.android.support:multidex:1.0.3'

    implementation "androidx.lifecycle:lifecycle-common-java8:2.4.0"
    implementation 'androidx.recyclerview:recyclerview:1.2.1'
    implementation 'androidx.cardview:cardview:1.0.0'
    implementation 'com.google.android.material:material:1.5.0-alpha02'
    implementation "androidx.viewpager2:viewpager2:1.0.0"

    implementation "com.google.android.exoplayer:exoplayer-core:$rootProject.exoVersion"
    implementation "com.google.android.exoplayer:exoplayer-hls:$rootProject.exoVersion"
    implementation "com.google.android.exoplayer:exoplayer-dash:$rootProject.exoVersion"
    implementation "com.google.android.exoplayer:extension-ima:$rootProject.exoVersion"
    implementation "com.google.android.exoplayer:extension-mediasession:$rootProject.exoVersion"
    implementation "com.google.android.gms:play-services-analytics:$rootProject.analyticsVersion"
    compileOnly 'org.checkerframework:checker-qual:3.5.0'
    implementation 'androidx.media:media:1.5.0'
    implementation 'androidx.localbroadcastmanager:localbroadcastmanager:1.1.0'
    implementation 'androidx.palette:palette:1.0.0'
    implementation 'org.jetbrains:annotations:16.0.1'

    implementation project(path: ':ui')
    implementation 'com.pierfrancescosoffritti.androidyoutubeplayer:core:10.0.5'
    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.5.2"
    implementation "androidx.core:core-ktx:1.7.0"
    implementation "com.squareup.okhttp3:okhttp:$rootProject.okHttpVersion"
    implementation "com.squareup.okhttp3:logging-interceptor:$rootProject.okHttpVersion"
}

Configuration lists

MediaConfig

Property or method name	Type	Default value	Description
MediaConfig(@NonNull String slikeID)			Constructor
MediaConfig( @NonNull String slikeID, @K.VideoSourceType int sourceType)			Constructor
setSlikeID(@NonNull String slikeID)			Method
setTPID(String TPID, @K.VideoSourceType int sourceType)			Method. The TPID could be a valid URL or related media id.
setTitle(String title)			Method
setSeotitle(String seotitle)			Method. The SEO title is English only text pass for ad monetisation. This is mandatory if language is other than english
setDesc(String desc)			Method
setPoster(Object poster)			The poster can be String or Bitmap
The poster can be String or Bitmap			The thumb can be String or Bitmap

PlayerConfig

Property or method name	Type	Default value	Description
setAutoPlay(boolean autoPlay)	boolean	true	Auto play media
autoPlayList	boolean	true	Auto play media playlist
autoRepeat	boolean	false	Auto repeat media
autoRepeatList	boolean	false	Auto repeat media playlist
shuffleMode	boolean	false	Shuffle the playlist
retainCurrentMedia	boolean	true	Continue playing current media if exists in the new playlist
setPlayerVolume(int playerVolume)	boolean	Current system volume	Player volume. 0 >= vol <= 100

Ad Controlling properties (Google IMA)

BOOL skipAds;

set "false" to play ads (if exist in API key), default value is true
ConfigLoader.get().getPolicyEnforceConfig().skipAds(bool);

isPrerollEnabled;

Enable | Disable the Pre-roll ad (optional).

isPostrollEnabled;

Enable | Disable the Post-roll ads (optional).

BOOL setInitialMuteAd;

set true to play ima ad in muted state initially
ConfigLoader.get().getPlayerConfig().setInitialMuteAd(bool);

Analytics other config properties

section
- e.g, ConfigLoader.get().getUserConfig().setSection("parent.app.section");
Page Template
- e.g, ConfigLoader.get().getPageConfig().setPageTemplate("news");
MSID
- e.g, ConfigLoader.get().getUserConfig().setMsid("msid");
SSOID
- SSO login id
- e.g, ConfigLoader.get().getUserConfig().setSsoid("ssoid");

Constants

All constants are defined in the class K (in.slike.player.v3core.K).

BitrateModes

Bitrate control constants.

Name	Description
AUTO_BITRATE	Auto bitrate adjustment
LOW_BITRATE	Low bitrates bucket only
MEDIUM_BITRATE	Medium bitrates bucket only
HIGH_BITRATE	High bitrates bucket only

SpeedModes

Playback speed control constants.

Name	Description
SLOWSPEED	Playback speed 0.5X
NORMALSPEED	Normal playback speed
SPEED	Playback speed 1.5X
HIGHSPEED	Playback speed 2.0X
VERYHIGHSPEED	Playback speed 2.5X
ULTRAHIGHSPEED	Playback speed 3.0X

ErrorHandlingModes

Defines how errors can be handled.

Name	Description
SAFE_ONLY	The player handles all safe errors itself
SAFE_NETWORK	Handles safe errors including network related errors
ALL_ERRORS	Handle all errors itself and no error will be thrown out

License

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.