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 ...

07/10/2026

Dalet Flex LTS Delivers Smarter Media Operations from Ingest to Distribution

Dalet, a leading technology and service provider for media-rich organizations, today announced the latest Long-Term Supported (LTS) release of Dalet Flex. Build...

06/09/2026

Dolby and MagentaTV Bring Fans Closer to the FIFA World Cup 2026 in Germany with Dolby Vision and Dolby Atmos

June 9 2026, 23:00 (PDT) Dolby and MagentaTV Bring Fans Closer to the FIFA Worl...

20/08/2026

ROSE AYLING-ELLIS BEGINS FILMING SERIES TWO OF ITVS BAFTA-WINNING THRILLER CODE OF SILENCE

TV, BritBox and Mammoth Screen have announced that filming is now underway on th...

20/08/2026

Nielsen Incorporates New Enhancements To Improve Its Data Measurement Leading Into The New Fall TV Season

New York August 19, 2026 Nielsen today shared a number of key enhancements t...

20/08/2026

FAST Sports Programming Surges at More Than Twice the Rate of Sports Channel Growth

New Gracenote Data Hub analysis finds sports program titles up 31.2% and individ...

20/08/2026

Charter Completes $34.5 Billion Cox Acquisition

Share Copy link Facebook X Linkedin Bluesky Email...

20/08/2026

SubtitleNEXT makes a significant leap in localisation eff...

At IBC, Profuz Digital will showcase at stand 8.A88 the SubtitleNEXT platform delivering innovative AI transcription integrations and stunning new features boos...

20/08/2026

Transformation Church Elevates Production Communications...

Riedel Communications today announced that Transformation Church, one of the fastest-growing and most influential digital ministries in the United States, has d...

20/08/2026

QuickLink Showcases New 4K Capabilities Across StudioEdge and StudioCall at IBC 2026

QuickLink Showcases New 4K Capabilities Across StudioEdge and StudioCall at IBC ...

20/08/2026

The Boys Season Five Graded with DaVinci Resolve Studio

The Boys Season Five Graded with DaVinci Resolve Studio Brie Clayton August 20, 2026 0 Comments Colorist Siggy Ferstl uses Depth Map to bring a three ...

20/08/2026

Adobe Firefly expands its creative AI studio: generate music, speech, and sound effects in one place

Adobe Firefly expands its creative AI studio: generate music, speech, and sound ...

20/08/2026

Broadpeak launches Multiview as a Service to accelerate m...

Multiview available via SaaS for streaming platforms and operators through broadpeak.io, with live demonstrations at IBC2026 Broadpeak , a leader in streaming ...

20/08/2026

Techex Appoints Stuart Almond as Chief Revenue Officer

Techex, a leading provider of live broadcast infrastructure solutions, has appointed Stuart Almond as Chief Revenue Officer, further strengthening its executive...

20/08/2026

MediaCity Studios upgrades with Avid

Avid today announced that MediaCity Studios has upgraded its production infrastructure with an enhanced end-to-end Avid production ecosystem, including the dep...

20/08/2026

MS Now to Launch $7.99 DTC Service

Share Copy link Facebook X Linkedin Bluesky Email...

20/08/2026

Nielsen Details Improvements to Audience Measurement Capabilities

Share Copy link Facebook X Linkedin Bluesky Email...

20/08/2026

Study: 174 Billion Illegal Streams During FIFA World Cup 2026

Share Copy link Facebook X Linkedin Bluesky Email...

20/08/2026

Prasad Opens New 8K/4K Film Preservation & Restoration Center

Share Copy link Facebook X Linkedin Bluesky Email...

20/08/2026

IPC Expands Brazilian Presence with New Channel Partner C...

IPC Expands Brazilian Presence with New Channel Partner CCATech Industry veterans Carlos Abrah o and Bruno Lopes strengthen local support and expand IPCs prese...

20/08/2026

Zixi Enters Mauritius Market Through Strategic Deployment...

Zixi Enters Mauritius Market Through Strategic Deployment with MTC Jockey Club Worlds Oldest Horse Racing Club in the Southern Hemisphere Selects Zixis Softwar...

20/08/2026

Scripps Research scientist to receive $2.76 million NIAID New Innovators Award

LA JOLLA, CA-Scripps Research assistant professor Tiantian Liu has received a five-year NIAID DP2 award from the National Institute of Allergy and Infectious Di...

20/08/2026

Audiences reveal appetite for multicultural Australia on-screen

Audiences reveal appetite for multicultural Australia on-screen 20 August 2026 Dr Georgie McClean, Dr Rebecca Huntley (L-R) By Dr Georgie McClean and Dr Rebec...

20/08/2026

How Mavis Studio Is Expanding Live Production Teaching at Sussex

How Mavis Studio Is Expanding Live Production Teaching at Sussex Brie Clayton August 19, 2026 0 Comments Hero image displays a student about to mix be...

20/08/2026

Vertical Unscripted Series Legal Queens Captured with Blackmagic Design

Vertical Unscripted Series Legal Queens Captured with Blackmagic Design Brie Clayton August 19, 2026 0 Comments Reality TV veteran Eric Gardner create...

20/08/2026

The music between the notes

The music between the notes Coming together In the middle of 2026, as conversations around artificial intelligence continue to raise questions about how musi...

20/08/2026

Arvato Systems brings together digital transformation leaders in the manufacturing industry

Arvato Systems Brings Together Digital Transformation Leaders in the Manufacturi...

20/08/2026

Bring the Fire: Play Games on GeForce NOW With New Firefox Browser Support

It's a new way into the cloud. GeForce NOW welcomes Firefox support to the cloud, opening up another way to jump into high-performance PC gaming straight ...

19/08/2026

Imagine Communications Steve Reynolds on Kaseya Centers Hybrid IP Build and the Growth of ST 2110

As the cost of IP nears price parity with traditional SDI, Reynolds argues that ...

19/08/2026

European Athletics Championships 2026: BBC, Event Organizers Bring Birmingham Action to Viewers in Style

A private 5G bubble was chosen instead of traditional broadcast RF for the race ...

19/08/2026

Filipiana Sets the Class Divide on a Golf Course in the Philippines

(L-R) Rafael Manuel and Isabel Sicat attend the Filipi ana premiere during the 2026 Sundance Film Festival at The Ray Theatre on January 23, 2026, in Park Cit...

19/08/2026

MPG launch Save Our Studios survey

Studio owners invited to have their say on rates cuts The Music Producers Guild (MPG) are inviting UK-based studios to take part in an in-depth survey that ...

19/08/2026

Harrison unveil the Flex-10

Vintage-inspired desktop interface revealed Harrison's latest hardware offering sees them head into the world of audio interfaces, delivering a 10-in/12...

19/08/2026

Minimal Audio release Lucid

Granular effect remains locked to scale and tempo Described as your dream granular effect , Minimal Audio's latest creation is capable of turning any s...

19/08/2026

Audio Modeling open PolySWAM pre-orders

First polyphonic SWAM instrument incoming Audio Modeling's latest physical-modelling orchestral instrument is just around the corner, and is now availab...

19/08/2026

FOX and NBCUniversal Score with FIFA World Cup 2026 Success in Nielsen's June Gauge Reports

World Cup Games Generate 84 Billion Minutes Across FOX, Fox Sports 1 and NBCU...

19/08/2026

The Gauge: Poland | July 2026

July brought typical peak-holiday drops in viewership, driven primarily by viewers stepping away from screens and a visible decline in reach across both traditi...

19/08/2026

Carr Calls ABC Suit 'Meritless

Share Copy link Facebook X Linkedin Bluesky Email...

19/08/2026

Henry Alexander Joins BCE as Sales Director

Henry joins BCE as the company accelerates its commercial strategy and expands its international presence across the media, broadcast and technology markets. He...

19/08/2026

iWedia Announces Advanced Android DRAM Optimisation Proce...

iWedia, a leading provider of software solutions for connected TV devices, today announced a major milestone in Android platform optimization with the successfu...

19/08/2026

NTP Technology announces ST 2110-30-RAVENNA 128-channel A...

NTP Technology announces that ST 2110-30 audio-over-IP connectivity with AES67 and RAVENNA capabilities is now available for the brand's world-class audio i...

19/08/2026

ORF goes full IP with Net Insight in nationwide network o...

Net Insight has been selected to provide its Nimbra platform by the service provider Big Blue Marble, formerly ORS Group, as the core media transport solution f...

19/08/2026

Coventry City Trophy Parade Extends LiveU LIQ Beyond the...

LiveU has supported Coventry City FC and several other top-flight UK football clubs through one of their most demanding live production challenges of the year, ...

19/08/2026

Nature Seekers Documentary Shot with Blackmagic URSA Cine 12K LF

Nature Seekers Documentary Shot with Blackmagic URSA Cine 12K LF Brie Clayton August 18, 2026 0 Comments Filming endangered turtles required camera...

19/08/2026

Neyrinck Brings D-Control Consoles Back to Life on Apple Silicon with D-Control Basic

Neyrinck Brings D-Control Consoles Back to Life on Apple Silicon with D-Control ...

19/08/2026

ABC Files First Amendment Lawsuit Against FCC

Share Copy link Facebook X Linkedin Bluesky Email...

19/08/2026

Nielsen: Fox and NBCUniversal Score with FIFA World Cup 2026

Share Copy link Facebook X Linkedin Bluesky Email...

19/08/2026

ESPN Co-Founder Bill Rasmussen Dies At 93

Share Copy link Facebook X Linkedin Bluesky Email...

19/08/2026

Study: NBA Ad Revenue Hit $2.1 Billion Last Season

Share Copy link Facebook X Linkedin Bluesky Email...

19/08/2026

Nexstar's WNCN Donates ENG Van for Training

Share Copy link Facebook X Linkedin Bluesky Email...