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

03/12/2025

FCC Sets Deadlines for Comments on Nexstar Acquisition of Tegna

WASHINGTON The Federal Communications Commission has opened a docket for comments on the proposed $6.2 billion Nexstar acquisition for Tegna and set deadlines f...

03/12/2025

Brightcove Unveils New AI Features

MILAN, Italy Brightcove has released seven new features designed to expand global reach, improve audience engagement, enhance live-streaming quality and streaml...

03/12/2025

Great American Media to Launch Pure Flix Familia in 2026

NEW YORK Great American Media said it plans to launch Pure Flix Familia, a dedicated Spanish-language platform, in 2026....

03/12/2025

FanDuel Sports Network Launches on Vizio

SOUTHPORT, Conn. Main Street Sports Group has announced that the FanDuel Sports Network app is now available directly on Vizio and on smart TVs with Vizio OS. T...

03/12/2025

Telia Taps Harmonic for Broadband Upgrade in Norway

SAN JOSE, Calif. Harmonic has announced that Telia, the second-largest telecom operator in Norway, is modernizing its broadband network with the company's c...

03/12/2025

Todd Ziegler to Take Reins of Sinclair's Green Bay, Wis., Stations

GREEN BAY, Wis. Sinclair said Jay Zollar, vice president and general manager of WLUK-WCWF here, will retire Dec. 31 after 26 years running the stations. Station...

02/12/2025

Case Study: How Mid-Atlantic Sports Network Moved to All-IP Distribution in 60 Days

Case Study: How Mid-Atlantic Sports Network Moved to All-IP Distribution in 60 D...

02/12/2025

2025 Sports Broadcasting Hall of Fame: Lee Corso, Coach, Commentator, Firebrand

2025 Sports Broadcasting Hall of Fame: Lee Corso, Coach, Commentator, FirebrandBy Ken Kerschbaumer Tuesday, December 2, 2025 - 7:00 am Print This Story | S...

02/12/2025

SVG All-Stars: Dan Nabors, Senior Director, Remote Engineering, TNT Sports

SVG All-Stars: Dan Nabors, Senior Director, Remote Engineering, TNT SportsThe veteran tech leader is helping guide Warner Bros. Discovery's at-home' re...

02/12/2025

National Lacrosse League Opens Season With New Cloud-Based Official Replay-Review System

National Lacrosse League Opens Season With New Cloud-Based Official Replay-Revie...

02/12/2025

Platinum White Paper: The Cinematic Look in Live Production - Bridging Aesthetics and Real-Time Broadcast Technology with Grass Valley

Platinum White Paper: The Cinematic Look in Live Production - Bridging Aesthetic...

02/12/2025

SVG India Announces Advisory Board; JioStar's Prashant Khanna Named Chairman

SVG India Announces Advisory Board; JioStar's Prashant Khanna Named ChairmanBy Ken Kerschbaumer Tuesday, December 2, 2025 - 11:15 am Print This Story |...

02/12/2025

SVG Summit 2025 Preview: New AI Production Tools Workshop' Features ESPN, Fox Sports, NBC Sports NEXT, PGA Tour, PlayOn, and USGA

SVG Summit 2025 Preview: New AI Production Tools Workshop' Features ESPN, F...

02/12/2025

Release Rundown: What to Watch in December, From Atropia to Endless Cookie

Written and directed by Hailey Gates, Atropia won the U.S. Grand Jury Prize: Dramatic at the 2025 Sundance Film Festival....

02/12/2025

Revolutionizing Defense: L3Harris' Advanced Counter-UAS Cutting-Edge Technologies Offer Scalable Solutions for NATO

The lightweight and highly portable CORVUS-RAVEN, recently demonstrated at the V...

02/12/2025

L3Harris Enhancing Marine Corps' Resilient, Multi-Orbit SATCOM Operations

The lightweight, rugged Panther 2 tri-band VSAT delivers high-speed data communications for Internet, VPN connectivity and video transmission over commercial an...

02/12/2025

Clear-Com's Gen-IC Virtual Intercom Delivers Fast, Flexible Communications for...

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

02/12/2025

Nielsen Global Impact Day 2025: Expanding our global impact

NGID volunteers in the United States NGID volunteers in Mexico NGID volunteers in India NGID volunteers in Spain NGID volunteers in Australia NGID voluntee...

02/12/2025

FCC Issues Reminder on Audio-Description Rule Deadlines

WASHINGTON The Federal Communications Commission's Media Bureau has issued a reminder that stations in DMAs 111 through 120 must implement its audio descrip...

02/12/2025

Sony Unveils Alpha 7 V Full-Frame Mirrorless Camera

SAN DIEGO Sony Electronics today introduced the Alpha 7 V (ILCE-7M5), the fifth generation of its Alpha 7 full-frame mirrorless lineup, powered by the newly dev...

02/12/2025

FCC Sets Comment Deadlines for Nexstar-Tegna Merger

WASHINGTON The Federal Communications Commission has opened a docket for comments on Nexstar Media Group's proposed $6.2 billion acquisition of Tegna and se...

02/12/2025

Veronica Rodriguez, Matt Schnaars and Jeff Warshaw Join NAB Board

WASHINGTON The National Association of Broadcasters has added a trio of media executives, Veronica Rodriguez, Matt Schnaars and Jeff Warshaw, to its board of di...

02/12/2025

Brightcove Unveils New Features

MILAN, Italy Brightcove has released seven new features designed to expand global reach, improve audience engagement, enhance live-streaming quality and streaml...

02/12/2025

BCNEXXT and NPC Media Sign Partnership Agreement for Vipe...

BCNEXXT, the developers of the advanced playout platform Vipe, today announced a new Service Provider Partner agreement with NPC Media, the Australian managed p...

02/12/2025

DPA Microphones N Series Wireless Mic System Now Availabl...

DPA Microphones today announces the immediate availability of its new N-Series Digital Wireless Microphone System for customers throughout the U.S. In addition ...

02/12/2025

Hiltron Reports a Well Attended and Successful Space Tech...

Hiltron Communications reports a well attended and successful Space Tech Expo exhibition, held at the Messe Bremen from Tuesday November 18 through Thursday Nov...

02/12/2025

The HELM powers Riverfire with flawless timecode precisio...

The beginning of September saw Riverfire by Australian Retirement Trust, in association with Channel 9 and Triple M, kick off the 2025 Brisbane Festival in spec...

02/12/2025

SGM Lighting and ACT Entertainment Announce Exclusive US...

SGM Lighting is pleased to announce an exciting new partnership with ACT Entertainment, under which ACT will serve as the exclusive distributor for SGM's ne...

02/12/2025

Harmonic Powers Telias NextGeneration Broadband Upgrade i...

Harmonic (NASDAQ: HLIT) today announced that Telia, the second largest telecom operator in Norway, is modernizing its broadband network with the company's i...

02/12/2025

Keepit and TIM AG enters distribution partnership for the...

European cloud data protection specialist Keepit is expanding its sales network in the DACH region and has gained TIM AG, one of the leading value-added distrib...

02/12/2025

Calrec pushes beyond traditional broadcasting with flexib...

Featured products at ISE 2026 This year s ISE 2026 theme "Push Beyond" reflects Calrec s direction of travel. The company is dedicated to supporting the AV an...

02/12/2025

Czech TV Implements Landmark LiveU OB Project in Central...

Czech Television, the national public broadcaster, has deployed one of the largest LiveU live production projects in the region for live sports and news coverag...

02/12/2025

Leader expands cinematic camera support for Live Producti...

Test & measurement innovator, Leader Electronics, has announced the release of v8.2 software for its ZEN and ZEN-W Series, bringing advanced cinematic camera se...

02/12/2025

Accedo and Magine Pro agree to merge SaaS businesses

Global provider of video streaming software and services, Accedo, and OTT platform provider, Magine Pro, have signed a binding agreement to carve out and merge ...

02/12/2025

Skandha Media Services New VP Sales Role Signals Bold Gro...

With proven success in broadcast, OTT, and content supply chains, K.S Avinash set to scale Skandha's service-first approach across APAC Skandha Media Servi...

02/12/2025

AJA Video Systems Joins RAVENNA Community

AJA Video Systems has joined the RAVENNA community, a network of partners devoted to advancing the RAVENNA standard for distributing real-time audio over intern...

02/12/2025

Report: ATSC 3.0 Would Boost Wireless Efficiency, Sustainability

HUNT VALLEY, Md. Sinclair and its wholly-owned subsidiary One Media Technologies have released a new report focused on how ATSC 3.0, the IP-based NextGen TV sta...

02/12/2025

FCC Issues a Reminder on Audio Description Rule Deadlines

WASHINGTON The Federal Communications Commission's Media Bureau has issued a reminder that stations in DMAs 111 through 120 must implement its audio descrip...

02/12/2025

ATSC Members Elect 4 to Board of Directors

WASHINGTON Members of the Advanced Television Systems Committee have elected four industry veterans to three-year terms on the organization's board of direc...

02/12/2025

Survey: Younger Gen Z Consumers Spend 5.1 Hours a Day on Social Media

A new survey from S&P Global Market Intelligence Kagan highlights how important social media is for younger consumers, with Gen Z spending 5.1 hours a day on so...

02/12/2025

Faculty Notes: Fall/Winter 2025

Faculty Notes: Fall/Winter 2025 Recent accomplishments, releases, and events by Berklee faculty. December 1, 2025 By Editorial Staff The cast of Kind of M...

02/12/2025

NVIDIA Partners With Mistral AI to Accelerate New Family of Open Models

Today, Mistral AI announced the Mistral 3 family of open-source multilingual, multimodal models, optimized across NVIDIA supercomputing and edge platforms. M...

02/12/2025

Ring In The Holidays With Our Biggest Sale Ever On Ivory II Pianos!

Ring In The Holidays With Our Biggest Sale Ever On Ivory II Pianos!From now until December 31st, you can save 50% or more on every Ivory II piano and collection...

02/12/2025

Made in America: How Stranger Things' Electrified the US Economy

Back to All News Made in America: How Stranger Things' Electrified the US Economy Entertainment 02 December 2025 GlobalUnited States Link copied to cl...

02/12/2025

International organizations align at International AI Standards Summit

-- The International Electrotechnical Commission (IEC), the International Organization for Standardization (ISO), and the International Telecommunication Unio...

02/12/2025

Harmonic Powers Telia's Next-Generation Broadband Upgrade in Norway

Harmonic's cOS Platform Will Redefine Subscribers' Quality of Experience, Lowering Churn SAN JOSE, Calif. - Dec. 2, 2025 - Harmonic (NASDAQ: HLIT) today...

02/12/2025

NVIDIA and AWS Expand Full-Stack Partnership, Providing the Secure, High-Performance Compute Platform Vital for Future Innovation

At AWS re:Invent, NVIDIA and Amazon Web Services expanded their strategic collab...