Theoplayer v6.0.0 with Mediamelon SDK
Prerequisites
MediaMelon SmartSight SDK
smartstreaming_release.aar
Step 1: Set up the build environment
The SDK files are added to the build environment and the required network permissions are enabled.
Copy smartstreaming-release.aar provided with the release package to the theoplayer project, Example
app/libs/smartstreaming-release.aar
Add the following library to
app/build.gradle
:-
dependencies {
.
.
.
//<!-- <MMSmartStreaming 1a> -->
api files ('smartstreaming-release.aar')
//<!-- </MMSmartStreaming 1a> -->
}
Add network permissions to
app/src/main/AndroidManifest.xml
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<!-- <MMSmartStreaming 1b> -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- </MMSmartStreaming 1b> -->
Step 2: Register SDK
The player application must register the SDK and provide player information once when the application launches. Please note that values provided in this integration step persist across video sessions. This is typically done when the player itself is initialized.
Step 2a: Import packages
app/src/main/java/com/theoplayer/theoplayerexample/MainActivity.java
// <MMSmartStreaming 2a>
import com.mediamelon.smartstreaming.MMQBRMode;
import com.mediamelon.smartstreaming.MMSmartStreaming;
import com.mediamelon.smartstreaming.MMSmartStreamingTheo;
import com.mediamelon.smartstreaming.MMSmartStreamingInitializationStatus;
import com.mediamelon.smartstreaming.MMSmartStreamingObserver;
import java.util.ArrayList;
import android.util.Log;
// </MMSmartStreaming 2a>
Step 2b: Registration
Perform registration tasks by modifying the onCreate()
method in app/src/main/java/com/theoplayer/theoplayerexample/MainActivity.java
public void onCreate(Bundle savedInstanceState) {
...
@Override
public void onClick(View v) {
if (theoPlayerView.getPlayer().isPaused()) {
theoPlayerView.getPlayer().play();
} else {
theoPlayerView.getPlayer().pause();
}
}
});
//<MMSmartStreaming 2b>
MMSmartStreamingTheo.enableLogTrace(<boolean>); //set to "false" before releasing player to production
if (MMSmartStreamingTheo.getRegistrationStatus() == false){ //Check if it is the first time Registration process is done
MMSmartStreamingExo2.setDeviceInfo($DEVICE_MARKETING_NAME);
MMSmartStreamingExo2.registerMMSmartStreaming($PLAYERNAME, $CUSTOMERID, $SUBSCRIBERID, $DOMAINNAME, $SUBSCRIBERTYPE, $SUBSCRIBERTAG,$doHash);
MMSmartStreamingExo2.reportPlayerInfo("CustomPlayerName","Player_Version", "1.0");
MMSmartStreamingExo2.getInstance().setContext(getApplicationContext()); //Please make sure to provide the application's context here, and not the activity's context
MMSmartStreamingExo2.getInstance().reportAppInfo($APP_NAME,$APP_VERSION);
MMSmartStreamingExo2.getInstance().reportVideoQuality($VIDEO_QUALITY);
}
// </MMSmartStreaming 2b>
}
Parameters passed in Registration call
$PLAYERNAME
Player Name as in ExoPlayer, KalturaPlayer etc.
$CUSTOMERID
String containing your MediaMelon-assigned Customer ID.
$SUBSCRIBERID
String containing your subscriber’s ID. If you do not use subscriber IDs, leave it as it is.
$DOMAINNAME
String containing your section of your subscriber or assets. (Optional)
$SUBSCRIBERTYPE
String containing the subscriber type (e.g. “Free”, “Paid”). If you do not use subscriber types, leave it as it is.
$SUBSCRIBERTAG
String containing an additional subscriber-specific information. This is sent in clear (not hashed) to SmartSight and it is advised to not send sensitive information in this field.
Step 3: Initialize Session
The SDK must be initialized at the start of each video session. Initialization includes setting the application context, initializing the playback session, and indicating the intent for playback with the SDK.
// after player is initialised and not null anymore
String mediaUrl = "get the mediaURL from your application"
String assetId = "assetID"; //enter you assetId here
String assetName = "assetNAME"; // enter your assetname here
String videoId = "videoID"; // enter your videoId here
ContentMetadata cm = new ContentMetadata();
String episodeNumber = "EpisodeNumber";
String season = "Season";
String genre = "Genre";
String drmProtection = "drmProtection";
String contentType = "contentType";
String title = "Title";
cm.videoId=videoId;
cm.seriesTitle=title;
cm.season=season;
cm.genre=genre;
cm.episodeNumber=episodeNumber;
cm.drmProtection=drmProtection;
cm.contentType=contentType;
cm.assetName=assetName;
cm.assetId=assetId;
JSONObject contentMetadata = cm.getJSONObject();
//optional content metadata
MMSmartStreamingTheo.getInstance().initializeSession(player, MMQBRMode.QBRModeDisabled, mediaUrl, null, assetId, assetName, videoId,null,contentMetadata,isLive);
Last updated
Was this helpful?