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

01/09/2026

Broadcasters Gain Flexibility in Pursuit of 5G Multicasting

Share Copy link Facebook X Linkedin Bluesky Email...

01/09/2026

Winning the Fight Against Churn

Share Copy link Facebook X Linkedin Bluesky Email...

01/09/2026

How Multiviewers Are Evolving Into Information Hubs'

Share Copy link Facebook X Linkedin Bluesky Email...

01/09/2026

IBC2026: New Audio Tools on Tap from Telos Alliance

Share Copy link Facebook X Linkedin Bluesky Email...

01/09/2026

SMPTE Roadshow to Examine Media Infrastructure at IBC2026

Share Copy link Facebook X Linkedin Bluesky Email...

01/09/2026

Roku Debuts Its First 4K OLED TVs

Share Copy link Facebook X Linkedin Bluesky Email...

01/09/2026

Mark Vinten Joins ASG's Audio and Postproduction Team

Share Copy link Facebook X Linkedin Bluesky Email...

01/09/2026

Pronology Introduces New StreamFile Core Capabilities at...

Pronology, a developer of cutting-edge broadcast workflow solutions, showcases the newest capabilities for its StreamFile Core platform at the 2026 IBC Show (S...

01/09/2026

PROTON Unveils Next-Generation FLEXY Camera at IBC 2026

PROTON Unveils Next-Generation FLEXY Camera at IBC 2026 Brie Clayton September 1, 2026 0 Comments 10-metre serialised coax unlocks new perspectives an...

01/09/2026

Hulu Drama The Season Graded with DaVinci Resolve Studio

Hulu Drama The Season Graded with DaVinci Resolve Studio Brie Clayton September 1, 2026 0 Comments Senior Colorist Mark Kueper of Picture Shop crafts ...

01/09/2026

Pluxbox Launches CoreOC to Transform Mission-Critical Media Operations

Pluxbox Launches CoreOC to Transform Mission-Critical Media Operations Brie Clayton September 1, 2026 0 Comments A vendor-agnostic operational control l...

01/09/2026

Layercake Appoints Former FOX SPORTS and Network Ten COO...

Layercake, the company behind the intelligent media workflow platform Streamcake, today announced the appointment of Jon Marquard as Director and Chairperson. T...

01/09/2026

Actus Digital Unveils the Future of Broadcast Monitoring...

Actus Digital, a LiveU company, will unveil the next generation of its Actus X platform at IBC2026 on LiveUs Stand 7.C24, demonstrating how broadcasters can sim...

01/09/2026

Studio Automated and Egripment Power the Tactical Feed fo...

Broadcast Solutions, a leading systems integrator and provider of innovative solutions for the broadcast media industry, delivered transformational technology a...

01/09/2026

OTV turns to Quortex to replace legacy video hardware

Quortex, the intelligent video technology company carved out from Synamedia by Lumine Group, today announced that Odisha Television Network (OTV), the leading r...

01/09/2026

Zixi and Ateme Deepen Strategic Alliance to Accelerate Hy...

Zixi and Ateme today announced an expanded strategic partnership to help broadcasters and content owners accelerate the transition from satellite to resilient I...

01/09/2026

CBS Boston Debuts New AR/VR Technology-Driven Studio

Share Copy link Facebook X Linkedin Bluesky Email...

01/09/2026

FCC Raises Regulatory Fees for TV Stations

Share Copy link Facebook X Linkedin Bluesky Email...

01/09/2026

For-A Introduces Go Vertical! AiDi and AiDi Sports Hub

Share Copy link Facebook X Linkedin Bluesky Email...

01/09/2026

T-Mobile Continues to Dominate Ooklas Fixed Wireless Speed Tests

Share Copy link Facebook X Linkedin Bluesky Email...

01/09/2026

Carr Announces New FCC Enforcement Bureau Chief

Share Copy link Facebook X Linkedin Bluesky Email...

01/09/2026

Experience La Dolce Vita with Donal's Italian Kitchen

Join Donal Skehan in discovering the best of everyday Italian cooking in brand new series, airing Wednesday 2 September In this brand-new series, Donal's I...

01/09/2026

RT Supporting the Arts is supporting 28 cultural events nationwide this September

RT Supporting the Arts is delighted to spotlight a diverse range of arts, cultu...

31/08/2026

Pixotope Consolidates Virtual Production Tools into Unified Platform

Pixotope Technologies has announced a unified platform offering all Pixotope capabilities across three editions, available with the Pixotope 26.3 release in Q3 ...

31/08/2026

Elektron update Tonverk OS

Sampler gains Overbridge multitrack streaming Elektron's polyphonic sampler, the Tonverk, has just received an OS update that introduces multitrack stre...

31/08/2026

Thorus XT from UVI

Popular chorus plug-in gains second engine UVI's latest plug-in offers a fresh new take on their best-selling chorus effect, combining a pair of engines...

31/08/2026

Optus commits 3% of consumer brand spend to First Nations media in new landmark partnership with NITV

Optus commits 3% of consumer brand spend to First Nations media in new landmark ...

31/08/2026

FingerWorks Telestrators Expands European Presence Throug...

FingerWorks Telestrators, the industry leader in software-based telestration and live sports analysis solutions, announces its new partnership with Broadcast R...

31/08/2026

ARISDA Bridge Launches: DaVinci Resolve Timecode, Studio Clock, and Work-Time Tracking in One Windows App

ARISDA Bridge Launches: DaVinci Resolve Timecode, Studio Clock, and Work-Time Tr...

31/08/2026

Short Film All That's Left Shot with URSA Cine 12K LF

Short Film All That's Left Shot with URSA Cine 12K LF Brie Clayton August 31, 2026 0 Comments Intimate drama edited and graded in DaVinci Resolve ...

31/08/2026

Bridge Technologies Announces Support for Blackmagic IP10 Codec

Bridge Technologies Announces Support for Blackmagic IP10 Codec Brie Clayton August 31, 2026 0 Comments Both booths will showcase each other's tec...

31/08/2026

Creative COW Roundtable, August 23, 2026- AEAI

Creative COW Roundtable, August 23, 2026- AEAI Brie Clayton August 31, 2026 0 Comments COWs from around the world assemble to discuss Using AI to Beat...

31/08/2026

Homecoming Artist Spotlight: Susan Tedeschi

Homecoming Artist Spotlight: Susan Tedeschi The Grammy-winning singer and guitarist talks about finding her voice at Berklee ahead of her Homecoming performan...

31/08/2026

HC2 Meets with FCC Legal Advisor in Push for 5G Broadcasting

Share Copy link Facebook X Linkedin Bluesky Email...

31/08/2026

Tribeca Studios Releases First-Look Trailer For Tribeca 25, The New Documentary From Matt Tyrnauer

August 31st, 2026 Press Materials Here TRIBECA STUDIOS RELEASES FIRST-LOOK TRA...

31/08/2026

Digicel Pacific Selects Techtel for PNG Digital TV Head-End Transformation

Digicel Pacific Selects Techtel for PNG Digital TV Head-End Transformation 31 Aug Written By Mal Chandler Sydney, 31 August 2026 - Techtel has been appointe...

30/08/2026

Reason Studios launch Reason Free

Free collection includes 15 instruments Reason Studios have announced that they are making their popular Reason Rack plug-in free, and bundling it with a se...

29/08/2026

SSL to introduce O-Series V2.0

Odyssey & Oracle console software update incoming With a second console now joining their O-Series, SSL have announced the upcoming launch of O-Series V2.0,...

29/08/2026

Scripps Hires NBCU Sales Veteran Jen Carfley

Share Copy link Facebook X Linkedin Bluesky Email...

29/08/2026

Comcast's Universal Ads Taps Tracer to Upgrade Operations

Share Copy link Facebook X Linkedin Bluesky Email...

29/08/2026

PlayBox Technology to Showcase the Future of Media Orches...

PlayBox Technology is heading to IBC2026 with a clear message: the future of broadcast and streaming is not about replacing everything it is about making what...

29/08/2026

Berklee Announces Fall 2026 Signature Series

Berklee Announces Fall 2026 Signature Series This years concerts feature MonoNeon, Brandon Woody, Marcus Gilmore, and Caroline Davis, alongside Berklee Asia R...

28/08/2026

CBS L.A. Runs Two Hot Control Rooms, Dual Broadcasts for Rams-Chargers Preseason Game

KCBS takes the Chargers side, KCAL takes the Rams - with feeds out to 18 partner...

28/08/2026

Buddy Turns Childhood Comfort into Midnight Terror

(L-R) Topher Grace, Cristin Milioti, Delaney Quinn, Casper Kelly, and Keegan-Michael Key pose with the character Buddy at the Buddy Premiere during the 2026 S...

28/08/2026

IK Multimedia announce Sinphonica Maestosa Strings

The Italian orchestra, reimagined IK Multimedia have announced the upcoming launch of Sinphonica, a new family of Italian orchestral instruments designed f...

28/08/2026

Voxis from CEDAR Audio

Voice-isolation plug-in boasts sub-10ms latency Launched in 2025, CEDAR Audio's Icons range was created with the aim of bringing the company's renow...

28/08/2026

Charter Takes Scripps to Court Over Carriage of Las Vegas' KMCC

Share Copy link Facebook X Linkedin Bluesky Email...