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

09/10/2026

Dolby Expands Dolby OptiView Platform with New Capabilities at IBC 2026

September 10 2026, 06:00 (PDT) Dolby Expands Dolby OptiView Platform with New Capabilities at IBC 2026 New Sports Intelligence helps providers better unders...

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

11/09/2026

Sony To Showcase Latest Production Technology At IBC2026

Share Copy link Facebook X Linkedin Bluesky Email...

11/09/2026

EKT To Feature New Linux-Based ATSC 3.0 STB At IBC2026

Share Copy link Facebook X Linkedin Bluesky Email...

11/09/2026

Jimmy Kimmel Shifts Political Interview to YouTube Over FCC Worries

Share Copy link Facebook X Linkedin Bluesky Email...

11/09/2026

Remembering 9/11: 25 Years of TV Tech Coverage

Share Copy link Facebook X Linkedin Bluesky Email...

11/09/2026

Tiger Group To Auction Equipment from a National Broadcasting Studio

Share Copy link Facebook X Linkedin Bluesky Email...

11/09/2026

Grass Valley Launches AVORA at IBC2026

Share Copy link Facebook X Linkedin Bluesky Email...

11/09/2026

Survey: Low Latency for Live Streaming Is Industrys Top Challenge

Share Copy link Facebook X Linkedin Bluesky Email...

11/09/2026

Atomos Debuts New HDR Monitors at 2026 IBC Show

Share Copy link Facebook X Linkedin Bluesky Email...

11/09/2026

Grass Valley Launches AVORA at IBC2026 Bringing All in On...

New standalone solution gives production teams everything they need to create, produce and deliver live content from one flexible system. Grass Valley today an...

11/09/2026

Wave Central a Domo Broadcast Company Named Recipient of...

Recognition honors the development of FPV drone camera systems for live sports broadcast coverage Wave Central, a Domo Broadcast Company that develops advanced...

11/09/2026

Teradek Launches Bolt 7 A Unified Wireless System for Zer...

Teradek, the industry leader in zero-delay wireless video solutions, announced the launch of Bolt 7, which now includes a unified wireless video and data system...

11/09/2026

ACT Pixel Academy Announces Autumn Courses

The ACT Entertainment tvONE and Green Hippo Pixel Academy has released its autumn course schedule, with hands-on training dates in September, October and Novemb...

11/09/2026

Scientists discover a new way that a disease-linked protein comes apart

LA JOLLA, CA-Transthyretin amyloid disease (ATTR) is a progressive, life-threatening condition caused when the protein transthyretin (TTR) breaks apart and aggr...

11/09/2026

Major Update to Blackmagic Cloud

Major Update to Blackmagic Cloud Brie Clayton September 10, 2026 0 Comments Blackmagic Design has announced a major update to Blackmagic Cloud which a...

11/09/2026

Dalet Helps Media Organizations Navigate the Rise of Synthetic Content with NVIDIA AI

Dalet Helps Media Organizations Navigate the Rise of Synthetic Content with NVID...

10/09/2026

First AI-Generated Golf Announcer To Debut During New Mexico Open

Duff Foreman is an AI-generated announcer who will add color to this month's New Mexico Open...

10/09/2026

IBC 2026: Bitmovin Rolls Out Encoder Version 3

Bitmovin is rolling out Encoder Version 3, the next major release of the technology behind its VOD and Live Encoders. Version 3 is built on a premise every stre...

10/09/2026

IBC 2026: Net Insight Highlights Open Live Media for Controlled Live Services

At IBC2026, on booth 1.B47, Net Insight will showcase Open Live Media, its architecture for delivering resilient live media services across networks, partners, ...

10/09/2026

PWHL, Scripps Sports Sign National Television Deal for 2026-27 Season

The Professional Women's Hockey League (PWHL) and Scripps Sports have announced a national broadcast rights agreement for the 2026-27 season, a landmark par...

10/09/2026

IBC 2026: Trusted Partner Network Debuts Fix It or Risk It to Tackle Everyday Security Risks

The Trusted Partner Network (TPN), the global content security initiative powere...

10/09/2026

NFL Brings Back Creator Programs to Deliver Access, Original Storytelling During the 2026 Season

The NFL is launching its most expansive creator programming yet, bringing togeth...

10/09/2026

Sportsnet Removes 150 Blackouts for More National NHL Games Than Ever in 2026-2027 Season

Sportsnet is set to deliver its biggest hockey season ever with a national sched...

10/09/2026

IBC 2026: LiveU Showcases Starlink for News and Sports Broadcast as Clarus Integrated Reseller

LiveU is now a Clarus Integrated Reseller, bringing Starlink's fast, reliabl...

10/09/2026

IBC 2026: Mimir Develops Single Layer for Content, Metadata, AI Orchestration

Mimir is the cloud-native media production platform built for teams that need to move media fast across live, archive, web, social, and broadcast workflows. At ...

10/09/2026

IBC 2026: ATSC 3.0 To Receive Technology & Engineering Emmy Award for Significant Advancement in Television Broadcasting

ATSC is being honored with a 2026 Technology & Engineering Emmy Award by the Nat...

10/09/2026

Audio-Technica Presents BP880R Contact Transducer for Immersive Sports Broadcast, Production Audio Enhancement

Audio-Technica has introduced the BP880R Contact Transducer, a specialized micro...

10/09/2026

ESPN, ION Team Up to Broadcast WTGL Starting on Nov. 8

TMRW Sports in partnership with the LPGA, today announced multiyear U.S. media rights agreements with ESPN and Scripps Sports/ION to bring WTGL, the new women&#...

10/09/2026

SportsNet Pittsburgh Honors Roberto Clemente Day With Second-Annual Live Spanish-Language Pirates Telecast

SportsNet Pittsburgh (SNP) in partnership with Major League Baseball and the Pit...

10/09/2026

Tennis Channel Gives Fans Options With Premium Subscription on Roku

Tennis Channel announced today its launch as a Premium Subscription on The Roku Channel. Tennis Channel offers viewers a single home for Tennis Channel and Ten...

10/09/2026

IBC 2026: Dolby Expands Dolby OptiView Platform With New Capabilities

Dolby has announced major updates to Dolby OptiView, its live sports platform, ahead of IBC 2026. The updates include new AI-powered intelligence to better unde...

10/09/2026

Dalet Names Brian Doheny as CEO

Dalet has appointed Brian Doheny as CEO. Doheny joined Dalet as President and Chief Revenue Officer in April 2026. Since joining Dalet, Doheny has led the compa...

10/09/2026

IBC 2026: Sony Demonstrates Various Creative Solutions for Attendees at the RAI

Sony, as well as its partner company Nevion, is starting IBC 2026 with a handful of announcements for attendees to see on the show floor. Sony Announces the 4t...

10/09/2026

SoFi Stadium Solidifies Production Output With Multi-Layered Tech Renovation

The six-year-old venue is expanding capabilities for NFL action, Super Bowl LXI, 2028 Summer Olympics SoFi Stadium, as well as the surrounding area known as Ho...

10/09/2026

Acon Digital introduce Acoustica 8

Editing, restoration & mastering suite upgraded Acon Digital Acoustica 8 audio editing restoration mastering software. Acon Digital have just launched the la...

10/09/2026

Readipop & XOX open XOX Studio

Classic synths & drum machines available to play Based in Reading, UK, Readipop are a music and arts charity with a long track record of innovative, partici...

10/09/2026

Neumann launch the KH 310 II & KH 350

Popular model updated & new addition introduced With many of the models in Neumann's KH family now boasting onboard DSP and support for the company'...

10/09/2026

Arturia launch the AudioFuse Studio Rev2

Improved desktop interface announced The latest iteration of Arturia's flagship desktop audio interface has just arrived, introducing improved preamps, ...

10/09/2026

Progress needs proof: Rohde & Schwarz showcases its trailblazing test solutions at EuMW 2026 in London

Progress needs proof: Rohde & Schwarz showcases its trailblazing test solutions ...

10/09/2026

Nielsen launches CTV ad spend data into its French Ad Intel product

France launch follows UK and Germany as Nielsen expands product across EMEA Paris, France, September 10, 2026 - Nielsen, a global leader in audience measuremen...

10/09/2026

Fabric Data, TMT Insights Merge to Create Fabric Insights

Share Copy link Facebook X Linkedin Bluesky Email...

10/09/2026

Leading Audio Manufacturers Join Forces on Dialog Intelli...

Leading professional audio manufacturers NUGEN Audio, RTW, Steinberg and Telos Alliance have joined forces with Fraunhofer IDMT to establish a common approach t...

10/09/2026

Setplex Introduces AI Insider for Faster Smarter Video Se...

Built Into Setplex's Zapflex Platform, AI Insider Turns Video Service Data Into Actionable Insights Setplex today introduced AI Insider, a breakthrough new...

10/09/2026

sync labs to Introduce sync productions at IBC2026 Bringi...

Managed service changes dialogue without actor-specific training or facial rigging while preserving the original performance and fitting established post-produc...

10/09/2026

ACT Pixel Academy Autumn Courses PR

The ACT Entertainment tvONE and Green Hippo Pixel Academy has released its autumn course schedule, with hands-on training dates in September, October and Novemb...

10/09/2026

Orange Polska Reaffirms Its Trust in Viaccess-Orca with M...

Orange Polska continues to Rely on Viaccess-Orca for Secure TV Services and the Next Phase of its Technology Evolution Viaccess-Orca (VO), a global leader in T...

10/09/2026

Generate and create directly in your timeline with new AI-powered innovations in Premiere and After Effects

Generate and create directly in your timeline with new AI-powered innovations in...

10/09/2026

Tedial to introduce Media Business Hub at IBC 2026

Tedial is introducing Media Business Hub (MBH) at IBC 2026, a new business enablement platform designed to help media organizations unlock the full value of the...