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

08/09/2026

Comcast Technology Solutions Signs Multi-Year VOD Distribution Agreement with A+E Global Media

Comcast Technology Solutions (CTS) has announced a multi-year agreement with A E...

08/09/2026

Spectra Logic Introduces Media Insight for Faster Discovery, Preview, and Retrieval of Archived Media

Spectra Logic today announced the availability of Media Insight, a new capabilit...

08/09/2026

Rogers and Quebecor Announce 12-Year French-Language NHL Sublicensing Deal

Rogers Communications and Quebecor have announced a 12-year sublicensing agreement for French-language national NHL games beginning with the 2026-27 season. TVA...

08/09/2026

IBC 2026: Skyline Communications and Bridge Technologies to Demonstrate Automated Broadcast Workflows

Skyline Communications and Bridge Technologies will demonstrate two integrations...

08/09/2026

IBC 2026: Boland Communications Makes European Debut of 4K55HDR7SNB

Boland Communications will make the European debut of its 4K55HDR7SNB 55-inch super-narrow-bezel monitor at IBC2026 (Stand 12.C57, RAI Amsterdam, September 11-1...

08/09/2026

Ateme and Comcast Technology Solutions Announce Collaboration for Live Video Delivery

Ateme and Comcast Technology Solutions (CTS) have announced a collaboration comb...

08/09/2026

IBC 2026: Haivision Joins IBC Accelerator Programme on 5G Network Control for Live Production

Haivision has joined the IBC Accelerator Media Innovation Programme as part of t...

08/09/2026

Blackmagic Design Cuts Prices on PYXIS 6K and Cinema Camera 6K

Blackmagic Design has announced price reductions on its PYXIS 6K and Cinema Camera 6K models, effective immediately through Blackmagic Design resellers worldwid...

08/09/2026

IBC 2026: AI-Media to Showcase Multilingual AI Captioning and Translation Platform

AI-Media will demonstrate its LEXI Suite at IBC2026 (Booth 5.C34, September 11-1...

08/09/2026

Bitmovin and Ad Insertion Platform Deploy SGAI Solution for Belgian Broadcaster RTBF

Bitmovin and Ad Insertion Platform (AIP) have announced the first live deploymen...

08/09/2026

IBC 2026: Grass Valley to Demonstrate Story-Centric Newsroom Workflows

Grass Valley will demonstrate story-centric media workflows at IBC2026 (Booth 9.A01, RAI Amsterdam, September 11-14), connecting newsroom production, content ma...

08/09/2026

M2A Media and Ateme Partner to Scale Live Sports Video Delivery

M2A Media and Ateme have announced a partnership integrating Ateme's video processing solutions into M2A Media's MediaToAnywhere platform for live sport...

08/09/2026

IBC 2026: Ikegami to Introduce New UNICAM XE Cameras and Viewfinders

Ikegami will exhibit at IBC2026 (Stand 12.A31, RAI Amsterdam, September 11-14), including a Day 1 introduction of new cameras in the UNICAM XE series. Additiona...

08/09/2026

Caretta Research Shares Top Trends to Watch at IBC 2026

Broadcast industry analysts will be gathering plenty of insights at the 2026 IBC Show this weekend in Amsterdam, but Caretta Research has offered up some though...

08/09/2026

SENSHI and DAZN Announce Global Broadcast Partnership

SENSHI and DAZN have announced a global broadcast partnership that will bring SENSHI's live events free to viewers in more than 200 markets. The partnership...

08/09/2026

ESPN, ESPN2 Begin 4K HDR Rollout in the U.S. with New IP-Based Distribution Pipeline

New architecture built with Evertz will bring 4K HDR to Monday Night Football, N...

08/09/2026

Sauceware Audio release Scorch 2

Built for rap producers, by rap producers Sauceware Audio, the independent plug-in company founded by Grammy-nominated producer Jacob (Travis Scott, 21 Sava...

08/09/2026

Warm Audio unveil the Jude preamps

Classic Sound Techniques design revived Warm Audio's latest release delivers a meticulous recreation of the preamp circuitry employed by the Sound Techn...

08/09/2026

XILS Lab introduce MemoryTone

Latest soft synth inspired by the Memorymoog XILS Lab have just launched a software instrument that draws its inspiration from Moog's iconic Memorymoog,...

08/09/2026

The Airport Chaplain takes off as SBS's biggest launch of 2026

The Airport Chaplain takes off as SBS's biggest launch of 2026 8 September, 2026 Media releases 1.67 million viewers on National Total TV to date Best...

08/09/2026

IBC2026: Haivision Integrates Chyron LIVE into its Workflow

Share Copy link Facebook X Linkedin Bluesky Email...

08/09/2026

Mo-Sys completes reorganisation strengthens management te...

Mo-Sys, the world-leading developer of virtual production, camera robotics and image tracking technology, has completed a business restructuring, which has incl...

08/09/2026

Aicox and TAG Video Systems power monitoring and multivie...

New York, September 8, 2026 The TSAmediaHUB audiovisual contribution and distribution infrastructure developed by Telef nica's Audiovisual Services area re...

08/09/2026

Asharq migrates extended channel line-up to Pebble playou...

Expanded Riyadh operation brings Asharq and Thmanyah services together on a resilient on-premises Pebble platform. Pebble, the leading automation, content mana...

08/09/2026

Techex Extends its Lead in Software Defined Live Video at...

Techex, a pioneering leader in live video workflows, will showcase its broadest software feature set to date at IBC 2026 (Stand 2.B45), extending its lead in so...

08/09/2026

Grass Valley Advances Story-Centric Media Workflows for U...

Visitors to Grass Valley's booth at IBC2026 will be introduced to new Framelight X capabilities that connect content acquisition, management, editing and pu...

08/09/2026

BCNEXXT Showcases Latest Vipe Innovations at IBC2026 Rais...

BCNEXXT will showcase the latest evolution of Vipe at IBC2026 (Stand 2.B09), introducing a series of innovations designed to deliver higher-quality audience exp...

08/09/2026

Bitmovin and Ad Insertion Platform Power First Active Dep...

Bitmovin, a provider of video streaming solutions, has partnered with Ad Insertion Platform (AIP), a leading innovator in advanced ad insertion technologies, to...

08/09/2026

Brainstorm unveils major enhancements to its Suite 7 envi...

Brainstorm, a leading manufacturer of real-time graphics and augmented and virtual production, is announcing a major package of enhancements to its Suite 7 soft...

08/09/2026

Big Blue Marble Collaborates with TDF as Technology Partn...

Big Blue Marble is supporting TDF, French infrastructure and network operator, broadcasting Digital Terrestrial Television (DTT) and radio services, as a techno...

08/09/2026

nxtedition takes agentic AI from newswire to gallery at I...

Agents work inside a single production environment, from incoming wire copy to a live studio show...

08/09/2026

Ceeblue and Layercake Expand Strategic Integration to Lau...

Building on their strategic partnership, Ceeblue and Layercake make the unthinkable possible: scalable sub-second streaming over standard DRM, SSAI, and CDN wor...

08/09/2026

Brainstorm launches Engram a dedicated asset management t...

Brainstorm, a leading manufacturer of real-time graphics, augmented and virtual production, is completing the environment for fast-paced broadcast production wi...

08/09/2026

IBC 2026 - The new Synamedia - solving the business of vi...

A SaaS portfolio built to work together, helping operators grow audiences, monetise smarter and run leaner, on their own terms At IBC 2026 (stand 1.B49) Synam...

08/09/2026

Accedo Selected by PlayOn Sports to Enhance NFHS Network...

Accedo, global provider of video streaming software and services, has been selected by PlayOn Sports, a national leader in high school sports technology, to exp...

08/09/2026

AP brings new connectivity and workflow tech to global ne...

LiveU, the leader in live IP-video solutions, is enabling The Associated Press to take global newsgathering to the next stage with intelligent connectivity and ...

08/09/2026

Mediagenix Personalization Curates Sports Content Around...

Mediagenix, a global leader in smart content solutions to profitably connect the right content to the right audience, today announced the latest evolution of it...

08/09/2026

Appear X5 to enable flyaway contribution for DP World Tou...

Compact, power-efficient X Platform performance brings broadcast-grade reliability and ultra-low latency to space-constrained remote production (REMI) workflows...

08/09/2026

Zixi and Kiloview Partner to Deliver Broadcast-Grade IP V...

Zixi, the leader in live video delivery and workflow orchestration, and Kiloview, a leading provider of professional IP video encoding and decoding solutions, t...

08/09/2026

Quortex and NetActuate announce global agreement

Collaboration gives content owners scalable CDN capacity and broadcasters enhanced flexibility, including for C-band transition planning Quortex today announce...

08/09/2026

Orlando Magic, Gray Media Ink Full-Season Broadcast Deal

Share Copy link Facebook X Linkedin Bluesky Email...

08/09/2026

Telos Alliance and Pluxbox Announce Dynamic Media Facility Integration Partnership

Telos Alliance and Pluxbox Announce Dynamic Media Facility Integration Partnersh...

08/09/2026

Jnger Audio Showcases Industry-First S-ADM Cloud Workflow at IBC 2026

J nger Audio Showcases Industry-First S-ADM Cloud Workflow at IBC 2026 Search Dolby, MainConcept, Techex and J nger Audio will showcase the industry's ...

08/09/2026

Sky Go gets a major upgrade for Sky Glass and Sky Stream customers

Tuesday 8 September 2026 Sky Go gets a major upgrade for Sky Glass and Sky Stream customers Today, Sky launches a new version of the Sky Go app for Sky Glass ...

08/09/2026

Trailer released for The Wargame, launching on Sky from 21 September

Documentary thriller simulating a Russian attack on UK soil will culminate in a live final episode reuniting the playersTuesday 8 September 2026 Trailer releas...

08/09/2026

Riedel Introduces New OnAir Headset Platform

Wuppertal September 8, 2026 Riedel Introduces New OnAir Headset PlatformRiedel Communications today announced the launch of its new OnAir headset platform, a...