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

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

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

11/06/2026

NABs LeGeyt Urges Congress to Limit NFL's Antitrust Exemption

Share Copy link Facebook X Linkedin Bluesky Email...

11/06/2026

Fubo Inks New Distribution Agreement with NBCUniversal

Share Copy link Facebook X Linkedin Bluesky Email...

11/06/2026

Kiloview to Showcase Broadcast-Grade AV-over-IP Solutions...

Kiloview, a leading innovator in AV-over-IP video solutions, will return to InfoComm 2026 (Booth# N8327) with broadcast-grade AV-over-IP solutions designed for ...

11/06/2026

Australian Games Industry Glossary of Terms

Australian Games Industry Glossary of Terms 10 June 2026 From DAU and EULA to COT and QADE, here's a list of game industry terms, industry jargon and their...

11/06/2026

Berklee's Tonya Butler Named Music Business Educator of the Year

Berklee's Tonya Butler Named Music Business Educator of the Year The Music Business Association honored Butler at its annual Bizzy Awards. June 10, 2026 ...

11/06/2026

Ann Mincieli to Receive Honorary Doctorate at Berklee NYC Graduate Commencement

Ann Mincieli to Receive Honorary Doctorate at Berklee NYC Graduate Commencement The five-time Grammy-winning engineer and producer, known for her longstanding...

10/06/2026

SVG Sit-Down: Team Whistle's Joe Caporoso on Building World Cup Content Around Fans, Culture, IRL Experiences

DAZN-owned digital-media company launches three fan-first series leaning into cr...

10/06/2026

Clear-Com Appoints Jason Dino as Southwest Regional Sales Manager

Clear-Com has announced the appointment of Jason Dino as Southwest Regional Sales Manager USA, covering Southern California and the Southwest region. Dino joins...

10/06/2026

Caretta Research: 2026 World Cup Revenue Growth Due to More Matches; Rights Revenue Up 32%

An 11% decrease in number of global broadcast deals reflects the organization...

10/06/2026

Women Without Boundaries Awards Are Back!

The Women Without Boundaries Awards recognize women whose work is advancing the future of media, broadcast, AV, workplace technology, digital experience, and re...

10/06/2026

On Eve of World Cup Kickoff, FIFA and HBS Offer Deep Dive into IBC Operations, Commentary, and Ref Cam

Today is match day minus two for FIFA and HBS. On Thursday, there will be two ma...

10/06/2026

SES Supporting World's Biggest Soccer Tournament Broadcast Distribution Worldwide

SES is supporting broadcast distribution of the world's biggest football tou...

10/06/2026

BirdDog Achieves Full NDI 6.3 Compatibility Across Entire Product Line

NDI has announced that BirdDog has become the first hardware manufacturer to achieve full NDI 6.3 compatibility across its complete lineup of cameras, encoders,...

10/06/2026

Emmy Award-Winning Audio Team To Present at SVG Audio Symposium

Vince Caputo and Scott Carter, winners of the 2026 Sports Emmy for Outstanding Post Produced Audio have been announced as presenters for the 2026 SVG Advanced A...

10/06/2026

FOX One Set to Deliver World Cup in 4K; Personalization via AI Drives Experience

FOX One today unveiled a slate of new product features and enhancements designed to elevate the viewing experience for fans on the official streaming platform o...

10/06/2026

PWHL Scales Broadcast Operation in Season 3, Relying on World-Feed Model and Key Vendors

Primary production partners Dome Productions and Raycom Sports once again played...

10/06/2026

NFL Films Application Deadline for Women in Sports Filmmaking Experienceship, Augusts 26-29 in Mount Laurel, Closes June 18

The Women in Sports Filmmaking Experienceship is an immersive professional devel...

10/06/2026

NBAs In-House Broadcast Ops & Engineering Teams Power Global Finals Coverage From NYC, San Antonio

The league has expanded its HSAN architecture for the NBA Finals to manage more ...

10/06/2026

MoonPay X Games League Winter Draft Set for September 16 at Cosm Los Angeles

The inaugural MoonPay X Games League (XGL) Winter Draft will take place Wednesday, September 16, 2026 at Cosm Los Angeles from 7-9 p.m. PT. The event will strea...

10/06/2026

University of Oklahoma and Learfield Extend 30-Year Partnership, Announce Sooner Evolution Center

The University of Oklahoma (OU) Athletics Department and Learfield have announce...

10/06/2026

VSF Releases RIST Satellite-Hybrid Out-of-Band Specification

The Video Services Forum (VSF) has released TR-06-4 Part 8, a new specification for RIST Satellite-Hybrid: Out-of-Band Method. The specification creates a mecha...

10/06/2026

Riedel Artist Intercom Powers Live Neurovascular Conference in Lisbon

Riedel Communications provided the communications infrastructure for the 14th World Live Neurovascular Conference (WLNC) in Lisbon, supporting live medical proc...

10/06/2026

Sundance Film Festival 101: Films by LGBTQ+ Directors

A still from The Doom Generation by Gregg Araki (Courtesy of Sundance Institute) By Lucy Spicer Have you checked out our Sundance Film Festival 101 list yet...

10/06/2026

GearExpo UK: Interfaces & Mic Preamp Update

Get Hands-On with Interfaces & Mic Preamp Brands If youre after a new interface or preamp, then GearExpo UK is the place to be! Well have a whole host of au...

10/06/2026

MONO Music Conference 2026

November 13-14 2026, The Midway, San Francisco Following their recent rebranding, MONO Music Conference (formerly Music Expo) have officially announced thei...

10/06/2026

ebbandflow launch with deFORM

Debut instrument free for limited time deFORM is the debut release from newly founded developer ebbandflow, and it's being offered as a free download fo...

10/06/2026

Alone Australia Season 4: Meet the Cast

Alone Australia Season 4: Meet the Cast 10 June, 2026 Media releases WATCH THE TRAILER Smash-hit survival series Alone Australia drops its highly anticipa...

10/06/2026

DEADLY THEN, DEADLY NOW, DEADLY ALWAYS: SBS & NITV IGNITE NAIDOC WEEK 2026 WITH 50 YEARS OF DEADLY

DEADLY THEN, DEADLY NOW, DEADLY ALWAYS: SBS & NITV IGNITE NAIDOC WEEK 2026 WITH ...

10/06/2026

Rohde & Schwarz and TRUMPF advance laser-based drone defense with THORIS LCS

Rohde & Schwarz and TRUMPF advance laser-based drone defense with THORIS LCS Rohde & Schwarz is showcasing THORIS at ILA 2026: A sovereign, end to end counter...

10/06/2026

MAHLE and Rohde & Schwarz develop application for sensor testing of modern driver assistance systems

MAHLE and Rohde & Schwarz develop application for sensor testing of modern drive...

10/06/2026

NFVF CALL FOR FUNDING APPLICATIONS: PRODUCTION & DEVELOPMENT 2026/27

Production and Development Funding supports the creation of compelling, commercially viable, artistic and culturally relevant South African screen content. Deve...

10/06/2026

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

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

10/06/2026

Ecoflow X Launches as Experimentation Arm for Sustainabil...

Accedo, Humans not Robots, and the Institution of Engineering and Technology (IET) have announced the launch of Ecoflow X. Formerly an IBC Accelerator project, ...

10/06/2026

Frequency Appoints James Smith as General Manager - Monet...

Frequency, the engine powering the world's leading streaming television channels, today announced that James Smith has joined the company as General Manager...

10/06/2026

Riedel Artist at the Heart of the 14th World Live Neurova...

At the 14th World Live Neurovascular Conference (WLNC) in Lisbon, Riedel Communications provided the communications infrastructure for live medical procedures s...

10/06/2026

Globecast Unveils Content Exchange Platform Powered by Or...

Globecast, a leading provider of broadcast, media, and entertainment managed services, today announced the launch of its Content Exchange platform powered by Or...

10/06/2026

Venues and integrators shift toward professional recharge...

Klvr will showcase how venues, integrators and production teams are rethinking disposable battery usage at InfoComm 2026 (Las Vegas, June 17-19, booth #N6311). ...

10/06/2026

VSF Releases Specification for RIST Satellite Hybrid Out-...

The Video Services Forum (VSF) has further enhanced the Reliable Internet Streaming Transport (RIST) protocol by incorporating a new feature, RIST Satellite-Hyb...

10/06/2026

Microphone Maker Audix Adds Eric Reese as VP

Share Copy link Facebook X Linkedin Bluesky Email...

10/06/2026

NVIDIA Accelerates Google DeepMind's DiffusionGemma for Local AI

Today, Google DeepMind released DiffusionGemma - an experimental open model built for exceptionally fast text generation. NVIDIA has optimized DiffusionGemma to...

10/06/2026

For Robotaxis, Safety Must Be Built In, Not Bolted On

A car pulls up to the curb. The app says, Your ride is here. No one's in the driver's seat. For people who live in one of the dozens of cities now hos...

10/06/2026

VEON's Banglalink Brings Every World Cup 2026 Match to Football Fans in Bangladesh on Toffee

10 Jun 2026 VEON's Banglalink Brings Every World Cup 2026 Match to Football...

10/06/2026

How to watch every ICC Womens T20 World Cup 2026 match live on Sky Sports

Wednesday 10 June 2026 How to watch every ICC Women's T20 World Cup 2026 match live on Sky Sports Where is the ICC Women's T20 World Cup 2026 availabl...

10/06/2026

PRLA brings first-ever Beautifully Clean Oral Care TV campaign to screens nationwide with Sky

Wednesday 10 June 2026 P RLA brings first-ever Beautifully Clean Oral Care'...

10/06/2026

Sky reveals pulse-pounding first teaser trailer for upcoming crime drama Fightland

Wednesday 10 June 2026 Sky reveals pulse-pounding first teaser trailer for upco...

10/06/2026

Riedel Artist at the Heart of the 14th World Live Neurovascular Conference

Wuppertal June 10, 2026 Riedel Artist at the Heart of the 14th World Live Neurovascular ConferenceAt the 14th World Live Neurovascular Conference (WLNC) in Li...