Skip to main content
Skip table of contents

Insight Agent for Android Release Notes

The current version of the Insight Agent for Android is 1.3.3.

Release

Purpose

New features

Fixes

Known issues

1.3.3

Release date:

This is a maintenance release.

There are no new features in this release.

Invalid timeToVideoStart reported

There are no known issues in this release.

1.3.2

Release date:

This is a maintenance release.

There are no new features in this release.

Warnings while app upload to Google Play store

There are no known issues in this release.

1.3.1

Release date: 05 Dec 2023

This release adds defensive code to prevent a null-pointer exception and log an error instead.

There are no new features in this release.

nullPointerException in InsightAgent

There are no known issues in this release.

1.3.0

Release date: 06 Oct 2023

This is a feature release.

The Agent is now released as a standard Java library (JAR). It is also still available as an Android library (AAR).

Updated toolchain: The Agent and reference app are built using Android API level 33 (Android 13), using Gradle 8.1.1 and Android Gradle Plugin 8.0.2, which requires JDK 17.

There are no fixes in this release.

There are no known issues in this release.

You need to be logged into the NAGRA Insight Help Centre to download the following files.

Release

New features

Fixes

Changes

Download

1.3.0

Release date: 06 Oct 2023

The Agent is now released as a standard Java library (JAR). It is also still available as an Android library (AAR).

Updated toolchain: The Agent and reference app are built using Android API level 33 (Android 13), using Gradle 8.1.1 and Android Gradle Plugin 8.0.2, which requires JDK 17.

There are no fixes in this release.

There are no other changes in this release.

insight-agent-debug.aar
insight-agent-release.aar
insight-agent-debug.jar
insight-agent-release.jar
javadoc.zip
sample-app-src.zip

1.2.2

Release date: 21 Apr 2022

There are no new features in this release.

The timeToVideoStart event was being generated multiple times during the same session (an issue that was introduced in the previous version).

Network events that start before the start of the playback but end after should be taken into account in the timeToVideoStart breakdown.

ni-agent-java-1.2.2.zip

1.2.1

Release date: 30 Mar 2022

There were no new features in this release.

Minor fixes (Javadoc, typo)

playerName and playerVersion attributes have been moved from the root of the playback metric JSON data structure to the PlayerContext structure.

ni-agent-java-1.2.1.zip

1.2.0

Release date: 22 Mar 2022

Ability to set the current frame rate (fps). Also, the expected fps for the stream being played can be set in the content information with the new framePerSecondsNominal argument.

Ability to report network events with a new addNetworkEvent method (currently only used for the timeToVideoStart event breakdown feature)

timeToVideoStart event breakdown (licence acquisition time details, manifests acquisition time details and segments acquisition time details)

Resolution and codecs information can be passed in a new setBitrate method

Added new error event with error type (critical, recoverable); the error code is now a string

Added playerName, playerVersion and the screen refreshRate in playback metrics

Content duration was not rounded correctly.

Truncate the description of the named event if too long.

The version of the agent can now be retrieved directly from the InsightAgent class.

ni-agent-java-1.2.0.zip

1.1.10

26 Jan 2022

There were no new features in this release.

There were no fixes in this release.

The maximum length of error messages and player event properties must not exceed a given length (currently 512 characters)

Log a warning message if setPosition is called after the stop operation has been called

ni-agent-java-1.1.10.zip

1.1.9

12 Nov 2021

Added “agentVersion” property in the metrics

Added “samplingInterval” and “samplingIntervalMeasured” in the metrics

Make sure no ClassCastException is thrown

NullPointerException in stopReporting method

There were no other changes in this release.

ni-agent-java-1.1.9.zip

1.1.7

25 Oct 2021

There were no new features in this release.

There were no fixes in this release.

Added an integrationMode when the content information is updated with wrong values, an exception is thrown to detect them at integration time. The integrationMode must be disabled for production builds. In that case, no exception will be thrown, just an error message will be logged.

ni-agent-java-1.1.7.zip

1.1.6

04 Oct 2021

Add channelIdSource attribute to LIVE content

There were no fixes in this release.

When calling the setContentInformation the agent is not starting a new viewing session (the current viewing session will be used).

Ensure the agent sends 0 bitrate downgrades when none are observed, but the bitrate is known. If the bitrate is not known, then the attribute is not added to the payload.

Do not generate a selectedBitrateChanged event if the bitrate is the same value as the previous one.

ni-agent-java-1.1.6.zip

1.1.5

19 Aug 2021

Add agent proguard rule.

startReporting must be invoked in the main thread

There were no other changes in this release.

ni-agent-java-1.1.5.zip

1.1.4

06 Jul 2021

There were no new features in this release.

viewingSeconds and bufferingSeconds are now rounded to the closest integer value

There were no other changes in this release.

ni-agent-java-1.1.4.zip

1.1.3

28 May 2021

Added node and corp attributes to user information

There were no fixes in this release.

There were no other changes in this release.

ni-agent-java-1.1.3.zip

1.1.2

10 May 2021

There were no new features in this release.

Concurrent access issues

There were no other changes in this release.

ni-agent-java-1.1.2.zip

1.1.1

24 Mar 2021

There were no new features in this release.

There were no fixes in this release.

For the content quality feature, the automatic detection of video quality must be disabled by default.

ni-agent-java-1.1.1.zip

1.1.0

19 Mar 2021

Add content quality feature.

There were no fixes in this release.

There were no other changes in this release.

ni-agent-java-1.1.0.zip

1.0.7

15 Mar 2021

There were no new features in this release.

DVR content should be considered as a LiveContent.

There were no other changes in this release.

ni-agent-java-1.0.7.zip

1.0.6

09 Mar 2021

There were no new features in this release.

Missing data for DVR content.

Adapt minSdkVersion to match OTV SDK.

There were no other changes in this release.

ni-agent-java-1.0.6.zip

1.0.5

19 Feb 2021

There were no new features in this release.

Removed unused permission from manifest.

There were no other changes in this release.

ni-agent-java-1.0.5.zip

1.0.4

09 Feb 2021

Export of network connection type.

There were no fixes in this release.

There were no other changes in this release.

ni-agent-java-1.0.4.zip

1.0.3

16 Nov 2020

There were no new features in this release.

Support of CU, SO and DVR content types.

Improved build mechanism and CI

Add PVR and CDVR content types

ni-agent-java-1.0.3.zip

1.0.2

30 Oct 2020

Ability to specify a custom device id

CI for the NMP agent wrapper

ref app to use with NMP agent wrapper

Implementation of the NMP agent wrapper

Application architecture

Added reference app

completionPercent wrong when duration = 0

Wrong user address structure

Add missing playbackTimezone information

Reporter must be released when play ends

Units for reportingInterval and samplingInterval are now in seconds

ni-agent-java-1.0.2.zip

1.0.1

27 Jul 2020

There were no new features in this release.

contentCompletion not sent to the collector

contentCompletionMinutes not sent

There were no other changes in this release.

ni-agent-java-1.0.1.zip

1.0.0

07 Jul 2020

There were no fixes in this release.

There were no other changes in this release.

ni-agent-java-1.0.0.zip

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.