
Agama has a long history when it comes to device integrations. For more than a decade we've dealt with projects of all sizes/lengths. With every completed milestone, and even more with every obstacle, we've been steadily building up the knowledge required to succeed.
What are the plugins?One of the key parts of understanding the satisfaction of your users is to assess the quality of experience for the services they consume, their engagement, the type of content they like to watch etc. Agama has an excellent track record in providing such insights, in fact, this is the core of what we do.
The implementations of these important KPIs historically included, among others, the following steps: agreement on the desired metrics set, investigation of the available metrics in the target platform, and integration of these metrics towards the Agama core agent. A lot of these steps were unique for every integration. This was partially due to different wishes from different customers, but mostly due to the unique characteristics of each of the target platforms.
With the growing popularity of OTT platforms and the rise of players such as ExoPlayer, Shaka Player or AV Player, the target platforms became increasingly similar between integrations. The shift from everything is custom to common platforms and players enabled Agama to step outside its domain. We started actively investigating players and platforms, gathering knowledge about them, assessing what could be possible and feasible, and defining an absolute base of metrics that would benefit every customer. These are all implemented in what we call 'Player plugins .
The player plugins follow a few basic principles:
Agama develops and maintains the plugins
The plugins provide a good set of metrics, making them usable directly
No Agama domain knowledge is required for plugin integration - just a few, stable APIs are necessary
Ability to pass custom metrics to the plugin
Agama develops and maintains player plugins for most of the popular players, such as ExoPlayer, Shaka Player, AVPlayer, and for platforms such as Android, FireOS, iOS, tvOS, Chromecast, Browsers, WebOS, Tizen etc.
While the complete list of metrics differs slightly between plugins, they all share most of the metrics. Some of the features they have in common are:
QoS and QoE metrics
Device properties
Ability to understand asset consumption
Ability to understand playback errors (for instance, DRM errors)
Integration keep it simpleLet's take a closer look at what it takes to integrate Agama into your application. To make it as realistic as possible, let's use ExoPlayer as the target player and Android as the target platform.
ExoPlayer is currently one of the most popular players for Android. It is extremely customizable and flexible, yet easy to start with. Therefore, it comes as no surprise that it is used by everyone, from hobby enthusiasts to video operators and even YouTube.
RequirementsLet's start by describing what requirements and dependencies are needed to use the plugin in the first place. Players evolve quickly and so do their capabilities and APIs, and this truly applies to the ExoPlayer. Therefore, the plugin comes in multiple variants associated with various ExoPlayer minor versions. By using a relatively modern version, plugin-player compatibility should not be a problem.
Some metrics implemented by the plugin can be subject to platform permissions. These are not critical to have in any sense, but more on the good-to-have side and will only be included if permissions are granted. Also related to privacy issues, the plugin can be configured to skip certain sensitive metrics. Such information can be, for example, the collection of the device's longitude and latitude position.
Lastly, the plugin is to be included in the project as any other 3rd party library. And the empclient must be included in the same way as well.
Initialization and configuration stepsInitialize the plugin as early as possible. The plugin's lifetime shall reflect the application's lifetime. To initialize it, one needs an Agama configuration string. It is passed on to the Agama core agent - empclient, and includes information such as report heartbeat and the operator id. The configuration string is typically provided by Agama. The application properties such as the applications name and version are needed during initialization.
String agamaConfig =
emp_service=https://cdm1.company123.se/report;report_interval=60;id_report_interval=240;operator_id=fooSoo; ;
String appName = Company 123 Play App ;
String appVersion= 2.1 ;
// Initialize the plugin
EmpStats.getInstance().init(agamaConfig, Definitions.LogLevel.DEBUG, appName, appVersion, ExoPlayerLibraryInfo.VERSION, getApplicationContext());
Once the plugin instance is created, an account associated with the user should be set as well. This will enable (among other things) to find the customer in the Agama system by its account id.
// Set user account id for user John Doe
EmpStats.getInstance().setUserAccountId( johdo28 );
Monitoring videoNow the plugin is initialized, configured and sending data to the Agama backend. It's time to start monitoring the consumed assets. The user has switched to a new channel, started up an asset from the catchup library or simply opened a new episode of their favorite TV series. Opening any new asset shall be signaled to the plugin.
// Load asset & play
String assetUri= https://demo.agamatech.se/Manifest.m3u8 ;
EmpStats.getInstance().sessionOpen(assetUri, Definitions.AssetType.VOD, Sintel , player);
URI uri = uri.parse(assetUri);
player.setMediaItem(MediaItem.fromUri(uri), false);
player.prepare();
Analog to signaling the intent to start playing content, one needs to signal playback termination as well. There are two common ways of doing this: t
More from Agama
04/12/2024
The new Agama Augmented Intelligence (AAI) capabilities, introduced a few months...
03/07/2024
In today's dynamic video market, service providers have adapted and evolved ...
07/05/2024
Apple's new Privacy Manifest requirement mandates that apps explicitly disclose the privacy-related data they collect, the purposes for this collection, and...
15/04/2024
We are delighted to launch the new 360 Live Mosaic application on the Agama Enterprise platform, our central umbrella system.
This capability allows for the ea...
18/12/2023
Link ping, Sweden, December 18, 2023 - Agama Technologies ( Agama ), a specialis...
14/09/2023
Amsterdam, Netherlands, 14 September 2023 - Agama Technologies ( Agama ), a specialist in video observability and analytics for service quality and customer exp...
12/09/2023
Link ping, Sweden, 12 September 2023 - Agama Technologies ( Agama ), a specialis...
07/09/2023
Link ping, Sweden, September 7, 2023 Agama Technologies ( Agama ), the specialist in video observability and analytics for service quality and customer experi...
02/05/2023
Collecting video performance telemetry from a range of apps and set-top boxes may be challenging, especially when analyzing and comparing the data. To evaluate ...
04/04/2023
Over the past decade, the rapid expansion of digital data has surpassed our ability to analyze and assess it. Operators must deeply understand the home environm...
29/03/2023
Getting an overview of the customer setup has become more challenging, as the ec...
08/02/2023
Ready-made plugins drive value for easy and fast 3rd party integrationsAgama continues to develop its library of pre-built plugins to make it easy for our custo...
25/01/2023
Streaming using adaptive bitrateAdaptive bitrate (ABR) streaming came on the market in a big way during the last 10 years. Its main innovations compared to trad...
25/07/2022
25 July, 2022
Press releases
We are happy to announce that our Agama Elastic Analyzer has been shortlisted for the CSI Awards 2022 in the category Best Monito...
06/07/2022
6 July, 2022
Events
Press releases
Meet us at IBC 2022, at our new stand Hall 1, C65 and experience live the solutions powered by Agama, real-time observabil...
22/06/2022
22 June, 2022
Blog
By Anders Svensson
In our second article Part 2 of this...
25/05/2022
In our previous article (part one of this series), we presented the Agama AWE SDK, the requirements needed to create a simple application to provide real use fo...
25/05/2022
25 May, 2022
Blog
By Anders Svensson
In our previous article Par1 of this series, we presented the Agama AWE SDK, the requirements needed to create a simp...
09/05/2022
9 May, 2022
Press releases
Link ping, Sweden, May 09, 2022, - Agama Technologi...
05/05/2022
This blog article will be the first in a series of three, covering the capabilities of the Agama's AWE SDK and how it can be used to extend the Agama soluti...
05/05/2022
5 May, 2022
Blog
By Anders Svensson
This blog article will be the first in a ...
11/04/2022
11 April, 2022
Events
ANGA COM is Europe's leading congress trade fair for broadband, television and online. This is where network operators, outfitters a...
30/03/2022
Agama has a long history when it comes to device integrations. For more than a decade we've dealt with projects of all sizes/lengths. With every completed m...
10/03/2022
10 March, 2022
Press releases
Link ping, Sweden, March 10, 2022, - Agama Techn...
25/01/2022
We're already a few weeks into 2022 - a new year full of hope, dreams, and hopefully great achievements. But before we look to the future, let's take a ...
08/12/2021
Any operator providing video services is faced with a fundamental operational challenge -with tens of thousands or millions of subscribers using their services ...
29/11/2021
29 November, 2021
Press releases
(Link ping, Sweden, November 29, 2021) - Agam...
22/11/2021
22 November, 2021
Press releases
Link ping, Sweden, November 22, 2021 - Agama Technologies, the leading provider in video service quality and customer experi...
09/11/2021
9 November, 2021
Press releases
(Link ping, Sweden, November 09, 2021) - Agama...
03/11/2021
The importance of metadata in an analytics system cannot be overstated. It gives context to the details of customer behavior and quality measurements, and it ma...
15/09/2021
15 September, 2021
Press releases
(Link ping, Sweden, September 15, 2021) - Agama Technologies, the specialist in video service quality and customer experienc...
16/08/2021
16 August, 2021
Blog
By Aner Gusic
At Agama, we have provided integrated solutions for Customer Care Operations for many years, as integrating high-quality c...
24/06/2021
24 June, 2021
Press releases
June 24, 2021, EDISON, N.J. and LINK PING, Sweden...
09/06/2021
7 June, 2021
Blog
By Alexander Nordstr m
In previous installments of this blog series, we've told you all about how our solutions help make sense of vide...
26/05/2021
26 May, 2021
Events
As the world's most inspiring content and technology event, IBC's mission is to Empower Content Everywhere by driving thought lead...
20/05/2021
20 May, 2021
Blog
By Johan G rsj
The latest innovations in technology have significantly shaped the way we collaborate, connect and interact, and are helpin...
07/05/2021
7 May, 2021
Press releases
(Link ping, Sweden, May 7, 2021) - Agama Technologi...
27/04/2021
27 April, 2021
Press releases
(Link ping, Sweden, April 27, 2021) - Agama Technologies, the specialist in video service quality and customer experience, launc...
07/04/2021
7 April, 2021
Press releases
(Link ping, Sweden, April 7, 2021) - Agama Techno...
30/03/2021
30 March, 2021
Blog
By Alexander Nordstr m
Quality of Experience (QoE) is central to the insights that video operators get from the Agama solution. But what ...
29/03/2021
29 March, 2021
Press releases
Agama Technologies joins SRT Alliance for High Q...
25/03/2021
25 March, 2021
Press releases
Parties extend current partnership with OTT Clie...
29/01/2021
29 January, 2021
Blog
The year 2020 was a special one for all of us at Agama, the COVID-19 pandemic changed our way of interacting with each other, the way of...
22/01/2021
13 January, 2021
Opinion pieces
This is a guest post by Vladimir Uhrovic, Senior Designer at Slovak Telecom
A customer talking about their experience with y...
21/12/2020
21 December, 2020
News & press releases
The holiday season is here again, despite the Covid-19', which turned our lives upside down. However, in spite of...
18/06/2020
18 June, 2020
News & press releases
Read more about Agama version 6
Share this:...
06/05/2020
28 April, 2020
News & press releases
(Link ping, Suecia, 28 de abril de 2020) Agama, especialista en calidad de servicio de video y experiencia del cliente,...
29/04/2020
28 April, 2020
News & press releases
(Link ping, Sweden, April 28, 2020) - Agama, the specialist in video service quality and customer experience, launches ne...
20/03/2020
20 March, 2020
Events
As you know, ANGACOM has been postponed due to Corona. We are happy to meet virtually to discuss you needs and what Agama can offer p...
26/02/2020
13 January, 2020
Events
We are very excited to be introducing many new features and enhancements in the new major version of our solution. We believe in openn...