THEOplayer Yospace Connector for Android

The Yospace connector provides a Yospace integration for THEOplayer.

Installation

1. Add the THEOplayer Maven repository to your project-level settings.gradle file:

   dependencyResolutionManagement {
       repositories {
           google()
           mavenCentral()
           maven { url = uri("https://maven.theoplayer.com/releases/") }
       }
   }

2. Add the Yospace Maven repository to that same settings.gradle file. Please refer to the Yospace Ad Management SDK documentation for instructions.
3. Add THEOplayer, the Yospace Ad Management SDK and the Yospace Connector as dependencies in your module-level build.gradle file:

   dependencies {
       implementation "com.theoplayer.theoplayer-sdk-android:core:11.+"
       implementation "com.yospace:admanagement-sdk:3.+"
       implementation "com.theoplayer.android-connector:yospace:11.+"
   }

Usage

First, follow the getting started guide for the THEOplayer Android SDK to set up a THEOplayerView in your app.

Then, create the YospaceConnector:

import com.theoplayer.android.api.THEOplayerView
import com.theoplayer.android.connector.yospace.YospaceConnector

val theoPlayerView = findViewById(R.id.theoplayer)
val yospaceConnector = YospaceConnector(theoPlayerView)

Finally, set the THEOplayer source to a SourceDescription with a YospaceSsaiDescription as its ssai description:

theoplayerView.player.source = SourceDescription.Builder(
   TypedSource.Builder("https://example.com/stream.m3u8")
      .ssai(
         YospaceSsaiDescription(streamType = YospaceStreamType.LIVE)
      )
      .build()
).build()