Android - Java - Kotlin

Overview

ollow this step by step tutorial to implement the video playback Synchronization SDK.

While the client-side SDK will take care of most of the functionality, in order to make this sample application work, you will need to use the API_KEY provided to you.

Full code samples can be found here

• Java sample application

• Kotlin sample application

Requirements

To complete this guide successfully the following prerequisites are required:

• Android Studio

• A Sceenic account

• Access key for sync SDK

Authentication

To instantiate the synch SDK you will need to use the API_KEY in order to create a synchronization group.

Using the API_KEY we will identify you as a customer and allow the client to connect to the synchronization session.

The API_KEY can be acquired - here

Create a project

• Open the Android Studio and select New Project from the File menu

• Select Empty Activity and click next

• Choose Java or Kotlin as your programming language for the project

• Configure your project's location, application, and package names

• Set the minimum SDK version of the application to 21 or higher

Add the sync SDK library to your project

• Create (if it does not exist) in the project a libs directory under the app folder

• Add the file wtsyncsdk_v....aar to the libs folder

• Edit the application's build.gradle file (in the app folder) with SDK

Build.gradle

android {
    // Required
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    
    // Required
    packagingOptions {
        exclude 'META-INF/DEPENDENCIES'
        exclude 'META-INF/LICENSE'
        exclude 'META-INF/LICENSE.txt'
        exclude 'META-INF/license.txt'
        exclude 'META-INF/NOTICE'
        exclude 'META-INF/NOTICE.txt'
        exclude 'META-INF/notice.txt'
        exclude 'META-INF/ASL2.0'
        exclude("META-INF/*.kotlin_module")
    }
}
dependencies {	
    implementation files('libs/wtsyncsdk_v....aar')	
    implementation 'org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.+'
}

Permissions

• Add the following permissions to the AndroidManifest.xml file under the app/src/main folder in the project above the application tag.

<uses-permission android:name = "android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name = "android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name = "android.permission.INTERNET" />

Instantiating the SDK

• SDK builder - Call SyncSdkBuilder to instantiate the SDK.

Java

mSyncSdk = new SyncSdk.SyncSdkBuilder()
      .accessToken(mAccessToken)      // mAccessToken - authorization token
      .groupId(mGroupId)              // mGroupId - User identificator, optional
      .name(mDisplayName)             // mDisplayName - username
      .syncListener(this)             // this - SyncListener object
      .build();

Kotlin

• Start synchronization

Java

if (mSyncSdk != null) {
    mSyncSdk.startSync();
}

Kotlin

• Stop synchronization

Java

if (mSyncSdk != null) {
    mSyncSdk.stopSync();
}

Kotlin

Managing synchronization logic

The synchronization logic is managed using callbacks, using them you will be able to create the interaction you need.

• In the sample application, you can see an example for implementing the necessary callbacks

Java

public class MainActivity extends AppCompatActivity implements SyncListener {
    ...

    @Override
    public void onClientList(@NotNull List<String> list) {
        // remote client joined to the group, update ui using adapter
        // update ui with the list of connected clients in the same group
    }
    
    @Override
    public void onSetPlaybackRate(float rate) {
        // setting playback rate
    }

    @Override
    public void onPlaybackFromPosition(long position) {
       // playback from position
       // player.seekTo(position);
    }

    @Override
    public long onGetPlayerPosition() {
        // getting player position
        // Implement your logic to extract player position in miliseconds,
        // be sure that all clients connected to the same group extracts relevant
        // and from the same content timestamps(position)
        // player.getCurrentPosition();
        return 0L;
    }

    @Override
    public float onGetPlaybackRate() {
        // getting playback rate
        // Implement your logic to extract player rate/speed
        return 0f;
    }

    @Override
    public void onSyncInfo(@NotNull SyncInfo syncInfo) {
        // information about synchronization's accuracy and delta
        // syncInfo.accuracy 0.0% - 100.0%
        // syncInfo.delta starts from 0L and describes how big is delay
        // in miliseconds, can be negative value     
    }

    @Override
    public void onDisconnected() {
        // client has been disconnected from the group. All connections 
        // will be closed. Clear ui and data
    }
}

Kotlin

Running the application

Once coding is finished, you should be able to run the application in the Android Studio emulator.

You can view the complete Watch Together sample application here

• Java sample application

• Kotlin sample application

Support

Need technical support? contact us at [email protected].