OpenTV Analytics for Android Home

Downloading the SDK Package

The SDK can be downloaded directly via FTP. Please contact your NAGRA representative to obtain access.

Once access is granted, use this procedure to download the release artefacts:

Using your preferred Secure FTP client, log in to ftp.nagra.com.
Change the directory to the root delivery folder /home/svc-opy_ci/delivery/ and drill down to the release folder:
com/nagra/connectservices/sdk/android/otvaa-sdk-android/1.2.1
Download the required files.

Your NAGRA FTP account will expire after twelve months, so you will need to refresh your account annually. Accounts are purged from the system 30 days after expiration; after that, they will have to be recreated.

What’s in the SDK Package

All the files in the OtvAa SDK package are prefixed with otvaa-sdk-android-<version>-.

The SDK Package includes the following files (with the prefix):

debug.aar - the SDK library, debug version (extra logs by default).
Can be downloaded directly from debug.aar.
release.aar - the SDK library, release version.
Can be downloaded directly from release.aar.
javadoc.jar - the SDK's API documentation.
Can be downloaded directly from javadoc.jar.
agent-app-src.zip - source code (Android project) for a sample app working with OtvAnalyticsAgent (working with non-specific player)
Can be downloaded directly from agent-app-src.zip.
wrapper-app-src.zip - source code (Android project) for a sample app working with OtvAnalyticsAgentWrapperand Nagra's CONNECT player
Can be downloaded directly from wrapper-app-src.zip.
bmwrapper-app-src.zip - source code (Android project) for a sample app working with OtvAnalyticsAgentWrapper and Bitmovin player

Dependencies

If using one of the sample apps' source provided with the SDK package, place one of the SDK libraries (debug or release) in the source code’s ./lib directory.

Connect Player

When working with the OpenTV Connect Player and OtvAnalyticsAgentWrapper, your application needs to include additional libraries if you use the wrapper-app-src.zip source code. Those additional libraries need to be placed in the ./lib folder). For compatibility, please see the release notes page regarding the correct library versions to work with this version of OtvAa.

The OpenTV Connect Player SDK - this .aar library is provided to you by your Nagra representative as part of the OpenTV Connect Player for Android package. Please see the OpenTV CONNECT Player SDK 5 for Android Documentation.

If you use Nagra’s Insight Analytics, then you’d also need:

The Nagra Insight Agent library. This may have been provided to you by your Nagra representative, or you can download it from the Insight Agent for Android pages. Please pay attention to the correct version.

Bitmovin Player

When working with Bitmovin Player and OtvAnalyticsAgentWrapper, your application need to add Bitmovin player dependency in dependencies section of build.gradle if you bmwrapper-app-src.zip.

GROOVY

dependencies {
  ......
  implementation "com.bitmovin.player:player:3.81.0"
  ......
}

if you use Nagra’s Insight Analytics, then you’d also need to place Insight Agent library in the ./lib folder.