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

18/08/2026

SportStream 2026 Virtual Event Set for September 15-17

SportStream 2026, a free three-day virtual event, will take place September 15-17. One registration provides access to all three days of live programming and on...

18/08/2026

IBC 2026: BeckTV to Debut BeckFlow Documentation Platform

BeckTV will introduce BeckFlow to the European market at IBC2026, demonstrated on the Providius stand (10.F53). BeckFlow is a web-based schematic documentation...

18/08/2026

IBC 2026: Boland Communications to Introduce ST 2110 Option for 4K Monitors

Boland Communications will introduce a SMPTE ST 2110 input option for its 4K monitors at IBC2026, along with a new 55-inch super-narrow bezel display for video ...

18/08/2026

Seattle Seahawks Integrate Dolby OptiView with Dolby Vision for Fan Streaming

Dolby Laboratories and the Seattle Seahawks have announced a partnership integrating Dolby OptiView into the Seahawks' live streaming coverage, making the S...

18/08/2026

Insights from BMG's Graham Taylor on the Role of a Sports Producer in Live Broadcast Production

For BMG Executive Producer of Sports Production, Graham Taylor, producing live s...

18/08/2026

TMRW Sports Names Rufus Hack as President of Golf

TMRW Sports has appointed Rufus Hack as President of Golf, a newly created role in which he will lead the company's golf businesses including TGL presented ...

18/08/2026

SMT To Deliver Race Technology for Freedom 250 IndyCar Broadcast

SMT will provide race technology for FOX Sports' coverage of the Freedom 250 Grand Prix of Washington, D.C. on August 23, when the NTT INDYCAR SERIES races ...

18/08/2026

HMA's Creator Collective Pairs Digital Creators, Beat Writers in New Model for Local-Sports Coverage

The live, YouTube-native roundtables combine fan voices, credentialed reporters,...

18/08/2026

Behind The Mic: FOX Sports Shares Broadcast Lineup for 2026 NFL Season and College Football Season

Behind The Mic provides a roundup of recent news regarding on-air talent, includ...

18/08/2026

Miami Heats Ed Filomia on Rebuilding Kaseya Centers Video Infrastructure and 29 Years With the Heat

The industry legend sounds off on replacing the Heat's iconic Medusa score...

18/08/2026

Bill Rasmussen, ESPN Founder and Sports Broadcasting Hall of Famer, Dies at 93

William F. Rasmussen, the sports fan-turned broadcaster and entrepreneur whose out-of-the-box idea of a 24-hour cable sports network, ESPN, changed forever the ...

18/08/2026

DAZN Completes Acquisition of ViewLift

DAZN Group has completed its acquisition of ViewLift, a provider of streaming and digital solutions for sports content owners. The acquisition was first announc...

18/08/2026

American Association of Professional Baseball Adds SI TV as Broadcast Partner

The American Association of Professional Baseball (AAPB) has added SI TV, Sports Illustrated's 24/7 streaming channel, as a broadcast partner for the remain...

18/08/2026

Esports Foundation Postpones Inaugural Esports Nations Cup to November 2027

The Esports Foundation has announced that the inaugural Esports Nations Cup (ENC), originally scheduled for November 2026 in Riyadh, will be postponed to Novemb...

18/08/2026

Diversified Launches Global Managed Services Practice

Diversified has announced a new Global Managed Services Practice, consolidating the company's managed services capabilities into one organization. Rob Mello...

18/08/2026

Appear Completes REMI Proof of Concept with Thoroughbred Racing Productions

Appear has completed a proof of concept with Thoroughbred Racing Productions (TRP), demonstrating multi-camera remote live production over bonded 5G cellular an...

18/08/2026

IBC 2026: Riedel Implements Live Production Infrastructure at Edith Cowan University

Riedel Communications has announced that Edith Cowan University (ECU) in Perth, ...

18/08/2026

Panoramic from Panorama Labs

Company launch with stereo-imaging tool Panoramic is the debut release from Panorama Labs, a new company formed by mastering engineer Nicholas Di Lorenzo. C...

18/08/2026

Focusrite extend Control 2 support

Control software now available for older interfaces Focusrite have just announced the launch of an update that extends Control 2 software support their Scar...

18/08/2026

Call for the 20th Annual South African Film and Television Awards (SAFTAs20) Jury

The National Film and Video Foundation (NFVF), an agency of the Department of Sp...

18/08/2026

Corridor Television Pays $27,000 for Violating FCCs EAS Rules

Share Copy link Facebook X Linkedin Bluesky Email...

18/08/2026

Disney's ABC Files First Amendment Lawsuit Against the FCC

Share Copy link Facebook X Linkedin Bluesky Email...

18/08/2026

Lightware Integrates with SpectralBot to Accelerate AV Tr...

Lightware announces an integration with SpectralBot that helps system integrators and AV operators troubleshoot faster using augmented reality (AR), AI-assisted...

18/08/2026

Command Frame for After Effects

Command Frame for After Effects Scott Black August 18, 2026 0 Comments Free download, demonstrations, hands-on tests, and creator resources Want to t...

18/08/2026

Dot Group to show how cutting carbon cuts cost - live at...

At Stand 14.A57, the data company will demonstrate GreenDot and IBM Aspera together, giving media and entertainment businesses real-time visibility of what thei...

18/08/2026

Blue Lucy launches Connected Value Audit

New tool provides a robust audit of operational workflows, calculating the tangible value each delivers today, and informing business decisions for tomorrow. W...

18/08/2026

Media Utilities transitions to Media Utilities - a DigiNe...

Media Utilities is integrating its activities into DigiNet and will maintain a recognisable presence in the market under the name: Media Utilities, a DigiNet br...

18/08/2026

Appear demonstrates broadcast-grade REMI production over...

Proof of Concept validates reliable multi-camera live production from remote racecourses without fixed network infrastructure Appear ASA (Appear, OSE:APR), a g...

18/08/2026

Stingr brings frictionless second-screen interaction to I...

Stingr, a new venture from the founders of Hornets Tech, is bringing its second-screen interaction platform to IBC2026. The second screen has never really wor...

18/08/2026

Hiltron to Promote its Latest Generation Satellite Commun...

Long-established satellite equipment manufacturer and systems integrator Hiltron Communications will promote its new HACUX-IDU2 antenna control unit touchscreen...

18/08/2026

EMAM, PlayBox Neo and SNEWS Launch Combined Nuvex System

EMAM, PlayBox Neo and SNEWS Launch Combined Nuvex System Brie Clayton August 17, 2026 0 Comments Integrated platform melds media asset management, pla...

18/08/2026

The United Stand Scales Live Fan Show with Blackmagic Design Workflow

The United Stand Scales Live Fan Show with Blackmagic Design Workflow Brie Clayton August 17, 2026 0 Comments ATEM Constellation 8K and HyperDeck Stud...

18/08/2026

Twin Cities PBS to Become Minnesota PBS

Share Copy link Facebook X Linkedin Bluesky Email...

18/08/2026

MPA, ByteDance Reach AI Copyright Protection Deal

Share Copy link Facebook X Linkedin Bluesky Email...

18/08/2026

DirecTV to Launch Curated Multiview for Live Sports

Share Copy link Facebook X Linkedin Bluesky Email...

18/08/2026

Sinclair Taps Carol Kellum to Head Nebraska Stations

Share Copy link Facebook X Linkedin Bluesky Email...

18/08/2026

Corridor Television Pays $27,000 for Violations of FCCs EAS Rules

Share Copy link Facebook X Linkedin Bluesky Email...

18/08/2026

Triveni Digital Accelerates TV 3 0 Transition in Brazil W...

Triveni Digital Now Offers a Joint Solution With MediaKind and a Lab System Bundle Supporting ISDB-Tb and TV 3.0 Broadcast Services Triveni Digital, a trusted ...

18/08/2026

BeckTV Debuts BeckFlow at IBC and Showcases Expertise for...

At IBC2026, BeckTV, a premier systems integrator for the broadcast industry, will introduce BeckFlow to the European market. BeckFlow is the first web-based sch...

18/08/2026

PTZOptics Launches Rise 4K Bringing Ultra HD Quality and...

New flagship PTZ camera combines cinematic 4K imaging, professional broadcast connectivity and the complete Horizon intelligent video experience for productions...

18/08/2026

VisualOn IBC Show Preview - AI-Powered CAE Advanced Playb...

At IBC2026, VisualOn will demonstrate how video service providers can slash bandwidth costs, maximize ad revenue, and deploy premium interactive features withou...

18/08/2026

Paying It Forward: Greg Tabor on Giving Back to the Next Generation

The relationships built during graduate school often continue to shape careers long after a degree is earned, creating a community of scientists who learn from ...

18/08/2026

Sky Sports and The Fast and the Curious announce new partnership

Tuesday 18 August 2026 Sky Sports and The Fast and the Curious announce new partnership Sky Sports and The Fast and the Curious have announced a new long-term...

18/08/2026

Riedel Brings Professional Live Production Into the Classrooms of ECU

Wuppertal August 18, 2026 Riedel Brings Professional Live Production Into the Classrooms of ECURiedel Communications today announced that Edith Cowan Universi...

18/08/2026

The Biggest AI Opportunity Isn't in Engineering. It's in Everyone Else.

In my previous article, The AI Shift Feels Familiar. Our Response Should Be Different., I argued that the greatest challenge organizations face is no longer the...

18/08/2026

Apple announces changes for apps in the European Union - UPDATE - Posted on 18 August 2026

Apple today announced changes to its business terms for apps in the European Uni...

18/08/2026

RT TO AIR NEW DOCUMENTARY THAT LIFTS THE LID ON THE HEALY RAE DYNASTY

THE HEALY RAES: BLOOD, SWEAT & TEARS AIRS WEDNESDAY AUGUST 19 ON RT ONE AT 9:35PM A new documentary The Healy-Raes: Blood, Sweat & Tears airs on RT One and ...