Update the build.gradle

  1. In Project view, select app src and open the build.gradle file. In the android block, change the minSdkVersion to 21.

          android {
            compileSdkVersion 30
            defaultConfig {
              applicationId "com.example.myapplication"
              minSdkVersion 21
              targetSdkVersion 30
    GROOVY
  2. Add the following lines to theandroid block:

        compileOptions {
            sourceCompatibility JavaVersion.VERSION_1_8
            targetCompatibility JavaVersion.VERSION_1_8
        }
    GROOVY
  3. Make sure there is a dependency set for the latest gradle plugin in the buildScript block. For example:

    buildscript {
      repositories {
         google()
         jcenter()
       }
      dependencies {
        classpath 'com.android.tools.build:gradle:4.0.2'
      }
    }
    GROOVY
  4. In the dependencies block:
    • Change the implementation fileTree(dir: 'libs', include: ['*.jar']) filetype to ['*.aar'].
    • Add the dependency androidx.appcompat:appcompat:1.2.0.
    • Add the dependency com.google.guava:guava:27.1-android.
        dependencies {
            implementation fileTree(dir: 'libs', include: ['*.aar'])
            implementation 'androidx.appcompat:appcompat:1.2.0'
            implementation ("com.google.guava:guava:27.1-android") {
                  exclude group: 'com.google.code.findbugs', module: 'jsr305'
                  exclude group: 'org.checkerframework', module: 'checker-compat-qual'
                  exclude group: 'com.google.errorprone', module: 'error_prone_annotations'
                  exclude group: 'com.google.j2objc', module: 'j2objc-annotations'
                  exclude group: 'org.codehaus.mojo', module: 'animal-sniffer-annotations'
             }
        }
    GROOVY
  5. On completion, sync the build.gradle.

Edit the MainActivity.java

Add the minimum amount of code to enable playback of a single clear stream (identified by a hard-coded string) as soon as the app starts.

  1. Select appsrcmainjavafilename and open the MainActivity.java file. Add the following imports:

        import nagra.otv.sdk.OTVSDK;
        import nagra.otv.sdk.OTVVideoView;
    JAVA
  2. Below the line public class MainActivity extends AppCompatActivity { add:

        static final String  TAG = "MainActivity";
        private OTVVideoView mOTVVideoView = null;
        private int          mPausePos = 0;
        private String       mVideoURI = "https://d3bqrzf9w11pn3.cloudfront.net/basic_dash_bbb_clear/bbb_public.mpd";
    CODE
  3. Replace the contents of the onCreate method with the following to set a reference to the video view and load the SDK.

        @Override
        protected void onCreate(Bundle savedInstanceState) {
          super.onCreate(savedInstanceState);
          OTVSDK.load(this);
          setContentView(R.layout.activity_main);
          mOTVVideoView = findViewById(R.id.otvVideoView);
        }
    JAVA

    OTVSDK.load(Context context); must be called before accessing any SDK 5 methods as it starts up the libraries. The method needs to be called only once at application start-up or before the first use of the SDK.

  4. Add the following to set the Android onStart method, set the stream and start it.

    @Override
    public void onStart()
    {
      super.onStart();
      mOTVVideoView.setVideoPath(mVideoURI);
      mOTVVideoView.start();
    }
    JAVA
  5. Add the following to set the Android onPause method to save the current position and pause the playback.

        @Override
        public void onPause()
        {
          super.onPause();
          if(mOTVVideoView != null)
          {
            mPausePos = mOTVVideoView.getCurrentPosition();
            mOTVVideoView.pause();
          }
        }
    JAVA
  6. Add the following to set the Android onResume method, to seek to the paused position and start playback.

        @Override
        public void onResume()
        {
          super.onResume();
          if(mOTVVideoView != null && mPausePos > 0)
          {
            mOTVVideoView.seekTo(mPausePos);
            mPausePos = 0;
          }
        }
    JAVA

Add a video view to the layout

  1. Select app > src > main > res > layout and open the activity_main.xml file.
  2. In the Text view window, create a nagra.otv.sdk.OTVVideoView by replacing the contents with:

    <?xml version="1.0" encoding="utf-8"?>
    <android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
          xmlns:app="http://schemas.android.com/apk/res-auto"
          xmlns:tools="http://schemas.android.com/tools"
          android:layout_width="match_parent"
          android:layout_height="match_parent"
          tools:context=".MainActivity">
     
          <nagra.otv.sdk.OTVVideoView
              android:id="@+id/otvVideoView"
              android:layout_width="match_parent"
              android:layout_height="match_parent"
              android:layout_centerInParent="true"
              android:descendantFocusability="afterDescendants" />
     
    </android.support.constraint.ConstraintLayout>
    XML

The OTVVideoView element works as the foremost UI element when part of a layout. Placing any other elements on top of the video view’s area will produce unpredictable effects, and may interfere with the built-in security measures.

Next step: You should now be able to run the app in clear playback mode.