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

10/09/2026

Study: NFL Ad Revenue to Hit a Record $6.3 Billion

Share Copy link Facebook X Linkedin Bluesky Email...

10/09/2026

Teradek Unveils Bolt 7 With 900MHz RF Pipeline

Share Copy link Facebook X Linkedin Bluesky Email...

10/09/2026

Survey: Roku Remains Most Popular Streamer

Share Copy link Facebook X Linkedin Bluesky Email...

10/09/2026

Sony Unveils Fourth Generation Of DWX Wireless Mics

Share Copy link Facebook X Linkedin Bluesky Email...

10/09/2026

Scripps Revamps Local Media Regional Leadership Structure

Share Copy link Facebook X Linkedin Bluesky Email...

09/09/2026

IBC 2026: Sony Introduces SEL814G Fisheye Zoom G Lens

Sony Electronics has announced the SEL814G, the company's first fisheye zoom G Lens for full-frame Alpha E-mount cameras. The lens will be available in Octo...

09/09/2026

IBC 2026: Telestream Expands Practical AI Capabilities Across Vantage and UP Platform

Telestream has announced an expansion of its Practical AI capabilities across th...

09/09/2026

IBC 2026: Chyron and Haivision Announce Camera-to-Cloud Live Production Integration

Haivision and Chyron have announced a technology partnership integrating Haivisi...

09/09/2026

ManningCast Reveals 2026-27 Season Schedule with Heist Mini Movie

Omaha Productions has released ManningCast: Heist, a short film featuring Peyton and Eli Manning attempting to break into NFL Commissioner Roger Goodell's o...

09/09/2026

IBC 2026: Imagine Communications to Showcase XVR Updates

Imagine Communications will demonstrate the next evolution of XVR at IBC2026 (Stand 1.B73, RAI Amsterdam, September 11-14). XVR is Imagine's channel-in-a-b...

09/09/2026

IBC 2026: swXtch.io Launches AI Broadcast Orchestration Tool abbe

swXtch.io has announced abbe, an AI-based orchestration layer for live media workflows, making its world premiere at IBC2026 (Meeting Room 5.MR13, Hall 5, Septe...

09/09/2026

Inside the NFL Returns to X for Second Season, Marking 50th Anniversary

NFL Films has announced the second season of Inside the NFL on X as an X Original, premiering Wednesday, September 9. The series marks Inside the NFL's 50th...

09/09/2026

LiveU Expands AP Partnership with LU900Q Fleet and MAM Integration

LiveU has announced an expanded partnership with The Associated Press, deploying the largest fleet of LU900Q intelligent production units in the industry as par...

09/09/2026

Diversified to Consolidate New Jersey Operations into New Newark Facility

Diversified has announced plans to consolidate its four existing New Jersey locations into a new facility in Newark, expected to be fully operational by the end...

09/09/2026

IBC 2026: Wisycom Showcases MATF Antenna Matrix, PFL RFoF Box, and MPR60 Updates

Wisycom will exhibit new RF products at IBC2026 (Stand 8.D60, September 11-14), including the MATF Wideband Antenna Matrix, PFL Portable RF over Fiber Box, and ...

09/09/2026

IBC 2026: G&D and VuWall to Introduce vsNEO KVM-over-IP Platform

Guntermann & Drunck (G&D) and VuWall, both Panoptec companies, will introduce vsNEO at IBC2026 (Stand 8.B63, September 11, RAI Amsterdam). Pre-orders open in ea...

09/09/2026

Mo-Sys Completes Restructuring, Promotes Selin Kemal to Managing Director

Mo-Sys has completed a business restructuring and relocated to a new facility in Canada Water, London. As part of the reorganization, Selin Kemal has been promo...

09/09/2026

Aicox and TAG Video Systems Power Monitoring for Telefnicas TSAmediaHUB

Aicox has integrated TAG Video Systems' Core monitoring platform into Telef nica's TSAmediaHUB audiovisual contribution and distribution infrastructure....

09/09/2026

IBC 2026: Blackmagic Design Releases DaVinci Resolve 21.1

Blackmagic Design has released DaVinci Resolve 21.1, a free update available now through the Blackmagic Design website. The release adds new AI tools, workflow ...

09/09/2026

ESPN and Apple Music Collaborate on Monday Night Football Music Curation for 2026-27 Season

ESPN and Apple Music have announced a collaboration on music curation for Monday...

09/09/2026

Sacramento Production Services Deploys Wisycom RF System at Sutter Health Park

Sacramento Production Services has completed a wireless audio overhaul at Sutter Health Park, home of the Athletics during their three-year residency in Sacrame...

09/09/2026

NDI and NVIDIA Collaborate on AI-Powered Multilingual Content Workflows

NDI and NVIDIA have announced a collaboration to develop AI-powered workflows enabling broadcasters to create and distribute multilingual content from a single ...

09/09/2026

Sports Broadcasting Hall of Fame Announces the Class of 2026

Christopher Chip Adams, Troy Aikman, Jim Dove, Jim Eady, Bucky Gunts, Robert A. Iger, Charlie Jablonski, Robert Kraft, Tom Rinaldi, and Dick Stockton to be ho...

09/09/2026

NBC Sports Opens 21st SNF Season With Expanded Schedule, Traveling Studio Show, and Bulked Up Toolkit

ND2 returns as the primary unit, While FNIA gets SSQC and new flexible Rover...

09/09/2026

Celemony Tonalic gains additional Paul Kleber upright bass

New parts aimed at hip-hop and pop productions The latest update to Celemony's innovative virtual session musician expands the collection of built-in in...

09/09/2026

Sonarworks Autumn Sale

Save up to 40% until 21 September 2026 Sonarworks are currently running their Autumn Sale, with discounts of up to 40% currently available across their rang...

09/09/2026

Bjooks Beat Gems to begin shipping

Upcoming title officially launches in September 2026 Bjooks' celebrations for this year's 909 Day will be welcome news amongst drum machine lovers, ...

09/09/2026

NITV to bring First Nations netball to audiences nationwide

NITV to bring First Nations netball to audiences nationwide 9 September, 2026 Media releases Every match of the 2026 First Nations Tournament will be live ...

09/09/2026

NFVF CALL FOR PROPOSALS: YOUTH FILMMAKER PROJECT FACILITATING COMPANY 2026

The National Film and Video Foundation (NFVF) invites eligible Tier 1 and 2 South African production companies to submit proposals to serve as the Facilitating ...

09/09/2026

Nielsen launches CTV Ad spend data into its Italian Ad Intel product

Italy launch follows UK and Germany as Nielsen expands product across EMEA Milan, Italy, September 9, 2026 - Nielsen, a global leader in audience measurement, ...

09/09/2026

Gracenote Expands AI Product Roadmap with Sports MCP Server, Entertainment SLM and Agents

Planned solutions tackle accuracy, cost and latency barriers to deploying AI at ...

09/09/2026

Dalet Promotes Brian Doheny to CEO

Share Copy link Facebook X Linkedin Bluesky Email...

09/09/2026

Studio Technologies Expands StudioComm Monitoring With In...

Studio Technologies, a leading manufacturer of high-quality audio, video, and fiber-optic solutions, introduces its new Model 791 Control Console at IBC 2026 (N...

09/09/2026

Maxon Brings Exclusive Preview of Fall Innovations to IBC...

Maxon, maker of powerful, approachable software solutions for creators working in 2D and 3D design, motion graphics, visual effects and visualization, is headin...

09/09/2026

NUGEN Audio Leads the Dialog Intelligibility Conversation...

NUGEN Audio unveils DialogCheck v1.2, the latest evolution of its intelligent dialog intelligibility and compliance tool, at IBC 2026 (Pod P27). With a sharpene...

09/09/2026

Trusted Partner Network Launches Fix It or Risk It to Hel...

Trusted Partner Network Launches Fix It or Risk It to Help the Entertainment Industry Tackle Everyday Security Risks Industry-Wide Campaign Launches at IBC2...

09/09/2026

FCC to Vote on Opening Up Spectrum for Satellite, IoT

Share Copy link Facebook X Linkedin Bluesky Email...

09/09/2026

NDI, NVIDIA Collaborate On Real-Time AI Multilingual Content

Share Copy link Facebook X Linkedin Bluesky Email...

09/09/2026

83 percent of UK advertisers are using AI but speed and n...

AI has moved firmly beyond experimentation in UK advertising, with more than eight in ten marketers (83%) now actively using or piloting AI in production, accor...

09/09/2026

Pixitmedia by DataCore to showcase cloud and connected pr...

IBC2026 - Stand 7.D22 At IBC2026, Pixitmedia by DataCore will showcase its latest capabilities designed to simplify distributed production, accelerate workflow...

09/09/2026

Net Insight Showcases Open Live Media for Controlled Live...

Stockholm, Sweden September 9th, 2026 At IBC2026, on booth 1.B47, Net Insight will showcase Open Live Media, its architecture for delivering resilient live ...

09/09/2026

Net Insight and DMC expand repeatable remote production m...

Net Insight today announced that DMC Production Norway is continuing the use of its Open Live Media technology for premium European football, deploying Nimbra 5...

09/09/2026

Amagi to Showcase Four AI-Native Innovations Built to Pow...

Amagi, the media industry cloud platform for unified broadcast, streaming, and monetization, will showcase four new AI-native capabilities at IBC2026, Hall 5, S...

09/09/2026

Limecraft Brings Connected Automated and Intelligent Medi...

Limecraft today announces version 2026.6 of its AI-powered production platform, extending capabilities for connected media operations. An AI-assisted approach t...

09/09/2026

Telestream Advances Practical AI from Content Understandi...

Telestream, a global leader in media workflow technologies, today announced the next evolution of its Practical AI strategy, evolving its comprehensive portfoli...

09/09/2026

Dalet Appoints Brian Doheny as Chief Executive Officer

Dalet, a leading technology and service provider for media-rich organizations, today announced the appointment of Brian Doheny as Chief Executive Officer (CEO)....

09/09/2026

LiveU Offers Starlink for News and Sports Broadcast as Cl...

LiveU is now a Clarus Integrated Reseller, bringing Starlink's fast, reliable broadband directly into LiveU's cellular bonding EcoSystem through a singl...

09/09/2026

Study: New Streaming TV Series Orders Plumet

Share Copy link Facebook X Linkedin Bluesky Email...