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

02/09/2026

SVG Venues & Teams Summit 2026: All Sessions Now Available To Watch on SVG PLAY

Professional and collegiate clubs, leading vendors discuss current trends in stadium production On. Aug. 12, the 2026 SVG Venues & Teams Summit explored the ev...

02/09/2026

SoFi Stadium Completes Broadcast Infrastructure Upgrade

SoFi Stadium, YouTube Theater, and Hollywood Park have completed an infrastructure upgrade expanding game presentation and broadcast production capabilities acr...

02/09/2026

IBC 2026: Comcast Technology Solutions Unveils AI-Powered Workflow Applications

Comcast Technology Solutions (CTS) has announced a suite of AI-powered workflow applications for broadcasters, content owners, and operators, built on its Video...

02/09/2026

NABA and APWPT Announce Partnership on Wireless Spectrum Advocacy

The North American Broadcasters Association (NABA) and the Association of Professional Wireless Production Technologies (APWPT) have announced a partnership to ...

02/09/2026

Prime Video Lands Exclusive In-Market Streaming Rights for Six NHL Teams Beginning This Season

Carolina Hurricanes, Anaheim Ducks, Columbus Blue Jackets, Dallas Stars, Minneso...

02/09/2026

Mercedes-Benz Stadium Goes Mini: Nine-Year-Old Venue Continues to Innovate With Control Room Mini Halo Board

New LED provides enhanced quality control, quicker show prep, detailed productio...

02/09/2026

Keeley Electronics launch the Tube Drive

Combines the Phat Drive with high-voltage valve circuit The latest pedal from Keeley Electronics combines their popular Phat Mode drive pedal with an all-ne...

02/09/2026

Lewitt introduce Space Replicator Free

Free version of virtual mixing room plug-in introduced Lewitt's Space Replicator plug-in provides users with a virtual monitoring environment that aims ...

02/09/2026

Stereophonic Bundle from AIR Music Tech

Two new mixing & mastering plug-ins revealed AIR Music Tech have just introduced the Stereophonic Bundle, a pair of processing plug-ins designed to provide ...

02/09/2026

Rohde & Schwarz has achieved initial verification of 3GPP Rel. 17 power-saving feature SSSG for 5G NR

Rohde & Schwarz has achieved initial verification of 3GPP Rel. 17 power-saving f...

02/09/2026

AgileTV and Fiend MTS Complete CDN Watermarking Integration to Fast-Track Anti-Piracy Protection for Operators

Bilbao - 3rd September 2026 -AgileTV, a leading provider of end-to-end TV and vi...

02/09/2026

Agentic AI in the content supply chain

Why agentic media supply chains need experience design built around visibility, reversibility and human authority When AI can generate a functional interface ...

02/09/2026

Gracenote study: 85% of sports fans want TV home screens to show when and where to watch favorite teams

Six-country survey finds 26% of sports fans frequently unable to determine where...

02/09/2026

Manfrotto Showcases New Video Support Solutions at IBC 2026

Share Copy link Facebook X Linkedin Bluesky Email...

02/09/2026

Mediagenix Rebrands Spideo as Mediagenix Curation

Share Copy link Facebook X Linkedin Bluesky Email...

02/09/2026

Creative Technology Group Founder Graham Andrews Sets Year-End Exit

Share Copy link Facebook X Linkedin Bluesky Email...

02/09/2026

San Antonio Spurs, DAZN Ink Exclusive Streaming Deal

Share Copy link Facebook X Linkedin Bluesky Email...

02/09/2026

DPA Launches 6388 CORE Headset Microphone With Shifted Ac...

KOKKEDAL, DENMARK, SEPTEMBER 1, 2026 DPA Microphones announces its new 6388 CORE Headset Microphone, a high-performance directional headset designed for dema...

02/09/2026

Pliant Technologies Spotlights CrewCom CXD 32CF Dante AES...

Pliant Technologies will highlight its CrewCom CXD 32CF 32x32 Dante /AES67 Digital Audio Network Interface, a powerful connectivity solution designed to expand ...

02/09/2026

iWedia Enhances Teatro Pulse with Edge AI Self-Healing an...

iWedia, a leading provider of software solutions for connected TV devices, today announced two enhancements to Teatro Pulse, its end-to-end TV service operation...

02/09/2026

Signiant Accelerates More Than File Transfers at IBC2026

Signiant, trusted by the media industry for accelerated content movement for more than 20 years, will showcase the latest evolution of the Signiant Platform at ...

02/09/2026

Calrec Argo M Powers Cloudbass Next Generation OB Fleet

With a contractual agreement to supply a leading UK sports broadcaster with outside broadcast services for 104 football matches per season over the next four ye...

02/09/2026

IBC2026 puts sport at the winning end of media innovation

IBC2026 will put sport firmly at the centre of the global media and entertainment technology conversation with the strongest sports showing in the event's h...

02/09/2026

PTZOptics Demonstrates the Power of Intelligent Multicame...

PTZOptics will bring a hands-on showcase of intelligent video production to IBC2026 (11-14 September, RAI Amsterdam), with demonstrations spanning new camera te...

02/09/2026

OOONA Launches OOONA Go

OOONA, a global provider of professional management and production tools for the media localization industry, today announced the launch of OOONA Go, a ready-to...

02/09/2026

EON Media launches AI media activation and monetization s...

EON Media will make its European debut at IBC2026 (September 11-14, RAI Amsterdam) in the show's Future Tech Zone (Hall 14.FT5). The company is launching it...

02/09/2026

Frequency Defines the Intelligent Channel at IBC2026

Frequency, the engine behind many of the worlds leading streaming television channels, will demonstrate at IBC2026 how integrating intelligence throughout chann...

02/09/2026

FOR-A Introduces Go Vertical AiDi and AiDi Sports Hub Und...

On-device AI platform gives broadcasters and content creators purpose-built tools for real-time vertical video production and AI-enhanced sports coverage...

02/09/2026

Shotoku To Introduce Aura E2 PTZ Elevator At IBC2026

Share Copy link Facebook X Linkedin Bluesky Email...

02/09/2026

AJA to Launch New openGear SDI/Fiber Conversion Cards at IBC2026

Share Copy link Facebook X Linkedin Bluesky Email...

02/09/2026

GoPro to Merge with Starman Optical

Share Copy link Facebook X Linkedin Bluesky Email...

02/09/2026

AIMS, EBU Completes Latest IPMX Certification Testing

Share Copy link Facebook X Linkedin Bluesky Email...

02/09/2026

EVS To Showcase New Neuron 4X Processor At IBC 2026

Share Copy link Facebook X Linkedin Bluesky Email...

02/09/2026

Sony Launches 100+ FAST Channels on Playstation 5 in the U.S.

Share Copy link Facebook X Linkedin Bluesky Email...

02/09/2026

Canon Unveils PTZ Camera Firmware Updates

Share Copy link Facebook X Linkedin Bluesky Email...

02/09/2026

EverPass Media Expands NFL Offering with Netflix Deal

Share Copy link Facebook X Linkedin Bluesky Email...

02/09/2026

Imagine Communications Unveils Latest Control Portfolio A...

Next-Generation Freeform Control Surfaces Lay the Foundation for AI-Enabled Media Operations At IBC2026 (Sept. 11 14, RAI Amsterdam, Stand #1.B73), Imagine Com...

02/09/2026

Friedrichstadt-Palast Relies on Riedel for IP-Centered Pr...

Friedrichstadt-Palast in Berlin, the world's largest theater stage, has modernized its backstage production infrastructure with a comprehensive Riedel solut...

02/09/2026

WiM to Host Reel Forward Production Conference at CSU Los...

Women in Media announces that it will host the two-day Reel/Forward in-person conference devoted to navigating today's production scene. Guests can enjoy pa...

02/09/2026

Teradek and New Media AV Expand Partnership with Full Liv...

The expanded partnership brings Teradek's Live Production solutions to New Media AV's European dealer and integrator network, opening new opportunities ...

02/09/2026

QuickLink Expands StudioEdge With WhatsApp Cisco Webex an...

QuickLink, a leading provider of award-winning video production and remote guest contribution solutions, announces a major expansion to its award winning Studio...

02/09/2026

Vipe by BCNEXXT Gives Foxtel a New Playout Model for its...

BCNEXXT, the developers of the advanced playout platform Vipe, today announced that premium entertainment brand Foxtel has selected Vipe to underpin playout for...

02/09/2026

HOT Telecommunications supercharges localisation efficien...

SubtitleNEXT helps HOT Telecom's subtitling team keep a cool head with reliable QC capabilities Profuz Digital, global developer of digital media and local...

02/09/2026

Case Study - Mission Digital Strengthens Battery Safety w...

Case Study: Mission Digital Strengthens Battery Safety with Safe-ion As productions become increasingly dependent on battery-powered equipment, the safe storag...

02/09/2026

New design strategy expands nanoparticle vaccine approach to influenza viruses

LA JOLLA, CA-Influenza viruses constantly shapeshift to evade recognition by the immune system. This shapeshifting occurs in critical proteins like hemagglutini...

02/09/2026

New AI algorithm could improve detection and prediction of heart diseases

LA JOLLA, CA-Clinicians often use a medical test called a 12-lead electrocardiogram (ECG) to diagnose heart problems, which uses electrodes placed on the chest ...

02/09/2026

Where milliseconds matter: Scripps Research scientists build new ML model to predict protein movements essential for biological function

LA JOLLA, CA-Proteins may look like rigid molecular structures, but inside our c...