
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
Most recent headlines
05/01/2027
Worlds first 802.15.4ab-UWB chip verified by Calterah and Rohde & Schwarz to be ...
09/10/2026
September 10 2026, 06:00 (PDT) Dolby Expands Dolby OptiView Platform with New Capabilities at IBC 2026
New Sports Intelligence helps providers better unders...
07/10/2026
Dalet, a leading technology and service provider for media-rich organizations, today announced the latest Long-Term Supported (LTS) release of Dalet Flex. Build...
24/09/2026
Broadcast Management Group (BMG) is supporting Virginia Public Media (VPM), the ...
24/09/2026
RED Digital Cinema's RED V-RAPTOR [X] and RED V-RAPTOR XL [X] cameras with the Phantom Track feature are the first cameras to receive GhostFrame Pro Certifi...
24/09/2026
Bringing together the full family of networks, FOX Sports is also adding Tubi, F...
24/09/2026
Virginia Polytechnic Institute and State University (Virginia Tech) has unveiled...
24/09/2026
The blog collects SVG's reporting on AI across U.S. and European sports broadcasting
Since SVG launched the AI Innovation Lab in April to advance the devel...
24/09/2026
SVG's annual TranSPORT conference, which will be held on Tuesday, Oct. 20 in...
24/09/2026
The self-built Master Control Room has cut streaming operations incident-respo...
24/09/2026
Ortana Media Group, the software systems integrator behind the Cubix workflow platform, has connected AudioShake's audio separation models to ScorePlay thro...
24/09/2026
AudioShake has released Multi-Speaker 2.0, the company's newest Multi-Speaker model, which removes 75% more noise and offers 32% better separation of overla...
24/09/2026
By Jon Morgan, Founder and Executive Producer, Ryval Studios
For Major League B...
24/09/2026
Spectrum SportsNet has revealed its comprehensive programming and live game broa...
24/09/2026
The Charlotte Hornets has unveiled new broadcast partnerships with Gray Media an...
24/09/2026
DAZN will be the exclusive direct-to-consumer streaming partner for the Detroit Pistons beginning with the 2026-27 season. Subscriptions are available at DAZN.c...
24/09/2026
The National Hockey League (NHL) has made an agreement with Spectrum that will allow Spectrum TV customers in the Minnesota Wild local broadcast territory to wa...
24/09/2026
The Carolina Hurricanes has reached a multi-year distribution agreement to provi...
24/09/2026
The St. Louis Blues has introduced Blue Note as the name of the new, exclusive ...
24/09/2026
Blue Jackets Hockey Network, the television home for Blue Jackets hockey, is coming to Spectrum TV under a new carriage agreement between the National Hockey Le...
24/09/2026
The next generation of multitrack recording for live sound
The latest version of Waves' dedicated live multitrack recording software delivers an array ...
24/09/2026
An idea machine for musicians
Described as an idea machine for musicians , the latest addition to Polyend's growing collection of guitar pedals combin...
24/09/2026
Alignment tool gains multitrack layout
Synchro Arts have just launched the latest version of their renowned time-alignment plug-in, and it's said to be ...
24/09/2026
Synth gains DAW Control & Ctrl-e integration
Expressive E have just released a major firmware update that brings some interesting new features to the Osmose...
24/09/2026
Rohde & Schwarz expands its system amplifier portfolio with the R&S SAM200 for a...
24/09/2026
September 24, 2026
The Hitachi Startup Challenge FY26 invites innovative startu...
24/09/2026
Download Now!
To receive a short case study showcasing NHK Technologies, Inc. (NT) s audio setup, please enter the following details:
--
First Name* Fir...
24/09/2026
Manifold Technologies Appoints Ryhaan Williams as CCO for North America
Brie Clayton September 24, 2026
0 Comments
Brings three decades of broadcast e...
24/09/2026
UNIFACHA Expands Educational Program with DaVinci Resolve Studio
Brie Clayton September 24, 2026
0 Comments
Brazilian university empowers next generat...
24/09/2026
Share
Copy link
Facebook
X
Linkedin
Bluesky
Email...
24/09/2026
Viewers watching videos from the Austrian Parliament online will soon find it easier to verify the authenticity of the content. Big Blue Marble, an internationa...
24/09/2026
nsign, the digital signage SaaS platform built around its Simplify Complexity principle, is now officially certified for BRAVIA Professional Displays from Son...
24/09/2026
Encompass Digital Media today announced the successful migration of multiple Viaplay free-to-air channels, including TV3, TV6, TV8 and TV10, to its Altitude Sch...
24/09/2026
Share
Copy link
Facebook
X
Linkedin
Bluesky
Email...
24/09/2026
Share
Copy link
Facebook
X
Linkedin
Bluesky
Email...
24/09/2026
Share
Copy link
Facebook
X
Linkedin
Bluesky
Email...
24/09/2026
Share
Copy link
Facebook
X
Linkedin
Bluesky
Email...
24/09/2026
Share
Copy link
Facebook
X
Linkedin
Bluesky
Email...
24/09/2026
Music Supervisor, Composer, and Mixing Engineer Santiago Uribe has built a career around producing music for film and television, contributing to more than 40 p...
24/09/2026
The North American Broadcasters Association (NABA) will hold a full-day cybersecurity summit focused on defending against growing cyber threats facing the broad...
24/09/2026
London, 24th September 2026: UKTV has commissioned an eighth series of Canal Boat Diaries (8x60') for U (u.co.uk) and U&YESTERDAY, with waterways explorer R...
24/09/2026
September 24th, 2026 TRIBECA FESTIVAL AND AT&T OPEN SUBMISSIONS FOR 10TH ANNIVE...
24/09/2026
Reinaldo Marcus Green, director of six-time Academy Award-nominated King Richard...
24/09/2026
From the buzz of your phone when a message arrives to surgeons being able to feel' the patients they are examining from hundreds of kilometres away, these ...
24/09/2026
As Q4 approaches, retailers enter the most critical sales window of the year the golden quarter.
Stretching from October through December, this period encomp...
24/09/2026
Key Takeaways
Harmonic's cOS virtualized platform enables Lightcurve to de...
24/09/2026
COLD Launches Insider Club on Supercast, Giving True Crime Fans Ad-Free Listenin...
24/09/2026
The home interiors retailer signs up for third year as sponsor
RT Commercial today announced that Harry Corry has signed up to a third year as sponsor of Live...
24/09/2026
When COVID-19 emerged, scientists had a crucial advantage: Decades of prior research on coronaviruses meant they understood the virus' key proteins well eno...
24/09/2026
RT Radio 1 Folk Awards Tickets on Sale
Dolores Keane to be inducted into the...