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
Most recent headlines
02/01/2025
With more than 640 million users and more than 250 million subscribers, Spotify ...
02/01/2025
NextGen TV, aka ATSC 3.0, continued to advance in 2024, with some notable developments and renewed hopes that a deregulatory-minded Federal Communications Commi...
02/01/2025
Artificial intelligence is undoubtedly the hottest topic in the tech industry today, displaying all the excitement, apprehension and hype of the early days of t...
02/01/2025
STAMFORD, Conn. NBC Sports said 2024 was its best year in terms of ratings since 2016. Its success was fueled by the Paris Summer Olympics as well as its NFL co...
02/01/2025
MSG Networks has been dropped from Altice USA's Optimum-branded pay TV offerings after the operator and the regional sports provider were unable to reach a ...
02/01/2025
How color film and analog color TV works with bluescreen / chromakey
Graham Quince January 2, 2025
0 Comments
A deep dive into VFX History looking at ...
02/01/2025
Hulu Series Interior Chinatown Graded with DaVinci Resolve Studio
Brie Clayton January 2, 2025
0 Comments
Colorist Aidan Stanford delivers complex gra...
02/01/2025
Bulk Font Replacement in Premiere Pro
Andy Ford January 2, 2025
0 Comments
If you want to change the font of multiple text layers in Premiere Pro, the...
02/01/2025
Streaming media's impact on the media and entertainment industry continued to widen in 2024, as more sports rights moved to streaming platforms and the rapi...
02/01/2025
ATLANTA The board of directors for Gray Television Inc. has unanimously voted to change the company's name to Gray Media, Inc. effective Jan. 1....
02/01/2025
Official television and film archives exist to preserve the history and creativity of media. But even these formal institutions do not contain everything that h...
02/01/2025
Welsh succeeds Renard Jenkins, who has reached the end of his two-year tenure in the role
By Jenny Priestley
Published: January 2, 2025
Welsh succeeds Ren...
02/01/2025
Creator Economy Isn't Really Like Film/Show Entertainment
Andy Marken January 1, 2025
0 Comments
Come on Barry, you're good at this sort of s...
02/01/2025
Blackmagic Design Announces New Lower Price for Blackmagic Pocket Cinema Camera ...
02/01/2025
Hollywood Lighting Hacks: Big Looks, Tiny Budget
Sean Alami January 1, 2025
0 Comments
Discover how to create stunning Hollywood-style lighting using ...
02/01/2025
PDC World Darts Championship: Sky Sports on the oche for the Nuke's' re...
02/01/2025
PGA TOUR's Mike Raimondo on the Highlights and Impact of the PGA's New C...
02/01/2025
SVG Year in Review - Audio Edition: More Music, More Mergers, Fewer A1s Spectrum, sports betting, AI are other factors in sound for both broadcast and streaming...
02/01/2025
SVG Year in Review: Our Most Read Stories, A Look Back at Paris 2024, and the Bi...
02/01/2025
Comscore Appoints New Chief Marketing Officer Measurement innovator taps TV, streaming and digital ad veteran Jackelyn Keller for brand and product marketing e...
02/01/2025
A fresh start to 2025 with new faces, familiar voices and plenty of Irish music ...
02/01/2025
GeForce NOW is kicking off 2025 by delivering 14 games to the cloud this month, with two available to stream this week so members can get started on their New Y...
01/01/2025
Marcy Lefkovitz, Dalet SVP product innovation, details the findings of the companys report into the future of newsrooms, including leveraging AI, optimising mul...
01/01/2025
PGA TOUR Centers Media Operations in Transformative New Studio Fully integrated ST 2110 facility enhances production for fans domestic and international By Ken...
31/12/2024
Rashad Frett shares a moment with Michelle Satter at the 2023 Directors Lab. Pho...
31/12/2024
What's Ahead in 2025? OWC's Larry O'Connor Offers Some Bold Predicti...
31/12/2024
Blackmagic Design Announces New Features for Blackmagic Cloud
Brie Clayton December 31, 2024
0 Comments
New thumbnail icon view, clip metadata inspect...
31/12/2024
5 Features in DaVinci Resolve You're Not Using (But You Should Be)
Kasia Jarco December 31, 2024
0 Comments
In this video we are going to talk abo...
31/12/2024
Back to All News
NFL Christmas Day Games on Netflix Average Over 30 Million Global Viewers
Entertainment
31 December 2024
Global
Link copied to clipboard
...
31/12/2024
Back to All News
Squid Game' Season 2 Smashes Top 10 Records as Millions W...
30/12/2024
Leaving Thomson after 21 years, former Managing Director David Quin reflects on a career spent navigating the shifting sands of global media development. From r...
30/12/2024
[Pictured: a still from Love Lies Bleeding, one of the 100 Sundance-supported titles that opened to wider audiences in 2024]...
30/12/2024
Digital Domain Creates Groundbreaking VFX for Venom: The Last Dance, Bringing ...
30/12/2024
Internet Giant GMP Builds Tokyo Virtual Event Space with URSA Broadcast G2
Brie Clayton December 30, 2024
0 Comments
Blackmagic URSA Broadcast G2 and ...
30/12/2024
Renderboxes launches Photon, a no-compromise transportable high-performance work...
30/12/2024
Shinobi II Monitor Supports Canon, Sony, Nikon - Touch to Focus with New Feature...
30/12/2024
30 Dec 2024
In a Groundbreaking Agreement, VEON and Starlink to Bring Starlink ...
30/12/2024
The pace of technology innovation has accelerated in the past year, most dramati...
29/12/2024
Gyeongnam Culture and Arts Foundation (GCAF), an active promotor of cultural and artistic diversity, has chosen Ikegami UHK-X700 camera chains for integration i...
27/12/2024
After starting 2024 with hopes that the transition to streaming might finally produce a more stable, profitable businesses, the media and entertainment industry...
27/12/2024
Broadcasters ended the year with hopes and fears about how the federal government will regulate the TV industry in 2025. While the incoming Trump administration...
27/12/2024
NVIDIA's AI Podcast gives listeners the inside scoop on the ways AI is transforming nearly every industry. Since the show's debut in 2016, it's gar...
26/12/2024
Talking about artificial intelligence in 2024 is akin to talking about the internet in 1994 everyone's excited about it and thinks it will have an enormous ...
26/12/2024
Back to All News
Netflix NFL Christmas Gameday Reaches 65 Million US Viewers
Entertainment
26 December 2024
GlobalUnited States
Link copied to clipboard
U...
26/12/2024
Back to All News
Check Out All the Must-See Trailers From Netflix's NFL Chr...
26/12/2024
Back to All News
Beyonc Delivers Epic Gift of a Halftime Performance "Beyonc...
26/12/2024
Back to All News
Get in the Game With Squid Game' Season 2 Complete Coverage Guide
Entertainment
26 December 2024
Global
Link copied to clipboard
Are...
26/12/2024
This GFN Thursday wraps up another incredible year for cloud gaming. Take a look back at the top games and new features that made 2024 a standout for GeForce NO...
24/12/2024
The National Film and Video Foundation (NFVF) is calling for applications from South African film and television filmmakers to be part of the NFVF's delegat...
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.
