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

13/11/2026

E1 Series Brings Its Remote-First Broadcast Model to Miami for Season Finale

The UIM E1 Series wraps its third season this week with the Bombay Sapphire E1 Miami GP, Nov. 11-14, on Biscayne Bay at the Miami Seaplane Base on Watson Island...

13/11/2026

SVG GameDay, Ep. 39: Carolina Hurricanes Christine Williams & Jason Danby - Celebrating a Stanley Cup in Raleigh

In-venue and creative video staffers at the professional and collegiate level ha...

13/11/2026

Benson Boone to Headline Entertainment at Discover NHL Winter Classic

Singer-songwriter Benson Boone will headline entertainment for the Discover NHL Winter Classic between the Utah Mammoth and Colorado Avalanche at Rice-Eccles St...

13/11/2026

Blackmagic Design Announces Ambisonic Microphone for Immersive Spatial Audio

Blackmagic Design has announced the Blackmagic Ambisonic Microphone, a 7th order ambisonic microphone array that captures spatial audio for immersive video prod...

13/11/2026

The Studio B&H and Riedel to Power SMPTE MTS Solutions Hub

SMPTE has announced that The Studio B&H and Riedel Communications will provide the video infrastructure and communications technology for the Solutions Hub at t...

13/11/2026

HPA Sets 2027 Tech Retreat Theme Around a Changing Industry

The Hollywood Professional Association (HPA) has announced the theme and program focus for the 2027 HPA Tech Retreat, which takes place Feb. 14-18, 2027, in La ...

13/11/2026

Football Manager 27 Touch Joins Apple Arcade, with Plants vs. Zombies, Prince of Persia Added Dec. 3

Football Manager 27 Touch is available on Apple Arcade starting today. The game ...

13/11/2026

MotoGP and ESPN Announce Two-Year Media Rights Agreement for U.S. and Latin America

MotoGP has announced a two-year media rights agreement with ESPN covering the Un...

13/11/2026

Apple Sports Adds UFC Ahead of UFC 334

Apple Sports, the free iPhone app, has added the Ultimate Fighting Championship (UFC) to its lineup of supported sports, in time for Saturday's UFC 334. The...

13/11/2026

NBA Names Fanatics Studios Multiyear Creative and Event Production Partner for NBA All-Star

The NBA and Fanatics Studios, the joint venture between Fanatics and entertainme...

13/11/2026

From ManningCast to McAfee to Star Wars: ESPN, Disney Pull Back the Curtain on Super Bowl LXI Plans

ESPN held its annual EDGE Innovation Conference last night and offered up an ove...

13/11/2026

Battle in the Bronx: YES Network Presents 2026 Cortaca Jug at Yankee Stadium

Regional sports network gives Ithaca College, SUNY Cortland students a platform to thrive One of the biggest games in Division III college football will be pla...

13/11/2026

HLabs reveal the CL089

Studer-inspired 500-series PWM compressor unveiled The HLabs range already includes a couple of Studer-inspired offerings in the form of the PRE169 and EQ16...

13/11/2026

Freedom of Choice White Paper

Download Now! To view the white paper, please enter the following details: -- First Name* First Name Company* Country* Please select your countryA...

13/11/2026

Cruz Schedules Confirmation Vote for FCC Nominee Thumann-Severs

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

13/11/2026

Yamaha Acquires Virtual Production Specialist Disguise

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

13/11/2026

MyStation App Emulates TV Network' Marketplace

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

13/11/2026

Blue Lucy integrates with Comcast Technology Solutions Vi...

Blue Lucy, the workflow orchestration and integration platform for broadcasters, rights owners and localisation companies, today announced an integration with c...

13/11/2026

Krotos announces Black Friday offers on Studio Pro and Studio Max

Krotos announces Black Friday offers on Studio Pro and Studio Max Brie Clayton November 12, 2026 0 Comments First-year annual plans start at US$195.99...

13/11/2026

Blackmagic Design Announces Blackmagic Ambisonic Microphone

Blackmagic Design Announces Blackmagic Ambisonic Microphone Brie Clayton November 12, 2026 0 Comments New 7th order ambisonic microphone with 108 MEMS...

13/11/2026

Meet the Berklee Student Setting Planetary Motion to Music

Meet the Berklee Student Setting Planetary Motion to Music With his compositional platform SoniKosmos, Javier Roqueni aims to make the universe the ultimate i...

13/11/2026

Hub: Despite AI, More Viewers Still Rely on Word of Mouth and Trailers to Find New TV Shows

Share {alert(Link copied)}).catch(err => {console.error(Failed to copy: , er...

13/11/2026

Jack Smith Joins Madhive as Chief Product and Technology Officer

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

13/11/2026

Operative Names Brian Beirne as Senior VP, Commercial Growth

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

13/11/2026

Former FCC Chair Tom Wheeler to Advise AI Startup

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

13/11/2026

IEEE Broadcast Technology Society Honors Dr. Yiyan Wu with the 2026 Jules Cohen Award

Share {alert(Link copied)}).catch(err => {console.error(Failed to copy: , er...

13/11/2026

Vizrt Acquires Chyron

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

13/11/2026

Samsung Ads to Offer 3 New Interactive Formats

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

13/11/2026

HPA Retreat to Explore Changing Shape of Industry

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

13/11/2026

The Studio B&H, Riedel to Equip SMPTE Media Tech Summit

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

13/11/2026

Tegna Promotes 3 Sales Executives to President and GM

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

13/11/2026

Amagi and Golden Times Media Technology to Bring Chinese...

Amagi, the media industry cloud company, today announced a partnership with Golden Times Media Technology (stock code 920021.BJ), a Beijing-based media and tech...

13/11/2026

CGI and Cedar Broadcast and Communications deploy advance...

CGI (TSX: GIB.A) (NYSE: GIB), one of the largest independent IT and business consulting services firms in the world, together with its Malaysian partner, Cedar ...

13/11/2026

The Studio BH and Riedel Communications Power the SMPTE...

SMPTE, the home for media professionals, technologists and engineers, today announced that The Studio B&H and Riedel Communications will provide the video infra...

13/11/2026

iWedia Brings Software-First DRAM Optimization to Android...

iWedia, a global leader in connected TV software solutions, will present its software-first approach to DRAM optimization at Android TV APAC Summit 2026 in Bang...

13/11/2026

Apple HomeView available today - UPDATE - Posted on 13 November 2026

Beginning today, November 13, Apple HomeView is available for purchase at Apple Store locations, on the Apple Store online, and in the Apple Store app in select...

13/11/2026

How AI Is Helping Care Teams Get Patients the Right Care, Sooner

From pediatric research to smart hospitals, AI is helping care teams spend less time on routine tasks and more time with patients. Health systems and startups...

12/11/2026

The Software-Defined Shift: A Discussion on the Technologies Reshaping Live Sports Production

Industry leaders examine how Dynamic Media Facility, Media eXchange Layer, and c...

12/11/2026

SVG Students to Watch: Addison Carnow, University of North Carolina

The junior Tar Heel is embracing the technical and creative challenges of live production while emerging as a leader and mentor in the control room...

12/11/2026

Gracenote Survey: 78% of Viewers 18-24 Want a Single Program Guide Across Streaming Services

Gracenote, Nielsen's content intelligence business, has released its fifth a...

12/11/2026

RTL Deutschland and NHL Expand Partnership, Bringing NHL Monday Night Hockey to Free-to-Air TV in Germany

RTL Deutschland will bring the NHL to free-to-air TV in Germany starting Nov. 30...

12/11/2026

Clear-Com Supports Global Student Broadcast On Air 2026 With Station-IC, Eclipse HX and FreeSpeak Cell

Clear-Com supported On Air 2026, a 24-hour student-led broadcast connecting 45 u...

12/11/2026

uniqFEED Opens Remote Operations Center in Madrid for LaLiga Virtual Advertising

uniqFEED has opened a Remote Operations Center (ROC) in Madrid, Spain. It is already operational, delivering virtual advertising for LaLiga matches. The ROC is ...

12/11/2026

Disney, ESPN and NBA Present Third Dunk the Halls Animated Christmas Day Game

Disney, ESPN and the NBA will present Dunk the Halls, the third real-time animated NBA game using Sony's Beyond Sports data visualization technology, on Chr...

12/11/2026

Van Wagner Launches RELAY Digital Platform for College Athletics Websites and Apps

Van Wagner has launched Van Wagner RELAY, a digital platform for official athlet...

12/11/2026

Vizrt Acquires Chyron in Major Consolidation of Broadcast Graphics Market

Deal brings together two of the industry's most established graphics brands and significantly expands Vizrt's footprint in U.S. sports and regional broa...

12/11/2026

Euro TV Upgrades OB Van with Lawo mc36 MkII and VSM

Euro TV Production GmbH of Austria has upgraded its outside broadcast vehicle with Lawo technology. The mc 36 Classic console in service since 2019 was replaced...

12/11/2026

Tagboard Launches Spark Resize Beta to Convert Graphics to New Aspect Ratios

Tagboard has launched Spark Resize, an AI-assisted tool now in beta that takes an existing graphic and produces a new version for a different aspect ratio or sc...