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

10/07/2026

SVG GameDay, Ep. 23: Nashville Predators Teri Johnson - Throwing a Bash on Broadway

In-venue and creative video staffers at the professional and collegiate level ha...

10/07/2026

Fujifilm Announces FUJINON GF19-35mmT3.5 PZ OIS WR Cinema Power Zoom Lens

FUJIFILM North America Corporation has announced the FUJINON GF19-35mmT3.5 PZ OIS WR, a cinema power zoom lens for the GFX System with native G Mount. The lens ...

10/07/2026

Dalet Releases Long-Term Supported Update to Dalet Flex

Dalet has announced a new Long-Term Supported (LTS) release of Dalet Flex, expanding AI capabilities, workflow automation, and integration with Dalia, Dalet'...

10/07/2026

Blackmagic Design Releases Fairlight Live Audio Mixer Software

Blackmagic Design has released Fairlight Live, a free software-based broadcast audio mixer for Mac and Windows, available for download now. Simultaneously, the ...

10/07/2026

FloSports and USA South Athletic Conference Announce Exclusive Media Rights Partnership

FloSports and the USA South Athletic Conference have announced an exclusive medi...

10/07/2026

Daktronics Installs LED Video Board at Field of Dreams Ballpark in Dyersville, Iowa

Daktronics has manufactured and installed an LED video display at Field of Dream...

10/07/2026

Registration Opens for NAB Show New York 2026, October 21-22 at the Javits Center

Registration is now open for NAB Show New York 2026, taking place October 21-22 ...

10/07/2026

Sphere and Formula 1 Heineken Las Vegas Grand Prix Announce Five-Year Partnership Extension

Sphere Entertainment Co. and the Formula 1 Heineken Las Vegas Grand Prix have an...

10/07/2026

CBS Sports and Asian Football Confederation Announce U.S. Media Rights Agreement

CBS Sports and the Asian Football Confederation (AFC) have announced a media rights partnership covering the AFC Asian Cup Saudi Arabia 2027 and the AFC U23 Asi...

10/07/2026

Sony Electronics Announces RX10 V with AI Autofocus and 4K 120p Video

Sony Electronics has announced the RX10 V, the fifth generation of its RX10 all-in-one camera series. The camera will be available in August 2026 at a suggested...

10/07/2026

Chyron Releases PRIME 5.4 with Newsroom Workflow Expansion and New Playout Options

Chyron has announced PRIME 5.4, an update to its unified graphics, playout, and ...

10/07/2026

Sports Broadcasting Hall of Famer Gene Mikell Dies at 87

The nine-time Emmy Award-winning video engineer was a pioneer of NASCAR in-car cameras and a longtime fixture in FOX Sports' video-control operation...

10/07/2026

Fubo Appoints Alisa Bowen as Chief Executive Officer

FuboTV Inc. has announced the appointment of Alisa Bowen as Chief Executive Officer, effective July 10. Bowen succeeds David Gandler, who co-founded the company...

10/07/2026

Ratings Roundup: USMNT-Belgium on FOX Top Soccer Telecast in U.S. History; Mexico-England on Telemundo Sets Spanish-Language Record

Every entry on Nielsen's Top 25 Live Sports Events Telecasts for the week of...

10/07/2026

BravesVision GM Jeff Cravens on Launching MLBs Newest Team-Owned Network in 35 Days

The Braves opted to keep production in-house rather than hand it off to MLB...

10/07/2026

PBR Teams Ready To Roll at CSU for Opening Weekend 2026

Drones, jibs, robos are part of the expanded camera complement for the Professional Bull Riders series PBR Teams' 2026 season, with a 10-team field competi...

10/07/2026

20 Years Later, We're All Still Part of the Little Miss Sunshine Family

(L-R) Michael Arndt, Paul Dano, Toni Collette, Valerie Faris, Abigail Breslin, Jonathan Dayton, and Greg Kinnear attend the Park City Legacy program screening o...

10/07/2026

AES Show Nashville: Early Bird registration opens

Discounted rates available through 27 August 2026 The Audio Engineering Society (AES) have announced that Early Bird registration is now open for the AES Sh...

10/07/2026

Sony introduce the IER-M500

New in-ear monitors to launch in August 2026 Sony have announced the upcoming launch of a new pair of in-ear monitors that promise to deliver a secure, stab...

10/07/2026

Apogee CRAS Symphony Mkii Upgrade Case Study

Why CRAS Upgraded to Symphony I/O MK II When an audio school runs studios all day, every day, gear doesn't just need to sound good , it needs to survive rea...

10/07/2026

FreeCast Cities To Stream Local TV, Premium Channels

Share Copy link Facebook X Linkedin Bluesky Email...

10/07/2026

Hey Man, Cheech & Chong's Last Movie Rolls With SNS EVO

Hey Man, Cheech & Chong's Last Movie Rolls With SNS EVO Melanie Ciotti July 10, 2026 0 Comments Richard Cheech Marin and Tommy Chong have long b...

10/07/2026

Alex Zarfati's Fail Safe Shot with Blackmagic PYXIS 12K

Alex Zarfati's Fail Safe Shot with Blackmagic PYXIS 12K Brie Clayton July 10, 2026 0 Comments Camera's full frame sensor supports anamorphic s...

10/07/2026

Dalet Flex LTS Delivers Smarter Media Operations from Ing...

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

10/07/2026

N.Y. State Broadcasters Association Selects Hall of Fame Class of 2026

Share Copy link Facebook X Linkedin Bluesky Email...

10/07/2026

Chyron's PRIME 5.4 Brings Template Experience to More Newsrooms

Share Copy link Facebook X Linkedin Bluesky Email...

10/07/2026

Registration Opens for 2026 NAB Show New York

Share Copy link Facebook X Linkedin Bluesky Email...

10/07/2026

IAB Releases Redefining Media Types' Standard for Public Comment

Share Copy link Facebook X Linkedin Bluesky Email...

10/07/2026

Wedotv FAST Channels Launch on TiVo Platforms in Europe

Share Copy link Facebook X Linkedin Bluesky Email...

10/07/2026

Sage Offers Guidance on EAS Password Changes

Share Copy link Facebook X Linkedin Bluesky Email...

10/07/2026

Media Organizations Are Data-Rich but Data-Fragmented - Is This You?

Data has always been central to media operations. Every ad that airs, every campaign that delivers, and every audience that's measured- all of it generates ...

10/07/2026

New RT documentary explores Irish-led efforts to build bridges

New RT documentary explores Irish-led efforts to build bridges in divided Cyprus More than a Game: From D1 to Pyla airs Monday 13 July More Than a Game: Fro...

09/07/2026

Omaha Productions Goes All-In as World Series of Poker Main Event Returns to ESPN

With 50+ cameras, three trucks, 60+ EVS channels, RFID hole-card workflows, and ...

09/07/2026

SVG Students To Watch: Dana Shearer, Syracuse University

A recent graduate from Westchester, NY, this experienced technician has already started her first gig in the industry, as a REMI A2 Comms Specialist at ESPN In...

09/07/2026

SVG New Sponsor Spotlight: Lightcasts Andreas Kisslinger on the Role of Automation, Cloud-Based Workflows in Streaming

Live sports production is a fast-paced industry with no signs of slowing down. W...

09/07/2026

TV Skyline, thinXpool, DMC Production Collaborate on Deutsche Telekom's World Cup From NYC

From a rooftop studio in Manhattan, multiple Germany-based companies share respo...

09/07/2026

FOX One and Overtime Announce Creator Series Race to Glory for FIFA World Cup 2026

Overtime has announced a content partnership with FOX One to produce Race to Glo...

09/07/2026

Ross Production Services Standardizes on Clear-Com Intercom Across Mobile Production Fleet

Clear-Com has announced that Ross Production Services (RPS) has standardized on ...

09/07/2026

NetApp Returns as Presenting Partner of 2026 NFL Madrid Game

The NFL has announced that NetApp will return as Presenting Partner of the NFL Madrid Game, featuring the Atlanta Falcons against the Cincinnati Bengals at the ...

09/07/2026

The R&A and Cisco Announce Multi-Year Network Infrastructure Partnership

The R&A and Cisco have announced a multi-year partnership making Cisco the Official Network Supplier of The R&A and its Championships. Cisco will deploy AI-read...

09/07/2026

Fox Television Stations, Extreme Reach, and LTN Complete Live Syndication of 25 Words or Less LIVE

Fox Television Stations, Extreme Reach (XR), and LTN have announced the completi...

09/07/2026

Wynn Records Launches Direct-to-Consumer Streaming Platform Powered by Kiswe

Kiswe has announced a partnership with Wynn Records to launch the Wynn Records Network streaming platform, debuting Saturday, July 11 with a Salita Promotions b...

09/07/2026

NEP Europe Announces Multi-Year Agreement as Wimbledon Broadcast Services Provider

NEP Europe has announced a new multi-year agreement with Wimbledon Broadcast Ser...

09/07/2026

Thropic Games Raises Pre-Seed Round Led by The Famous Group

Thropic Games, a company offering casual mobile games tied to fan fundraising for sports programs, has announced a pre-seed funding round led by The Famous Grou...

09/07/2026

Game Creek Video Purchases 10 Grass Valley K-Frame Switchers for Fleet Expansion

Game Creek Video has reached an agreement with Grass Valley to purchase 10 K-Frame production switchers as part of a two-year fleet expansion. Two systems have ...

09/07/2026

Gravity Media Powers ITVs FIFA World Cup Coverage with Three-Hub Remote Production

Gravity Media is delivering a three-hub remote production workflow for ITV's...

09/07/2026

Report: North American Broadcast Journalists Spend Up to 75% of Time on Technical Workflows

A new report from Quickplay and Caretta Research, The Broadcaster Revolution Wi...