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

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

07/07/2026

Open call: Apply for the Media Innovation Europe Validation Booster

Applications are now open for the Validation Booster, a six-month acceleration programme supporting journalists, media organisations, content creators, media in...

07/07/2026

HAND Issues Persistent Digital IDs to 50 Top 2026 MLB Draft Prospects

The Universal Talent Identifier (HAND) has issued HAND IDs to 50 top prospects ahead of the 2026 MLB Draft, including consensus top-ranked players Roch Cholowsk...

07/07/2026

Cisco and McLaren Mastercard Formula 1 Team Extend Technology Partnership

Cisco and the McLaren Mastercard Formula 1 Team have announced an extension of their partnership, expanding the scope from networking and communications to incl...

07/07/2026

LucidLink Announces Enhanced Integration with Adobe Frame.io

LucidLink has announced a workflow integration with Adobe Frame.io that gives production teams unified access to Frame.io projects alongside supporting producti...

07/07/2026

Chyron Appoints Ahmed Magd as Middle East Sales Director

Chyron has announced the appointment of Ahmed Magd as Sales Director for the Middle East. Magd joins from previous senior commercial roles at Riedel Communicati...

07/07/2026

Leader Electronics T&M Equipment Used in Live Broadcast of Pope Leo XIVs Visit to Sagrada Famlia

Leader Electronics of Europe has announced that its PHABRIX Qx rasterizer and Le...

07/07/2026

eCLUTCH Secures EMEA and MENA Broadcast Rights for Esports World Cup 2026

eCLUTCH has announced it has acquired broadcast rights to the Esports World Cup 2026 for EMEA and MENA, covering the Middle East, Africa, the Balkans, Sweden, a...

07/07/2026

Riedel and ARRI Support Cinematic Live Production at Eurovision Song Contest 2026

Riedel Communications and ARRI supported ORF's host broadcast of the Eurovis...

07/07/2026

ARRI Releases ALEXA 35 Live Xtreme With High-Frame-Rate SDI Output for Live Production

ARRI has announced the ALEXA 35 Live Xtreme, a camera that adds high frame rate ...

07/07/2026

IBC 2026: LiveU To Exhibit With LU900Q, Sony Integration, EcoSystem Expansion

LiveU will exhibit at IBC 2026 (Stand 7.C24), showcasing the LU900Q Intelligent Production Unit, expanded Sony collaboration, and additions to its open IP-video...

07/07/2026

Peacock Advances Spanish-Language World Cup Streaming With Visin de Campo, Dolby Vision, Real-Time Highlights

Telemundo's coverage is packaged with Multiview, Catch Up with Key Plays, in...

07/07/2026

Australian Rugby League Commission Secures $5.3 Billion Media Rights Deal with Foxtel, Nine, and Sky NZ

The Australian Rugby League Commission (ARLC) has announced a seven-year media r...

07/07/2026

BYUtv Partners With Big 12 for Football Media Days Production

Produced onsite at The Star in Frisco, TX, live coverage of the two-day event airs on ESPN platforms The season for Football Media Days is here, and the Big 12...

07/07/2026

Rogers To Become 100% Owner of Maple Leaf Sports & Entertainment

Rogers Communications Inc. has announced an agreement to acquire the remaining 25% ownership stake in Maple Leaf Sports and Entertainment (MLSE) from Kilmer Spo...

07/07/2026

Mobile TV Groups Nick Garvin on Success of MTVG Production Platform at New Mountain Media Center

End-to-end broadcast solution includes fleet of mobile units, Cloud Control, and...

07/07/2026

SVG Executive Perspectives 2026: Industry Leaders Discuss Biz and Tech Trends for the Year Ahead

Sports-production-tech experts sound off on the state of the industry...

07/07/2026

Mix Buddy instrument mixer from Heritage Audio

New mixer aimed squarely at instrument-level sources Heritage Audio have clearly been busy recently, as alongside their all-new Tubestrip, they've also ...

07/07/2026

Heritage Audio unveil the Tubestrip

New channel strip combines popular hardware designs The latest arrival to the Heritage Audio line-up brings together a selection of their praised hardware d...

07/07/2026

Clear-Com Powers Ross Production Services Mobile Productions

eds3_5_jq(document).ready(function($) { $(#eds_sliderM519).chameleonSlider_2_1({ content_source:......

07/07/2026

New Nielsen data shows Kiwis' wellbeing is shaped by fitness, finance and mental health

New Kessler 10 data now available in Nielsen CMI gives brands a deeper view of h...

07/07/2026

Vitamin brands boost ad spend by 27% as 11.8 million Australians turn to supplements

New Nielsen Ad Intel and CMV data reveals rising competition in Australia's ...

07/07/2026

DAS Disputes Wiegels 3.0 EAS Limitations

Share Copy link Facebook X Linkedin Bluesky Email...

07/07/2026

LiveU to Showcase Q Era Innovations at 2026 IBC Show

Share Copy link Facebook X Linkedin Bluesky Email...

07/07/2026

LucidLink Unifies Adobe Frame.io, Enterprise Storage

Share Copy link Facebook X Linkedin Bluesky Email...

07/07/2026

ARRI Introduces ALEXA 35 Live Xtreme Camera

Share Copy link Facebook X Linkedin Bluesky Email...

07/07/2026

Riedel and ARRI Bring Cinematic Live Production to the Eu...

Riedel Communications and ARRI played a key role in one of the most technically ambitious Eurovision Song Contest productions to date. For the first time in the...

07/07/2026

Berklee Valencia Honors Eric Whitacre at the 2026 Commencement Ceremony

Berklee Valencia Honors Eric Whitacre at the 2026 Commencement Ceremony The Grammy-winning composer was celebrated alongside this years cohort of masters degr...

07/07/2026

Disagreements Abound Over the Adequacy of C-Band Replacements

Share Copy link Facebook X Linkedin Bluesky Email...

07/07/2026

Cameras Become More Connected to Production Workflows

Share Copy link Facebook X Linkedin Bluesky Email...

07/07/2026

NFL on TV: Time to Move the Regulatory Goal Posts?

Share Copy link Facebook X Linkedin Bluesky Email...

07/07/2026

Building a Future-Ready Facility for Tomorrow's Broadcasters

Share Copy link Facebook X Linkedin Bluesky Email...

07/07/2026

Rewriting the Control Room: How Broadcasters Are Going Remote

Share Copy link Facebook X Linkedin Bluesky Email...

07/07/2026

Fincons Group appoints Andrea Fravega as Global BU Media...

The appointment will drive growth and innovation across the Media Business Unit Fincons Group, a leading IT business consultancy and systems integrator company...

07/07/2026

Big Blue Marble debuts next-gen ultra low latency MoQ str...

International broadcast and streaming expert Big Blue Marble has announced a multi-month Proof of Concept (PoC) for Media over QUIC (MoQ) during a major interna...

07/07/2026

Leader provides Test and Measurement for global broadcast...

Test & measurement innovator, Leader Electronics of Europe, is proud to announce that two of its leading products, the PHABRIX Qx rasterizer and LeaderPhabrix L...

07/07/2026

Clear-Com Powers Ross Production Services Mobile Producti...

Clear-Com announced that Ross Production Services (RPS), a leading provider of mobile production solutions for live events and broadcasts, has standardized on ...

07/07/2026

Q Era Innovations Take Center Stage for LiveU at IBC2026

LiveU redefined live newsgathering with the invention of cellular bonding. At IBC2026, Stand 7.C24, the company will show how that foundation is evolving into t...

07/07/2026

Camera to Cloud Meets Camera to Timeline LucidLink Unifi...

LucidLink, a leader in cloud-based file services for content creators, today announced an enhanced workflow integration between LucidLink and Adobe Frame.io tha...

07/07/2026

Comcast's Sky to Acquire ITV Media and Entertainment

Share Copy link Facebook X Linkedin Bluesky Email...

07/07/2026

Digital Alert Systems Details ATSC 3.0 EAS Capabilities to FCC

Share Copy link Facebook X Linkedin Bluesky Email...

07/07/2026

New appointments to Screen Australia board

New appointments to Screen Australia board 7 July 2026 The Albanese Labor Government has made new appointments to the Screen Australia board. Dr Tania Chamber...

07/07/2026

The right team. The right time.' How The Killings at Parrish Station stuck to their creative guns.

The right team. The right time.' How The Killings at Parrish Station stuck t...

07/07/2026

Toby Regbo, Harry Gilby and Jessica Barden lead cast for The Cadburys - the true story of the Cadbury family - with filming now underway in Birmingham

UKTV commission with BritBox and Sony Pictures Television and inspired by Deborah Cadbury's book, Chocolate Wars The six-part series is produced by Fable P...

07/07/2026

Record audiences tune into the ICC Womens T20 World Cup 2026 on Sky Sports

Tuesday 7 July 2026 Record audiences tune into the ICC Women's T20 World Cup 2026 on Sky Sports The ICC Women's T20 World Cup 2026 was the most watche...

07/07/2026

Official trailer released for Fightland, a revenge drama from executive producer Curtis 50 Cent Jackson coming August to Sky and NOW

Tuesday 7 July 2026 Official trailer released for Fightland, a revenge drama fr...

07/07/2026

Riedel and ARRI Bring Cinematic Live Production to the Eurovision Song Contest

Wuppertal July 7, 2026 Riedel and ARRI Bring Cinematic Live Production to the Eurovision Song ContestRiedel Communications and ARRI played a key role in one o...