Monitor Bitmovin Player

The FastPix Data SDK with Bitmovin 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.
• Gain deep insights into video performance with streaming diagnostics.

Prerequisites:

To track and analyze video performance, initialize the SDK with your Workspace key. Learn about Workspaces.

1. Access the FastPix Dashboard: Log in and navigate to the Workspaces section.
2. Locate Your Workspace Key: Copy the Workspace Key for client-side monitoring. Include this key in your Java/Kotlin code on every page where you want to track video performance.

Install and setup

1. Open your Android Studio project where you want to integrate the SDK.

2. Add the FastPix Data SDK dependency:

3. Navigate to your app-level build.gradle file (or build.gradle.kts if using Kotlin DSL).

1
implementation "io.fastpix.data:bitmovin:1.0.0"

Navigate to your settings.gradle file

1
dependencyResolutionManagement {
2
    repositories {
3
        google()
4
        mavenCentral()
5
        maven {
6
            url = uri("https://maven.pkg.github.com/FastPix/android-data-bitmovin")
7
            credentials {
8
                username =
9
                    project.findProperty("lpr.user")
10
                password =
11
                    project.findProperty("lpr.key")
12
            }
13
        }
14
    }
15
}

4. Sync your project with Gradle files Click Sync Now in the notification bar to download and integrate the FastPix Data SDK.

Import the SDK

1
import io.fastpix.data.domain.model.CustomDataDetails
2
import io.fastpix.data.domain.model.PlayerDataDetails
3
import io.fastpix.data.domain.model.VideoDataDetails
4
import io.fastpix.bitmovin_player_data.src.CustomerData
5
import io.fastpix.bitmovin_player_data.src.FastPixBitMovinPlayer

Integrate with FastPix

1. Ensure that the workSpaceId is provided, as it is a mandatory field for FastPix integration, uniquely identifying your workspace. Install and import FastPixBitMovinPlayer into your project, and create an bitmovinData instance to bind it to. If you are using any other custom player then create an instance of that player.

2. Next, create an instance of FastPixBitMovinPlayer to track analytics. After the video URL loads and playback begins, the SDK automatically begins tracking analytics.

1
import ... 
2
class MainActivity : AppCompatActivity() { 
3
    private var bitmovinData: FastPixBitMovinPlayer? = null
4
} 

3. You can initialize BitmovinPlayer with a BitmovinPlayerView in your Android application to enable seamless functionality. Use the following Kotlin or Java code in your Android application to configure ExoPlayer with FastPix:

1
val videoDataDetails = VideoDataDetails(
2
    videoId = "video-id",
3
    videoTitle = "video-title",
4
)
5
val customerData = CustomerData(
6
    workSpaceId = "workspace-id",
7
    videoDetails = videoDataDetails,
8
    playerData = PlayerDataDetails("player-name", "player-version"),
9
    customDataDetails = CustomDataDetails(
10
        customField1 = "field1",
11
        customField2 = "field2",
12
        // Add more custom fields as needed
13
    )
14
)
15
bitmovinData = FastPixBitMovinPlayer(
16
    this,
17
    binding.bitmovinPlayerView,
18
    binding.bitmovinPlayerView.player,
19
    enableLogging = true,
20
    customerData = customerData
21
)

Including custom data and metadata

• workSpaceId is a mandatory parameter that tells the SDK on which workspace the data will collect.
• playerView is another mandatory parameter.

1. You can use custom metadata fields like customField1 to customField10 for your business logic, giving you the flexibility to pass any required values. Named attributes, such as videoId and videoTitle, can be passed directly as they are. See the user-passable metadata documentation to see the metadata supported by FastPix.

1
val videoDataDetails = VideoDataDetails(
2
    videoId = "video-id",
3
    videoTitle = "video-title",
4
    videoSeries = "Video Series",
5
    videoProducer = "Video Producer",
6
    videoContentType = "Video Content Type",
7
    videoVariant = "Video Variant",
8
    videoLanguage = "Video Language",
9
    videoDrmType = "Drm Type"
10
)
11
val customerData = CustomerData(
12
    workSpaceId = "workspace-id",
13
    videoDetails = videoDataDetails,
14
    beaconUrl = "beacon-url",
15
    playerData = PlayerDataDetails("bitmovin-player", "bitmovin-version"),
16
    customDataDetails = CustomDataDetails(
17
        customField1 = "field1",
18
        customField2 = "field2",
19
        // Add more custom fields as needed
20
    )
21
)

2. To set up video analytics, create a FastPixBitMovinPlayer object by providing the following parameters: your application’s Context (usually the Activity), the BotmovinPlayer instance, and the customerData.

1
bitmovinData = FastPixBitMovinPlayer(
2
    this,
3
    binding.bitmovinPlayerView,
4
    binding.bitmovinPlayerView.player,
5
    enableLogging = true,
6
    customerData = customerData
7
)

3. Finally, when destroying the player, make sure to call the FastPixBitMovinPlayer.release() function to properly release resources.

1
override fun onDestroy() { 
2
  	super.onDestroy() 
3
	bitmovinData?.release() // Cleanup FastPix tracking 
4
} 

4. 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 workspace_key, and look for video views.

Understanding CustomerData

What FastPix Tracks

After initialization, the SDK automatically collects:

Example to configure Bitmovin with FastPix Data SDK.

Provide your stream URL in the url field video-url and your FastPix workspace key in the workspaceIdfield.

1
class PlayerActivity : AppCompatActivity() {
2
3
    private var bitmovinData: FastPixBitMovinPlayer? = null
4
    private lateinit var binding: ActivityPlayerBinding
5
6
    override fun onCreate(savedInstanceState: Bundle?) {
7
        super.onCreate(savedInstanceState)
8
        binding = ActivityPlayerBidning.inflate(layoutInflater)
9
        setContentView(binding.root)
10
        val player = Player(context = this)
11
        binding.bitmovinPlayerView.player = player
12
        val source = Source(
13
            SourceConfig(
14
                url = "video-url",
15
                type = SourceType.Hls,
16
                title = "video-title",
17
            ),
18
        )
19
        player.load(source)
20
        player.play()
21
22
        // Initializing FastPix
23
        val customerData = CustomerData(
24
            workspaceId = "workspace-id",
25
            videoDetails = VideoDataDetails(
26
                "video-id",
27
                "video-title",
28
            )
29
        )
30
        bitmovinData = FastPixBitMovinPlayer(
31
            this,
32
            binding.bitmovinPlayerView,
33
            binding.bitmovinPlayerView.player,
34
            enableLogging = true,
35
            customerData = customerData
36
        )
37
    }
38
39
    override fun onDestroy() {
40
        bitmovinData?.release()
41
        super.onDestroy()
42
    }
43
}

Debug Logging

Enable logs using:

1
enableLogging = true

Troubleshooting

SDK Not Tracking Events

• Ensure you’ve initialized the SDK after configuring Bitmovin Player
• Check that workSpaceId is correct
• Verify Bitmovin Player events are firing (check Bitmovin Player logs)
• Enable logging to see FastPix SDK activity

Memory Leaks

• Always call release() in onDestroy()
• Ensure bitmovinData?.release() is called before releasing FastPix SDK

Missing Events

• The SDK automatically tracks all events from Bitmovin Player
• Events are tracked based on Bitmovin Player native event system
• Check that Bitmovin player is properly configured and receiving events

Changelog

All notable changes to this project will be documented in this file.

[1.0.4]

• Updated SDK version to 1.0.4 in BitMovinLibraryInfo.kt, README.md, and build.gradle.kts.
• Upgraded FastPix Core dependency to 1.3.1 in gradle/libs.versions.toml.

[1.0.3]

• Upgrades Core SDK to 1.3.0

[1.0.2]

Changed

• Upgraded FastPix Core dependency to 1.2.9 in gradle/libs.versions.toml.
• Updated FastPixBitMovinPlayer pulse lifecycle handling to schedule pulse events during active playback states (viewBegin, play, buffering) instead of cancelling them.
• Updated seek completion behavior to keep pulse events active when playback resumes after seek, and cancel only when the player remains paused.
• Removed redundant pulse start/stop calls for variantChanged, seeking, playerReady, and buffered event dispatch paths.

[1.0.1]

Changed

• Bumped SDK version to 1.0.1 in README.md, BitMovinLibraryInfo.kt, and build.gradle.kts.
• Refactored FastPixBitMovinPlayer to use FastPixAnalytics for SDK initialization and management.
• Implemented periodic pulse event logic using Coroutines to track active playback.
• Added event lifecycle management to schedule or cancel pulse events based on player state (e.g., playing, buffering, seeking).
• Updated internal PlayerListener method signatures for sourceFps and sourceAdvertiseFrameRate to return Int?.
• Upgraded project dependencies including Kotlin to 2.1.0 and FastPix Core to 1.2.7.

[1.0.0] - Initial Release

Added

• Initial release of FastPix Bitmovin Player Data Collector
• Integration with Bitmovin Player 3.0+ for automatic analytics tracking
• Automatic event tracking (play, pause, seeking, buffering, errors, quality changes, etc.)
• State transition validation for accurate event tracking
• Player information collection (dimensions, playhead time, duration, etc.)
• Error handling and reporting
• Resource lifecycle management

Support

📩 Email: support@fastpix.io 📚 Docs: fastpix.com/docs