Monitor AndroidX Media3
FastPix Data SDK for AndroidX Media3 (latest version of ExoPlayer) helps you track key video metrics like user interactions, playback quality, and performance to enhance the viewing experience. It lets you customize data tracking, monitor streaming quality, and securely send insights for better optimization and error resolution.
Key features:
- Capture user engagement through detailed viewer interaction data.
- Monitor playback quality with real-time performance analysis.
- Identify and fix video delivery bottlenecks on Android.
- Customize tracking to match specific monitoring needs.
- Handle errors with robust reporting and diagnostics.
Installation and setup
Import the SDK
Basic integration
Including metadata
Advanced configuration
Emit custom events
Configure Media3
Step 1
Installation and setup
Step 2
Import the SDK
Step 3
Basic integration
Step 4
Including metadata
Step 5
Advanced configuration
Step 6
Emit custom events
Detailed example
Configure Media3
PREREQUISITES
- To track and analyze video performance, initialize the FastPixVideo Data SDK with your Workspace key. This key is essential for client-side monitoring and must be included in your Android application’s code wherever you want to track video performance.
- An existing Android Studio project where you plan to integrate the Video Data SDK.
- Gradle configured in your project for managing dependencies.
- Media3 ExoPlayer pre-installed and integrated with your project for Video Data setup.
Step 1: Install and setup
-
Open your Android Studio project where you want to integrate the SDK.
-
Add the Video Data SDK dependency
Navigate to your app-level build.gradle file (or build.gradle.kts if using Kotlin DSL).
Navigate to your settings.gradle file
-
Sync your project with Gradle files
Click “Sync Now” in the notification bar to download and integrate the FastPix Data SDK.
Once the above dependency is added, you can use the FastPix Data SDK module into your Android project where you intend to use its functionalities.
PLEASE NOTE
To ensure accurate analytics, initialize and complete the Media3 Exo-Player setup first. Once the player is fully ready, integrate and start the SDK in your project.
Step 2: Import the SDK
Step 3: Basic integration
Globally declare
You need to globally declare the ExoPlayer instance and FastPixBaseMedia3Player in your Android application. A global declaration ensures that these objects can be accessed throughout the lifecycle of your activity or application where required.
You can initialize ExoPlayer with a PlayerView or SurfaceView in your Android application to enable seamless functionality. Use the following Kotlin or Java code in your Android application to configure Media3 ExoPlayer with FastPix:
Step 4: Including custom data and metadata
workSpaceIdis a mandatory parameter that tells the SDK on which workspace the data will collect.playerViewis another mandatory parameter.exoPlayeris also a mandatory parameter that SDK uses to anylyze the playback.
Check out the user-passable metadata documentation to see the metadata supported by FastPix. You can use custom metadata fields like customField1 to customField9 for your business logic, giving you the flexibility to pass any required values. Named attributes, such as videoTitle and videoId, can be passed directly as they are.
To set up video analytics, create a FastPixBaseMedia3Player object by providing the following parameters: your application’s Context (usually the Activity), the player-view ,exo-playerinstance, workspace-id, player-data-details, viwer-id, video-data-details and custom-data-details objects that you have prepared.
Finally, when destroying the player, make sure to call the FastPixBaseMedia3Player.release() function to properly release resources.
After completing the integration, start playing a video in your player. A few minutes after stopping playback, you’ll see the results in your FastPix Video Data dashboard. Log in to the dashboard, navigate to the workspace associated with your ws_key, and look for video views.
Example to configure Media3 ExoPlayer
Here are platform-specific examples to help you integrate the FastPix Data SDK with your AndroidX Media3 (ExoPlayer) instance. Use the following Kotlin or Java code into your application:
Release notes
For a complete release history, including new features, improvements, and bug fixes, see the FastPix AndroidX Media3 SDK CHANGELOG on GitHub.