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

21/11/2026

Give Me the Ball! Serves a Powerful Portrait of Billie Jean King

Billie Jean King and Ilana Kloss attend the premiere of Give Me the Ball! by Liz Garbus and Elizabeth Wolff, an official selection of the 2026 Sundance Film Fes...

21/11/2026

fedDSP introduce Kami

Compressor plug-in free for first two weeks The latest plug-in to join fedDSP's Amps & Pedals line-up has just arrived, and the company are kindly offer...

21/11/2026

Can a Democratic Congress Revive Public Media Funding?

Share {alert(Link copied)}).catch(err => {console.error(Failed to copy: , err)}) data-platform=copy_link data-action= class=font-ui-heading py-2 text-sm tex...

21/11/2026

ATSC's Jerry Whitaker, Zandra Clarke Receive SMPTE Honors

Share {alert(Link copied)}).catch(err => {console.error(Failed to copy: , err)}) data-platform=copy_link data-action= class=font-ui-heading py-2 text-sm tex...

21/11/2026

Brightline Lighting Introduces the MOD2 Increasing the Re...

A larger studio puts more distance between the lights and the people who need to look good under them. Brightline Lighting, a manufacturer of energy-efficient l...

21/11/2026

Scripps Research awarded $7M to catalyze pain and addiction initiative

LA JOLLA, CA-Despite its enormous impact on individuals, families and communities, addiction remains an area of significant unmet medical need. A $7 million gi...

21/11/2026

27 FANGORIA Chainsaw Awards Nominees Created with Blackmagic Design

27 FANGORIA Chainsaw Awards Nominees Created with Blackmagic Design Brie Clayton November 20, 2026 0 Comments Blackmagic Design hardware and software ...

21/11/2026

Qube Cinema Named Technical Partner for 57th International Film Festival of India

Qube Cinema Named Technical Partner for 57th International Film Festival of Indi...

20/11/2026

ESPN's Jimmy Pitaro on Super Bowl LXI: A Yearlong Story That Features a Game'

The sports broadcaster's chairman sees the upcoming game as an opportunity t...

20/11/2026

SVG GameDay, Ep. 40: New York Mets Brendan McKeon - Firing Up Fans in Flushing

In-venue and creative video staffers at the professional and collegiate level have one major thing in common: the intensity and attention to detail ramps up dur...

20/11/2026

Back at Belmont Park, Part 1: Historic Venue's Renovation Puts a Premium on the Fan Experience

A variety of LED displays, integrated broadcast infrastructure covers every angl...

20/11/2026

RAF Partners with Migu Video to Bring RAF15 Main Event to China

Real American Freestyle (RAF) has announced a distribution partnership with Migu Video, a Chinese digital sports platform, to carry the RAF15 main event between...

20/11/2026

Apple TV Becomes U.S. Home of F1 Academy Beginning in 2027

Apple and F1 Academy have announced that the all-female racing series will stream on Apple TV in the U.S. beginning in 2027. Fans will be able to watch every qu...

20/11/2026

mnchen.tv Relies on Riedel Technology for New Production Center

Regional broadcaster m nchen.tv has modernized its production infrastructure at a new location in northern Munich. Riedel MediorNet provides decentralized signa...

20/11/2026

Eutelsat Announces Three Executive Committee Appointments

Eutelsat has announced three appointments to its Executive Committee, effective November 2026, under CEO Jean-Fran ois Fallacher. Jean-Hubert Lenotte is appoin...

20/11/2026

Seven Melbourne Selects RTS and Magna Systems for Comms Upgrade at New Facility

After more than two decades at Harbour Esplanade in Docklands, the Seven Network has relocated its Melbourne headquarters to a new, custom-built ST 2110 facilit...

20/11/2026

Brazil's TV 3.0 Rollout Shows VVC Moving from Standards Work to Commercial Deployment

Brazil is among the first markets deploying Versatile Video Coding (VVC) as part...

20/11/2026

NBC Sports and The Soccer Tournament Agree to Two-Year Extension for TST 2027 and 2028

The Soccer Tournament (TST), the $1 million winner-take-all 7v7 world championsh...

20/11/2026

Back at Belmont Park, Part 2: NYRA Reaps Benefits of Reimagined Track With Expanded Broadcast Capabilities

Enhancements include a larger compound, an elevated camera count, and a whole lo...

20/11/2026

With Women's Sports Programming Skyrocketing, Content and Production Strategy Are Evolving

Leaders from ESPN, iHeartMedia, and Just Women's Sports explore creating new...

20/11/2026

Lemur Audio release Dorothe

New EQ plug-in aimed at mastering duties Lemur Audio's latest plug-in has just arrived, delivering a characterful EQ that's aimed primarily at maste...

20/11/2026

Soundtoys Black Friday Sale

Discounts of up to 75% now available Soundtoys' annual Black Friday sale is now live, with discounts of up to 75% applied across the company's range...

20/11/2026

SoundGhost release Fragment

New creative looping tool revealed Described as a cycling audio fragmenter , the latest addition to the SoundGhost range draws its inspiration from tape ph...

20/11/2026

Heritage Audio's Herchild 670 goes virtual

Fairchild recreation gets plug-in counterpart Heritage Audio's Herchild 670 offers a meticulous hardware recreations of the much-loved Fairchild 670 and...

20/11/2026

BONDI: 7 Minutes That Changed Australia

BONDI: 7 Minutes That Changed Australia 16 November, 2026 Media releases A landmark documentary chronicling the worst terror attack in modern Australian hi...

20/11/2026

Statement regarding SBS non-Executive Director Aaron Fa'Aoso

Statement regarding SBS non-Executive Director Aaron Fa'Aoso 20 November, 2026 Media releases Aaron Fa'Aoso has advised that he is stepping down a...

20/11/2026

PUBLIC NOTICE FROM THE DEPARTMENT OF SPORT, ARTS AND CULTURE

INVITATION FOR PUBLIC COMMENTS AND OBJECTIONS ON NOMINEES FOR APPOINTMENT TO THE COUNCIL OF THE NATIONAL FILM AND VIDEO FOUNDATION (NFVF) The Department of Spor...

20/11/2026

TVP Claims Top Spot in Poland's Content Distributor Rankings

UEFA Nations League football and autumn premieres propel TVP to number one as YouTube grows its TV screen share Warsaw, Poland, November 19, 2026 - Nielsen, a...

20/11/2026

The Gauge: Poland | October 2026

October's autumn weather clearly encouraged Poles to spend more time in front of their screens, resulting in both longer viewing times and a higher overall ...

20/11/2026

FIFA Finds Few U.S. Networks Interested in 2030 World Cup Broadcast Rights

Share {alert(Link copied)}).catch(err => {console.error(Failed to copy: , err)}) data-platform=copy_link data-action= class=font-ui-heading py-2 text-sm tex...

20/11/2026

DigitalGlue releases creative.space Pulse, a free Mac app that shows creatives what is slowing them down

DigitalGlue releases creative.space Pulse, a free Mac app that shows creatives w...

20/11/2026

How NBCUniversal Telemundo Used Virtual Production for its FIFA World Cup 2026 Coverage

How NBCUniversal Telemundo Used Virtual Production for its FIFA World Cup 2026 C...

20/11/2026

What Film School Pays and What it Costs: The Federal Numbers

What Film School Pays and What it Costs: The Federal Numbers Mark Santos November 20, 2026 0 Comments Every editor has had the argument about film sch...

20/11/2026

3D Sound Specialist Turns to Nugen Halo Upmix

Share {alert(Link copied)}).catch(err => {console.error(Failed to copy: , err)}) data-platform=copy_link data-action= class=font-ui-heading py-2 text-sm tex...

20/11/2026

World's First Hybrid Film Production Platform Debuts

Share {alert(Link copied)}).catch(err => {console.error(Failed to copy: , err)}) data-platform=copy_link data-action= class=font-ui-heading py-2 text-sm tex...

20/11/2026

NBC Adds New Stats Feature for Premier League

Share {alert(Link copied)}).catch(err => {console.error(Failed to copy: , err)}) data-platform=copy_link data-action= class=font-ui-heading py-2 text-sm tex...

20/11/2026

Hearst TV Names Shawnda Adams to Lead KOCO-TV Oklahoma City

Share {alert(Link copied)}).catch(err => {console.error(Failed to copy: , err)}) data-platform=copy_link data-action= class=font-ui-heading py-2 text-sm tex...

20/11/2026

FCC Modernizes Drone Communications, Detection Rules

Share {alert(Link copied)}).catch(err => {console.error(Failed to copy: , err)}) data-platform=copy_link data-action= class=font-ui-heading py-2 text-sm tex...

20/11/2026

OBSBOT Unveils 2 New PTZR Cameras

Share {alert(Link copied)}).catch(err => {console.error(Failed to copy: , err)}) data-platform=copy_link data-action= class=font-ui-heading py-2 text-sm tex...

20/11/2026

New DigitalGlue Mac App Identifies Media Production Hurdles

Share {alert(Link copied)}).catch(err => {console.error(Failed to copy: , err)}) data-platform=copy_link data-action= class=font-ui-heading py-2 text-sm tex...

20/11/2026

Beam Dynamics Introduces MCP for Faster, Smarter Technolo...

Beam Dynamics has introduced new Model Context Protocol (MCP) support, expanding how customers can work with the live operational data held in Beam. The new cap...

20/11/2026

Re:Vision Effects Cyber Week Sale Nov 24 to Nov 30

Re:Vision Effects Cyber Week Sale Nov 24 to Nov 30 Pierre Jasmin November 19, 2026 0 Comments Long time friends of the COW are up with a big sale! Us...

20/11/2026

Avid is offering up to 33% off annual subscriptions!

Avid is offering up to 33% off annual subscriptions! Brie Clayton November 19, 2026 0 Comments Hero image courtesy Deposit Photos Pro Tools Pro To...

19/11/2026

Live From the UFL Draft: League's First Live Draft Broadcast Is Set To Innovate, Bring Viewers Close to the Action

With a sports-bar vibe and all the teams onsite in a huge atrium in Ballpark Vil...

19/11/2026

SVG Students To Watch: Niamh Campbell, Seton Hall University

The senior from Phoenix and England is balancing life as a Division I tennis player with a growing career behind the microphone The future of live sports produ...

19/11/2026

RED Connect Adds Native Colorfront Color Management for Live RED Camera Feeds

RED Digital Cinema and Colorfront have partnered to integrate native Colorfront color management into RED Connect, letting productions apply Colorfront's co...

19/11/2026

SMPTE Publishes Engineering Report on Content Provenance and Authenticity

SMPTE has published an engineering report summarizing an industry survey by its Study Group on Content Provenance and Authenticity in Media. The findings point ...

19/11/2026

CTech and Skyline Communications Partner on Integrated SATCOM Operations for Defense

CTech and Skyline Communications have announced a partnership to deliver integra...

19/11/2026

EITB Deploys SMPTE ST 2110 Infrastructure with Lawo HOME mc DSP Processing

Euskal Irrati Telebista (EITB), the Basque Country's public media group, has completed Phase 1 of a five-studio renewal with the commissioning of a Lawo IP ...