Multi-Platform Support
Available as an Android AAR, iOS XCFramework, and npm package for web. One consistent measurement approach across all platforms.
Surfmeter Player SDK
In-app video quality measurement for any player, any platform.
Add real-time video quality monitoring to your existing player integration. The Player SDK collects playback telemetry — loading delay, stalling, bitrate, resolution — and computes ITU-T P.1203 MOS scores in the background, with zero impact on the viewing experience.
Product Overview
Quality measurement inside your app
The Surfmeter Player SDK integrates directly with your video player — on Android, iOS, or web. It observes playback events passively, collecting quality-relevant metrics without intercepting the video stream or affecting performance. Data is transmitted in the background and available instantly on the Surfmeter analytics platform.
Award-winning solution
Recognized with the 2026 Streaming Media European Innovation Award
The Player SDK builds on the same award-winning Surfmeter platform — bringing proven QoS/QoE expertise directly into your apps for trusted viewer-experience measurement.
Key Features
What it does
Multi-Player Support
Works with ExoPlayer, AVPlayer, Video.js, THEOplayer, Shaka Player, Brightcove, HTML5 Video, and Chromecast receivers.
Background Telemetry
Collects playback metrics passively in the background. No stalling overhead, no UI changes, no impact on the viewer experience.
ITU-T P.1203 MOS
Computes standardized Mean Opinion Scores for every viewing session, predicting how users would rate the quality they experienced.
Audience
See who is watching
Every session the Player SDK reports appears in the Viewer Experience report in the Surfmeter Dashboard. The Audience chart shows sessions or unique viewers over time, split by content type, device, or network.
Explore the Surfmeter Dashboard
Experience over time
Follow any KPI by device, network, or CDN
Pick a KPI such as P.1203 MOS, stalling ratio, or initial loading delay and split it by operating system, app version, ISP, CDN, or stream. The chart shows who is affected and when the problem started.
Breakdown
Compare your audience segments
The Breakdown table compares up to 25 segments per dimension with the most sessions. Each row shows its share of sessions and color-graded KPIs, and one click opens the sessions behind it.
Proven in Practice
Multi-platform QoE monitoring for in-house IPTV service
DNS:Net wanted to understand quality differences across their Android, iOS, and web player implementations, and discover users who were experiencing poor quality before they complained. With the Surfmeter Player SDK, they gained visibility into client-side quality metrics across all platforms.
Results
- Added clients-side SDKs to all three platforms
- Implemented a dashboard showing the lowest performing sessions across all platforms
- Verified downstream issues due to network interchanges which were not visible in server-side logs
WDR, one of Germany’s largest public broadcasters, uses Surfmeter to monitor the delivery quality of their streaming services from the viewer’s perspective. Beyond continuous CDN performance monitoring, WDR uses Surfmeter to validate new player versions, compare stream configurations, and verify that encoding changes deliver the expected quality improvements before rolling them out to millions of viewers.
Results
- Continuous monitoring of CDN delivery quality for WDR’s streaming services
- Validated new player versions and stream configurations before rollout
- Compared encoding settings and verified quality improvements objectively
- Identified delivery issues across different ISPs and regions
“The Surfmeter app now enables us, for the first time, to record qualitative measurements that are comparable with the customer’s actual perception.”
Magenta Telekom needed a way to measure streaming quality exactly as customers perceive it. Together with T-Labs and AVEQ, they developed a Surfmeter-based mobile app that lets service technicians measure on-site streaming quality at customer premises, producing ITU-standardized MOS scores with geodata for network-wide quality mapping.
Results
- Deployed Surfmeter app to field technicians for on-site quality measurement
- Enabled MOS-based quality scoring that matches actual customer perception
- Mapped streaming quality across regions using geodata to identify weak cells
Measurement points
Measure inside your video player
The Player SDK measures viewing sessions in your web player and in your apps on phones, TVs, and streaming boxes. It sends every result to the dashboard.
Scroll sideways to see the whole network.
How It Works
From integration to insights in 4 steps
The SDK is designed for minimal integration effort. Most setups require fewer than 10 lines of code.
1
Add the SDK
Install via npm (web), Gradle/AAR (Android), or CocoaPods/XCFramework (iOS). Initialize with your API key.
2
Connect to your player
Attach the SDK to your player instance. It automatically subscribes to playback events — no manual event forwarding needed for supported players.
3
Automatic collection
The SDK passively captures loading delay, stalling events, bitrate switches, resolution changes, frame drops, and session metadata.
4
Dashboard & analysis
Session data and P.1203 MOS scores appear on the Surfmeter analytics platform. Filter by app version, device, ISP, geography, and more.
Use Cases
Who it's for
Ready to see it in action?
Get a personalized demo and see how Surfmeter fits your use case.
Data & KPIs
Supported players and KPIs
ExoPlayer AVPlayer Video.js THEOplayer Shaka Player Brightcove HTML5 Video Chromecast
Video QoE
- P.1203 Overall MOSPerceptual quality score (1–5)
- Initial Loading DelayTime until video starts playing
- Stalling RatioPlayback time spent stalling
- Stalling CountNumber of stalling interruptions
- Average Video BitrateAverage data rate of video stream
- Resolution & Quality SwitchesHow often quality changes mid-stream
Playback Details
- Video ResolutionOutput resolution in pixels
- Frame DropsFrames skipped during playback
- Codec & ProtocolVideo encoding and streaming protocol
- Session DurationTotal length of viewing session
- Playback State TimelinePlay, pause, and buffer events over time
Session Context
- Device & OSUser's device and operating system
- App VersionApplication version identifier
- Connection TypeWiFi or cellular connection
- ISP / NetworkInternet service provider
- GeographyCountry and region of user
See Your Viewers’ Quality. For Real.
Learn how the Surfmeter Player SDK fits into your video stack. Get in touch for a demo or integration guide.
Thank you! We'll get back to you shortly.
Something went wrong. Please try again.
