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

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

04/07/2026

Detective Conan: Fallen Angel of the Highway Opens in Dolby Cinemas Across Japan, Presented in Dolby Atmos and Dolby ...

April 7 2026, 19:00 (PDT) Detective Conan: Fallen Angel of the Highway Opens in...

01/06/2026

Dolby Sets the New Standard for Premium Entertainment at CES 2026

January 6 2026, 05:30 (PST) Dolby Sets the New Standard for Premium Entertainment at CES 2026 Throughout the week, Dolby brings to life the latest innovatio...

02/05/2026

Dalet Flex LTS Delivers Smarter Search, Faster Editing, and an AI-Ready Foundation for Modern Media

Dalet, a leading technology and service provider for media-rich organizations, t...

01/05/2026

NBCUniversal's Peacock to Be First Streamer to Integrate Dolby's Full Suite of Premium Picture and Sound Innovations

January 5 2026, 18:30 (PST) NBCUniversal's Peacock to Be First Streamer to ...

15/04/2026

Winter Olympics, Super Bowl Power NBCU-Versant to Gold Medal Performance in Nielsen's February Gauge Reports

NBCU-Versant notches 13.1% of TV viewing in February, its best since August 2024...

15/04/2026

Nielsen CMI shows New Zealand's over-65s are a growing, cashed-up and still-working audience brands can't ignore

New data reveals older Kiwis are financially resilient, loyal to local products,...

15/04/2026

aconnic launches ACCEED 4430 10 Gigabit system for high volume enterprise and business service aggregation

aconnic AG (ISIN: DE000A0LBKW6), Munich, announces the market launch of the ACCE...

15/04/2026

Autocue to Mark 2026 NAB Show Debut of its New PTZ Prompter

Share Copy link Facebook X Linkedin Bluesky Email...

15/04/2026

Locality Deploys Nielsen's Media Data Engine

Share Copy link Facebook X Linkedin Bluesky Email...

15/04/2026

Viant Announces Agreement to Acquire TVision

Share Copy link Facebook X Linkedin Bluesky Email...

15/04/2026

Evergent introduces Agentic Revenue Orchestration Platfor...

Evergent introduces its Agentic Revenue Orchestration Platform, transforming how subscription businesses across direct-to-consumer streaming, pay-TV, telecommun...

15/04/2026

CentralCast Delivers Breakthrough Efficiencies to Public...

Harmonic's XOS Media Processor Delivers Exceptional Video Quality to More than Half of U.S. Public Media Viewership Harmonic (NASDAQ: HLIT) today announce...

15/04/2026

DPA N Series Wireless System Unlocks Duplex Gap and Guard...

LONGMONT, COLORADO, APRIL 15, 2026 DPA Microphones N Series Digital Wireless System users in North America can now take full advantage of the system's exc...

15/04/2026

Cobalt Iron Launches Compass Tape Gateway Modernizing IBM...

Cobalt Iron, a leading provider of SaaS-based enterprise data protection, today announced the launch of Compass Tape Gateway (CTG), a transformative enhancemen...

15/04/2026

Disguise to Showcase Cutting-Edge Experience Tech for Sports, Broadcast and More at NAB 2026

Disguise to Showcase Cutting-Edge Experience Tech for Sports, Broadcast and More...

15/04/2026

Arooj Aftab Makes the Music She Wants to Hear

Arooj Aftab Makes the Music She Wants to Hear The singular artist explores the juxtaposition of grief and joy, dark and light, in her distinctive sound. Apri...

15/04/2026

Panasonic, NEP Partner on IP-Based Live Production

Share Copy link Facebook X Linkedin Bluesky Email...

15/04/2026

Encompass Digital Media Powers Global Cloud Transformatio...

Interra Systems, a provider of end-to-end quality assurance solutions for the digital media industry, is proud to announce its central role in the digital trans...

15/04/2026

Viaccess-Orca Powers MasOranges Multi-Brand TV Expansion...

VO Integrates Client-Side and Server-Side Ad Technologies with its Secure Video Player and Segmentation Tools, Leveraging Broadpeak's SSAI and BPK SmartLib ...

15/04/2026

TMT Insights Unveils AI at NAB 2026

TMT Insights, a leader in professional services and software development for the media and entertainment (M&E) industry, today announced the launch of TMT AI at...

15/04/2026

Encompass Digital Media and Oracle Cloud Infrastructure E...

Encompass Digital Media, a global leader in managed broadcast and cloud-based media services, today announced an expanded partnership with Oracle Cloud Infrastr...

15/04/2026

Middleman Software Debuts PhaseLock Technology and Expand...

Middleman Software, a leading provider of signaling and synchronization solutions for broadcast and streaming workflows, today announced it will unveil PhaseLoc...

15/04/2026

Deity Announces PR-4 Compact Field Recorder

Deity Microphones today announced the PR-4, a compact six-track field recorder featuring four inputs, 32-bit float recording, advanced routing, and a workflow-f...

15/04/2026

Blackmagic Design Announces Fairlight Live

Blackmagic Design Announces Fairlight Live Brie Clayton April 15, 2026 0 Comments Powerful software-based live audio mixer with support for SMPTE-2110...

15/04/2026

Haivision Launches Falkon X4 5G Transmitters

Share Copy link Facebook X Linkedin Bluesky Email...

15/04/2026

JB&A Spotlights Exhibitors Ahead of Pre-NAB 2026 Technology Event

Share Copy link Facebook X Linkedin Bluesky Email...

15/04/2026

Wave Central, EVS Announce SMPTE ST 2110 Interop Collaboration

Share Copy link Facebook X Linkedin Bluesky Email...

15/04/2026

Top Reason for Subscribing to Pay TV Is Live News and TV, Survey Finds

Share Copy link Facebook X Linkedin Bluesky Email...

15/04/2026

NAB Leadership Foundation Honors Outstanding Broadcasters

Share Copy link Facebook X Linkedin Bluesky Email...

15/04/2026

Wisycom Expands MPR60 With New Multichannel IFB Mode

Share Copy link Facebook X Linkedin Bluesky Email...

15/04/2026

Thomas Riedel Acquires Premium Manufacturer ARRI

Strategic Alignment With the Riedel Group for Innovation and Growth Thomas Riedel, founder and owner of Riedel Communications and the Riedel Group, has acqui...

15/04/2026

Iyuno Deploys SDVI Rally Platform to Accelerate and Scale...

SDVI, the leading platform provider for cloud-native media supply chains, today announced that the company's Rally platform has been deployed by Iyuno Media...

15/04/2026

Frequency Leads the Industry in Live Local News on FAST

Frequency, the engine behind many of the worlds leading streaming television channels, has become the platform of choice for leading U.S. broadcasters bringing ...

15/04/2026

Harmonic Introduces Breakthrough AI Orchestration Service...

New Service Simplifies Integration of AI Applications with Exceptional Reliability and Security SAN JOSE, Calif. April 14, 2026 Harmonic (NASDAQ: HLIT) t...

15/04/2026

VIDI and Media Links Bring Scalable IP Transport to Germa...

During the 2025 off-season, VIDI completed a major upgrade of the broadcast infrastructure across all 36 stadiums in Germany's 1st and 2nd Bundesliga. The p...

15/04/2026

Clear-Com Introduces Transformational Arcadia and Eclipse...

Clear-Com announced significant updates to its award-winning Arcadia Central Station as well as enhancements to the Eclipse HX Digital Matrix System now runn...

15/04/2026

Shotoku Introduces the World to Aura P2 PTZ Prompter Panner at NAB SHOW 2026

Shotoku Introduces the World to Aura P2 PTZ Prompter Panner at NAB SHOW 2026 Brie Clayton April 15, 2026 0 Comments New system removes PTZ pan restric...

15/04/2026

LiveU Announces Expanded Collaboration with Sony at NAB Show, Adding Direct File Workflow Integration

LiveU Announces Expanded Collaboration with Sony at NAB Show, Adding Direct File...

15/04/2026

This 24-Hour Performance Art Piece Needs Your Participation

This 24-Hour Performance Art Piece Needs Your Participation Keefer Glenshaws latest project is about collaborating with the Berklee community and beyond. Apr...

15/04/2026

Five Decades of Box Office Intelligence: Comscore Celebrates 50 Years of Movie Measurement

Five Decades of Box Office Intelligence: Comscore Celebrates 50 Years of Movie M...

15/04/2026

Rethinking AI TCO: Why Cost per Token Is the Only Metric That Matters

Traditional data centers only stored, retrieved and processed data. In the generative and agentic AI era, these facilities have evolved into AI token factories....

15/04/2026

RT announces new crime drama The Yank starring Kate Mulgrew and Colm Meaney

Two Cities Television and Keeper Pictures to produce six-part series in association with Screen Ireland for RT and ITV Studios RT has commissioned Two Citie...

15/04/2026

RT unveils The Signal' a specially commissioned 60-second film to celebrate RT100

RT 100 RT unveils The Signal' a specially commissioned 60-second film ...

15/04/2026

New Adobe Premiere Color Grading Mode Accelerated on NVIDIA GPUs

The NAB Show 2026 trade show, running April 18-22 in Las Vegas, is set to showcase a wave of new features and optimizations for top video editing applications. ...

14/04/2026

ToolsOnAir and Omnistream Bring Mobile SRT Contribution into Professional 24/7 Playout and Live News Workflows

ToolsOnAir and Omnistream Bring Mobile SRT Contribution into Professional 24/7 P...

14/04/2026

NAB 2026: Haivision Launches Falkon X4 5G Mobile Video Transmitter

Haivision has announced the Falkon X4, a 5G mobile video transmitter for live broadcast and remote production. The device will be showcased at NAB Show 2026. ...

14/04/2026

SVG New Sponsor Spotlight: Stripe TVs Matthew Pavey on Making Live-Production Tech More Portable, Intuitive, and Accessible

Founded by veterans of the production-truck world, Stripe TV was born out of a d...

14/04/2026

Studio Berlin Adds LDX 135 and LDX 180 Camera Systems from Grass Valley

Grass Valley has expanded its partnership with Studio Berlin, supplying 12 LDX 135 UHD/HDR camera systems and 12 LDX 180 Super 35mm cinematic cameras, including...