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

09/10/2026

Dolby Expands Dolby OptiView Platform with New Capabilities at IBC 2026

September 10 2026, 06:00 (PDT) Dolby Expands Dolby OptiView Platform with New Capabilities at IBC 2026 New Sports Intelligence helps providers better unders...

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

23/09/2026

University of Washington's New Sundodger Studios Leverages ST 2110 to Bring Broadcast, Videoboard, and Creative Under One Roof

Four control rooms support B1G+ streams, videoboard shows, creative content, and...

23/09/2026

Mountain West Conference Moves Replay Operations West, Cutting Late-Night Hours

By Andrew Cohen, SVG Coorespondant The Mountain West debuted its new Replay Operations Center at the start of this football season, bringing real-time collabor...

23/09/2026

SVG Students to Watch: Brian Short, Ball State University

The Taylorville, IL, native is pushing creative boundaries at Ball State, gaining reps across directing, technical directing, tape, and more than 100 ESPN+ broa...

23/09/2026

The Musical and the Power of Spiteful Thinking

Alexander Heller, Nevada Jose, Will Brill, and Giselle Bonilla pose with cast members at The Musical premiere during the 2026 Sundance Film Festival at Eccles...

23/09/2026

The Crow Hill Company release Children's Choir

Includes natural and processed patches The Crow Hill Company's latest sample library captures a children's choir comprising a troupe of boys perform...

23/09/2026

Kreuzberg Audio reveal Oberton

Plug-in offers six bands of saturation Kreuzberg Audio's product range includes a selection of plug-ins and virtual instruments aimed primarily at hard-...

23/09/2026

SoundBridge 3.2.0 arrives

Latest DAW update now live SoundBridge have announced that the latest update for the remote-collaboration-focused DAW is now available. The release of Sound...

23/09/2026

Koori Knockout returns home exclusively to NITV and SBS On Demand in 2026

Koori Knockout returns home exclusively to NITV and SBS On Demand in 2026 11 September, 2026 Media releases Fans can catch all the live action exclusively ...

23/09/2026

Rohde & Schwarz acquires NEOSAT and PHYTRONIC and strengthens its competencies in sovereign satellite communications

Rohde & Schwarz acquires NEOSAT and PHYTRONIC and strengthens its competencies i...

23/09/2026

NFVF SEDIBA CREATIVE ENTERPRISE PROGRAMME CALL FOR APPLICATIONS

1. ABOUT THE PROGRAMME The National Film and Video Foundation (NFVF) invites applications from experienced producers who own or manage a South African product...

23/09/2026

CALL FOR THE SEVENTH PRESIDENTIAL EMPLOYMENT STIMULUS PROGRAMME(PESP 7) FOCUSED ON THE AUDIO-VISUAL INDUSTRY IS OPEN

The National Film and Video Foundation (NFVF) is pleased to announce the opening...

23/09/2026

NHK Technologies Inc. Chooses Calrec for Sports Production

Download Now! To receive a short case study showcasing NHK Technologies, Inc. (NT) s audio setup, please enter the following details: -- First Name* Fir...

23/09/2026

McDonald's takes top spot as New Zealand's fast-food tastes evolve, according to Nielsen

Nielsen CMI data reveals a changing fast-food landscape, with value, convenience...

23/09/2026

AFP, Dalet To Collaborate On News Video Provenance, Authenticity

Share Copy link Facebook X Linkedin Bluesky Email...

23/09/2026

Spectrum News NECN Launches Across New England

Share Copy link Facebook X Linkedin Bluesky Email...

23/09/2026

COW Jobs: Blender on Windows - Generalist - Remote

COW Jobs: Blender on Windows - Generalist - Remote Brie Clayton September 23, 2026 0 Comments Application Users - Blender on Windows - Generalist Se...

23/09/2026

Bitfocus wins IBC2026 Best of Show Award for latest Butto...

Version 1.8 recognised for new workflow tools, boosted control panel flexibility and ease of integration into IP networks...

23/09/2026

Hiltron Reports a Successful IBC2026

Hiltron Communications reports a successful 2026 International Broadcasting Convention, held at the RAI Amsterdam. Exhibiting on stand A37 in Hall 1, Hiltron ex...

23/09/2026

LiveU Showcases AI Driven Production Alongside Resilient...

Reinforcing its long-term commitment to the Middle East and North Africa (MENA) broadcast market, LiveU is presenting the Q Era at CABSAT 2026, on Stand H1-D35 ...

23/09/2026

AFP and Dalet Partner to Strengthen the Provenance and Au...

Agence France-Presse (AFP), a global news agency, and Dalet, a leading technology and service provider for media-rich organizations, today announced a partnersh...

23/09/2026

Berklee Connect Unlocks the Power of a Global Network

Berklee Connect Unlocks the Power of a Global Network Katie Vitolins BM '04 knows firsthand what Berklee's alumni community can make possible. Now she...

23/09/2026

Study: Renewals for Streaming Shows Continue to Decline

Share Copy link Facebook X Linkedin Bluesky Email...

23/09/2026

Study: More Than 4 in 10 U.S. Adults Own or Are Interested in Smart Glasses

Share Copy link Facebook X Linkedin Bluesky Email...

23/09/2026

Television Critics Association Revises Bylaws to Address AI

Share Copy link Facebook X Linkedin Bluesky Email...

23/09/2026

eX Celebrates Completion of Holland Mich. FTTP Network

Share Copy link Facebook X Linkedin Bluesky Email...

23/09/2026

Gray Media Renews Ohio Valley Conference Deal

Share Copy link Facebook X Linkedin Bluesky Email...

23/09/2026

QuickLink StudioPro Powers Next Generation Student Media...

Westminster Schools, a K through 12 school in Atlanta, Georgia with approximately 2,000 students, has transformed its student broadcast and digital storytelling...

23/09/2026

UK Pavilion Brings Leading British Technology to CABSAT a...

The 2026 edition of CABSAT and SATExpo may have a new home and dates in the diary, but it still retains a strong presence from UK companies in the GREAT Britain...

23/09/2026

Glensound marks 60 years with new audio developments at C...

Glensound will return to CABSAT with new developments in professional monitoring and Dante interfacing, alongside its established commentary, esports and parlia...

23/09/2026

Guy Martin's Proper Jobs returns for third series

A great watch - Radio Times TV's most likeable proper bloke - Daily Telegraph 23rd September 2026, London: Guy Martin returns to free streaming service...

23/09/2026

Sky Sports to show England Mens tour of South Africa as part of Cricket South Africa rights deal

Wednesday 23 September 2026 Sky Sports to show England Men's tour of South ...

23/09/2026

Comscore Partners with datafuelX to Bring Seamless Currency Adoption Into a Comprehensive Planning and Stewardship Workflow

Comscore Partners with datafuelX to Bring Seamless Currency Adoption Into a Comp...

23/09/2026

SES Appoints Michel Scholer to Board of Directors

Luxembourg, 23 September 2026 - SES today announced the appointment of Mr. Michel Scholer, Secretary General of the Luxembourg Government and Chief of Staff to ...

23/09/2026

New RT series Ceol le Chile amplifies the multicultural voices of Ireland today

RT One and RT Player, Friday 25 September Ceol le Ch ile, a new series that follows Irish artists as they collaborate with musicians from diverse background...

23/09/2026

RT true crime podcast Unsolved reveals significant new evidence in the case of missing person Philip Cairns

Available now on RT Listen New information has come to light in the case of mi...

23/09/2026

Sakeena Fiza Helps NVIDIA Hardware Succeed at Scale

When Sakeena Fiza describes her work as a validation engineer at NVIDIA, she does so in terms more befitting a detective story than a world-class engineering la...

22/09/2026

Young Journalist Award 2026: Meet the Final 12

From Malaysia to Mexico and from DR Congo to Ukraine, this year's 12 finalists for the 2026 Thomson Foundation Young Journalist of the Year award tell extra...

22/09/2026

ESPN, Precision Lasers Light Up NHL Player Media Tour in Las Vegas

The annual preseason content-gathering event brought 36 NHL players to Las Vegas, where ESPN used 2.5 kilowatts of laser power and a motion-control camera syste...

22/09/2026

Neumann Introduces KK 104 A and KK 105 A Wireless Capsule Heads

Neumann has introduced the KK 104 A (cardioid) and KK 105 A (supercardioid) wireless capsule heads, succeeding the KK 204 and KK 205. The new capsules are compa...

22/09/2026

NFL and TMRW Sports Announce Pro Flag Showcase During Super Bowl LXI Week

The NFL and TMRW Sports have announced a new annual Pro Flag Showcase to be held during Super Bowl LXI week in Los Angeles. The event will feature top flag foot...

22/09/2026

Washington State University Unveils New Daktronics Video Board and Audio System at Gesa Field

Washington State University has unveiled a new end zone video display and audio ...

22/09/2026

SVG Sit-Down: Disney's Dave Johnson on ESPN's New 4K HDR Distribution Pipeline and What It Means for Super Bowl LXI and Beyond

Disney's SVP of Live Operations and Engineering details the technology behin...

22/09/2026

Cosm Promotes Mazen Alawar to SVP of Marketing, Alexis Scalice to VP of Cosm Studios

Cosm has announced two senior promotions. Mazen Alawar has been promoted to SVP,...

22/09/2026

Mississippi State University Extends Camera Relationship with KOKUSAI DENKI

Mississippi State University's University Television Center has purchased four KOKUSAI DENKI SK-UHD7000-S2 cameras since 2024, with plans to add two more, a...

22/09/2026

Net Insight Appoints Christine Kjellvard as Interim CFO

Net Insight has announced that Christine Kjellvard will assume the role of interim Chief Financial Officer on November 1, 2026. Kjellvard has previously held in...

22/09/2026

Net Insight Launches Zyntai TimeNode Access PTP Grandmaster for Edge Sites

Net Insight has announced Zyntai TimeNode Access, a compact PTP Grandmaster designed for distributed edge sites. The product carries secure, precise time across...

22/09/2026

The Weight Explores the High Cost of Freedom in the Depression Era

Sam Hazeldine, Austin Amelio, Padraic McKinley, Julia Jones, and Ethan Hawke attend the premiere of The Weight at The Ray Theatre on January 26, 2026, in Park...