Sony Pixel Power calrec Sony

Breaking the Myth of Difficult Device Integration

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 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
LINK: https://agama.tv/breaking-the-myth-of-difficult-device-integration/...
See more stories from agama

Most recent headlines

05/01/2027

Worlds first 802.15.4ab-UWB chip verified by Calterah and Rohde & Schwarz to be demoed at CES 2026

Worlds first 802.15.4ab-UWB chip verified by Calterah and Rohde & Schwarz to be ...

04/08/2026

Dalet Announces Commercial Availability of Dalia, Bringing Media-Aware Agentic AI to Enterprise Productions

Dalet, a leading technology and service provider for media-rich organizations, t...

04/07/2026

Detective Conan: Fallen Angel of the Highway Opens in Dolby Cinemas Across Japan, Presented in Dolby Atmos and Dolby ...

April 7 2026, 19:00 (PDT) Detective Conan: Fallen Angel of the Highway Opens in...

09/06/2026

Nielsen launches Four-Screen Ad Deduplication measurement on YouTube campaigns in Italy

Media buyers and sellers can now compare YouTube reach from computer, mobile, an...

09/06/2026

Andrew Beaudet Joins Brompton as Head of Sales, Americas

Share Copy link Facebook X Linkedin Bluesky Email...

09/06/2026

Mediaset Italia Deploys Mediagenix Platform To Modernize Scheduling

Share Copy link Facebook X Linkedin Bluesky Email...

09/06/2026

Mediaset Italia Modernizes Content Supply Chain and Chann...

A project aimed at modernizing scheduling operations across Mediaset's channel portfolio Mediagenix, a global leader in smart content solutions to profitab...

09/06/2026

ACT Entertainment Debuts tvONE 4RU CALICO PRO at InfoComm...

tvONE, an ACT Entertainment brand, debuts its most powerful video processor ever built: the 4RU CALICO PRO (C7-PRO-4200), at InfoComm 2026 (Booth N6813). Engine...

09/06/2026

Composer and Conductor Eric Whitacre to Receive Honorary Doctorate at Berklee Valencia's 2026 Commencement

Composer and Conductor Eric Whitacre to Receive Honorary Doctorate at Berklee Va...

09/06/2026

Comcast Advertising Adds Purchasing Data from Affinity Solutions

Share Copy link Facebook X Linkedin Bluesky Email...

09/06/2026

Midwich to Distribute Miri Technologies in North America

Share Copy link Facebook X Linkedin Bluesky Email...

09/06/2026

Nielsen: North American Soccer Fans Jump to More Than 136 Million

Share Copy link Facebook X Linkedin Bluesky Email...

09/06/2026

Grass Valley and Lawo Collaborate to Advance Open Dynamic...

Technology collaboration to validate AMPP and Lawo HOME orchestration integration, showcasing Dynamic Media Facility principles in practice. Grass Valley and ...

09/06/2026

Bitmovin Player Web X Powers Axel Springer New Audio News...

Bitmovin, a leading provider of video streaming solutions, today announced that Axel Springer SE, international media and technology company, has deployed Playe...

09/06/2026

LiveU Delivers First Remote VAR Deployment Across the Pac...

LiveU, the global leader in live IP-video solutions, today announced a landmark deployment with the Oceania Football Confederation (OFC) that has brought Video ...

09/06/2026

Sam Craig Joins Grass Valley as VP, Global Pre-Sales

Share Copy link Facebook X Linkedin Bluesky Email...

09/06/2026

Arkansas TV Will Continue to Air PBS Programming

Share Copy link Facebook X Linkedin Bluesky Email...

09/06/2026

Glensound to Show DARK22M Network Audio Interface at InfoComm 2026

Share Copy link Facebook X Linkedin Bluesky Email...

09/06/2026

EVS Rebrands, Trims Its Name

Share Copy link Facebook X Linkedin Bluesky Email...

09/06/2026

FCC Announces Tentative Agenda for June 25 Open Meeting

Share Copy link Facebook X Linkedin Bluesky Email...

09/06/2026

Two Alumni Win Tony Awards

Two Alumni Win Tony Awards Mike Morris and Cedric Leiba Jr. won awards for Best Orchestrations and Best Play, respectively. June 8, 2026 By Tori Donahue ...

09/06/2026

ENNI Will Be Using AEP.EnerS4 Billing Solution

Enni Continues to Rely on Arvato Systems - And Will Be Using AEP.EnerS4 Billing Solution Arvato Systems to implement transformation project for SAP S/4HANA Ut...

09/06/2026

RT Radio 1 is bringing Arena and Cil House to London celebrating 100 years of RT

These special programmes will highlight RT 's connection with the Irish diaspora This year, RT is marking 100 years of public broadcasting in Ireland with...

08/06/2026

SVG Sit-Down: FIFA's Oscar Sanchez and HBS's Paul King on Deploying 16 Production Teams in 16 World Cup Venues

The two execs discuss the goals and the challenges of building a huge multi-cult...

08/06/2026

SVG All-Stars: Judi Weiss, Senior Manager, Remote Operations (Studio), ESPN

This industry legend has been a road warrior since the early '90s and is, today, a lynchpin on College GameDay The sports-production industry continues to ...

08/06/2026

DAZN Extends Combat Sports Portfolio with EFC Partnership

DAZN has agreed a multi-year rights partnership with Extreme Fighting Championship (EFC), expanding its global combat sports portfolio. DAZN will broadcast EFC...

08/06/2026

Whitepaper: TVU Networks Tackles the Future of Sports Production

As fans move across broadcast, streaming, social, mobile and creator-led platforms, and they expect every angle, in real time, TVU Networks has released a new e...

08/06/2026

Infront Strengthens Diamond League Global Broadcast Network Through Spate of New Agreements

Infront has further strengthened the 2026 Diamond League's international bro...

08/06/2026

Grass Valley Appoints Sam Craig as Vice President, Global Pre-Sales

Grass Valley has announced the appointment of Sam Craig as Vice President, Global Pre-Sales. Based in the United States, Craig will lead Grass Valley's glob...

08/06/2026

SMPTE Announces Summer 2026 IP Networking and ST 2110 Course Lineup

SMPTE has announced its summer 2026 education lineup covering IP networking and SMPTE ST 2110, including two standalone courses, a 13-week boot camp, and a hand...

08/06/2026

Sportradar and Kalshi Announce Multi-Year Data and Infrastructure Partnership for Prediction Markets

Sportradar Group AG has announced a multi-year global agreement with Kalshi, a p...

08/06/2026

FIFA and Gamefam Launch FIFA World Cup 2026 Event on Roblox

FIFA and Gamefam have announced the launch of a FIFA World Cup 2026 event on Roblox, running June 5 through July 31, 2026. The event centers on FIFA Super Socce...

08/06/2026

Stanley Pup 2026: Fun Is the Goal When the Rescue-Dog Competition Returns for Year 3

A collaboration of NHL Productions, Monumental Sports, and Michael Levitt Produc...

08/06/2026

Bryce Adair, CBS Production Assistant, Dies in Car Crash at 31

CBS Sports production staffer Bryce Adair has died at the age of 31 after sustaining injuries during a car accident on Wednesday while in Ohio working the the P...

08/06/2026

Behind the Mic: Russell Wilson and Kyle Long Join CBS Sports The NFL Today

Behind The Mic provides a roundup of recent news regarding on-air talent, including new deals, departures, and assignments compiled from press releases and repo...

08/06/2026

WMT Digital Launches Sports Customer Data Platform Built to Turn Fan Intelligence into Revenue

WMT Digital today announced the launch of WMT Fan Intelligence, designed to unif...

08/06/2026

Miami Heat Ink New Deal With WPLG Local 10, Join NBAs Growing OTA Crowd

The Heat are the seventh NBA team to air their games over-the-air next season...

08/06/2026

Paramount and UFC Expand Media Rights Partnership to Canada Beginning in 2027

Paramount and UFC have announced an expansion of their media rights partnership making Paramount the exclusive home of UFC Numbered Event main cards in Canada ...

08/06/2026

Qatar Football Association Deploys Virtual Advertising Technology for First Time with Sponix

The Qatar Football Association (QFA), in cooperation with Sponix and broadcaster...

08/06/2026

Project B Appoints HBS as Official Host Broadcaster for Global Basketball Circuit

Project B has announced the appointment of Host Broadcast Services (HBS) as Offi...

08/06/2026

Ohio State's Marco Fragale on the Growth of On-Campus B1G+ Productions and StudentU

The Buckeyes now produce and stream upwards of 200 sports events annually with a...

08/06/2026

Meet the New GLOW Ambassadors Leading Spotify's Global Pride Celebration

At Spotify, our commitment to the LGBTQIA community is year-round. Through GLOW, our global music program, we celebrate and amplify the contributions of queer ...

08/06/2026

GearExpo UK: Keyboard & Synth Update

Get Hands-on With Keyboard & Synth Brands GearExpo UK wouldn't be complete without some synth action, and we've got some of the industry's most ...

08/06/2026

IK Multimedia's ARC On-Ear gains IEM support

50 popular in-ear monitoring system profiles added The latest update for IK Multimedia's headphone-correction system has just arrived, and introduces ca...

08/06/2026

Audeze announce the MM-520

Manny Marroquin signature cans upgraded with SLAM Technology The flagship model in Audeze's Manny Marroquin Signature Series has just been treated to an...

08/06/2026

Air domain supremacy redefined - New counter UAS, space solutions and directional communications from Rohde & Schwarz debut at ILA

Air domain supremacy redefined - New counter UAS, space solutions and directiona...

08/06/2026

BBC announces Hercule, starring Edward Bluemel as Agatha Christie's legendary detective Hercule Poirot

he BBC and BritBox have announced that Edward Bluemel (We Might Regret This, My ...

08/06/2026

Sam Craig Joins Grass Valley as VP, Global Presales

Share Copy link Facebook X Linkedin Bluesky Email...

08/06/2026

SMPTE Sets Course Lineup With ST 2110, IP Networking Focus

Share Copy link Facebook X Linkedin Bluesky Email...