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

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

16/07/2026

Business Innovation Synergizer: Grants of up to 30,000 for media organisations

Media organisations with tested plans for new products, services or revenue models can now apply for grants of up to 30,000 through the Business Innovation Syn...

16/07/2026

SVG Students To Watch: Kaden Sherman, Albany State University

This recent graduate and Georgia native has turned an early fascination with live production into a growing passion for camera work In the live-sports-video in...

16/07/2026

TNDV Marks First Year of Aspiration 35 Cinematic Production Truck

TNDV is marking the first anniversary of Aspiration 35, a mobile production truck built around ARRI Alexa 35 Live camera systems. Over its first year, the truck...

16/07/2026

ATSC Releases First Major Revision to A/85 Audio Loudness Recommended Practice Since 2013

ATSC has completed a major revision to its A/85 Recommended Practice: Techniques...

16/07/2026

FloSports Named Exclusive Global Media Partner for 2026 CrossFit Games

FloSports has announced an exclusive global media partnership with CrossFit for the 2026 CrossFit Games, presented by Air National Guard, beginning July 21 in S...

16/07/2026

Sennheiser Releases Spectera Firmware 1.4 and Command Button

Sennheiser has released firmware version 1.4 for its Spectera wireless system and announced the Spectera Command Button (Cat. No. 701014). The update adds comma...

16/07/2026

ESPN and Southwestern Athletic Conference Announce Multi-Year Media Rights Agreement Through 2030-31

ESPN and the Southwestern Athletic Conference (SWAC) have announced a multi-year...

16/07/2026

Audio-Technica Releases 20 Series Control Application for Elgato Stream Deck

Audio-Technica has announced the 20 Series Control Application, a Stream Deck plug-in for compatible Audio-Technica USB microphones. The application is compatib...

16/07/2026

SSL Live L550 Plus Consoles Power Audio Production for The Voice France Season 15

The fifteenth season of The Voice - La plus belle voix on TF1 used four Solid St...

16/07/2026

Gray Media and Atlanta Hawks Announce Georgia-Wide Broadcast Partnership for 2026-27 NBA Season

Gray Media and the Atlanta Hawks have announced a broadcast partnership that wil...

16/07/2026

SVG Sit-Down: Quarterback Showrunner Joe Zucco on Cinematography, Building Trust, Carrying On the NFL Films Legacy

Season 3 of Netflix's docuseries, which dropped this week, follows Jayden Da...

16/07/2026

Texas Rangers Switch Direct-to-Consumer Streaming Partner to BZZR

The Texas Rangers and Rangers Sports Network presented by Progressive (RSN) have announced BZZR as the new direct-to-consumer distributor for Rangers game broad...

16/07/2026

FIFA World Cup 2026: BBC Sport on Moving Across the Pond to Bring the Atmosphere of the Final Matches to Fans

With England's FIFA World Cup 2026 team getting ready to fly home after losi...

16/07/2026

With 36 Unilateral Cameras, NBC Sports Shapes 154th Open Championship Coverage for U.S. Viewers

In a return to Royal Birkdale, the team enjoys partnering with ETP and Gravity M...

16/07/2026

Altitude Sports & Entertainment's Tim De Lay on New SkyCam Digital Feed, Upgraded Studio Space

Along with a new studio at Ball Arena, the Colorado-based RSN is working with XR...

16/07/2026

FIFA World Cup 2026: Inside ORF's Austria-Based Production to Bring All the Emotions of the Tournament to Fans

Austria was back at the World Cup for the first time in 28 years, and the team d...

16/07/2026

Inside Gravity Media's Effort To Power the 154th Open Championship Production

With 42 RF cameras and high-power radio mics deployed, the spectrum environment ...

16/07/2026

Baby Audio release SubCulture

A new benchmark in bass enhancement Described as a new benchmark in bass enhancement , Baby Audio's latest release has been designed to augment the lo...

16/07/2026

Other Worlds Evolved from Zero G

Popular library rebuilt in new Orbita Engine Other Worlds Evolved is the latest of Zero G's sample libraries to be treated to a ground-up rebuild using ...

16/07/2026

Native Instruments announce Super*Saw

Created in collaboration with A. G. Cook The newest addition to Native Instruments' software collection introduces a new synth created by A. G. Cook, a ...

16/07/2026

NITV and SBS bring Australians to the heart of Garma

NITV and SBS bring Australians to the heart of Garma 16 July, 2026 Media releases The Garma Festival returns from 31 July-3 August, with NITV and SBS deliv...

16/07/2026

Rohde & Schwarz supplies conformance test systems to Marquistech for India's first GCF RTO and PTCRB ATL lab

Rohde & Schwarz supplies conformance test systems to Marquistech for India's...

16/07/2026

The Gauge: Poland | June 2026

June brought stabilization to the television market. Poles spent an average of 3 hours and 36 minutes a day in front of their TV screens exactly the same as i...

16/07/2026

New studio monitoring leads Glensound's 60th year line-up...

Glensound returns to IBC with a major new addition to its intelligent loudspeaker range, the Greater Divine Supernal studio monitor, alongside recent developmen...

16/07/2026

Complete spectrum of innovation from British exhibitors a...

33 leading exhibitors are taking part in the GREAT Britain and Northern Ireland Pavilions and linked locations across IBC2026 (Amsterdam RAI, 11 14 September)...

16/07/2026

Hitomi Broadcast to showcase HDR colour verification and...

Hitomi Broadcast will introduce Spectra, a new HDR colour verification solution measured in picture, not using VPID, at IBC2026 (Hall 10, Stand A40). Expanding ...

16/07/2026

SMPTE Kicks Off 110th Anniversary Campaign

Share Copy link Facebook X Linkedin Bluesky Email...

16/07/2026

Cox Media Group Taps Waymark for AI Ad Creation Tools

Share Copy link Facebook X Linkedin Bluesky Email...

16/07/2026

Parks: Cable Broadband Sub Losses Slow Down

Share Copy link Facebook X Linkedin Bluesky Email...

16/07/2026

CatchLight, Sony Launch Initiative to Help Local Newsrooms

Share Copy link Facebook X Linkedin Bluesky Email...

16/07/2026

XR Launches XR ONE Ad Ops Platform

Share Copy link Facebook X Linkedin Bluesky Email...

16/07/2026

Zixi and Comcast Technology Solutions Partner to Provide...

Zixi, a leader in live video delivery and workflow orchestration, and Comcast Technology Solutions (CTS) today announced a strategic new integration to deliver ...

16/07/2026

Blackmagic Design Cameras Capture Immersive Flight for New Cirrus App

Blackmagic Design Cameras Capture Immersive Flight for New Cirrus App Brie Clayton July 15, 2026 0 Comments Leader in Personal Aviation taps URSA Cin...

16/07/2026

XenData Announces LTO Archive Appliances with both File and S3 Object Storage Interfaces

XenData Announces LTO Archive Appliances with both File and S3 Object Storage In...

16/07/2026

RTW Network Display

Modern broadcast facilities are no longer confined to a single control room. Production teams are spread across multiple workstations, machine rooms, studios, c...

16/07/2026

Fox Corporation Executives to Discuss Fourth Quarter and Full Fiscal Year 2026 Financial Results Via Webcast

Fox Corporation Executives to Discuss Fourth Quarter and Full Fiscal Year 2026 F...

16/07/2026

More interfaces now compatible with Focusrite Control 2

More interfaces now compatible with Focusrite Control 2 Your Focusrite interface might now be compatible with a public beta support of Focusrite Control 2. If...

16/07/2026

Sharpen the Sword, Skip the Downloads - Onimusha: Way of the Sword' Is Coming to GeForce NOW

Onimusha: Way of the Sword is coming to GeForce NOW at launch, with the playable...

16/07/2026

FIFA World Cup semi-finals deliver whopper audiences as RT Player surpasses 21 million streams across the tournament to date

Together the semi-finals had a combined reach of 1.98 million unique individuals...

15/07/2026

Inside DAZNs Multi-Market World Cup Effort With CTO Sandeep Tiku

The 2026 FIFA World Cup is a big deal for DAZN, which has distribution rights in three markets: Italy, Spain, and Japan. Each requires a different editorial app...

15/07/2026

SVG New Sponsor Spotlight: Qumulo's Chris Horn on Powering Global Media Workflows Across Edge, Core, and Cloud

As sports-media organizations manage rapidly growing content libraries and incre...

15/07/2026

FIFA World Cup 2026: Inside the HBS Non-Live London Production Hub

HBS director of digital Johannes Franken talks SVG Europe through the operation built to serve FIFA World Cup 2026 rights holders remotely from Stratford, east ...

15/07/2026

IBC2026 to Spotlight AI, Live Sports Production, Creator Economy, and Trust in Media

IBC has unveiled the conference program for IBC2026, with this year's event ...

15/07/2026

Vanessa Paradis Tour Adopts Sennheiser Spectera Wireless Ecosystem for 2026 Production

Software-defined wideband RF platform supports 96-kHz monitoring, streamlined fr...

15/07/2026

Telos Alliance Integrates AudioShake Source Separation Into Minnetonka AudioTools Server

New AI-powered module enables broadcasters and content owners to extract dialogu...

15/07/2026

AIMS Schedules Second IPMX Product Certification Event for August

Weeklong gathering at EBU headquarters will test new IPMX capabilities and expand certified product ecosystem...