For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
StatusSupportDiscussionsLog inSign Up
Docs HomeAPI ReferenceVideo on DemandAI FeaturesLive StreamingVideo PlayerVideo DataCloud PlayoutRecipes
Docs HomeAPI ReferenceVideo on DemandAI FeaturesLive StreamingVideo PlayerVideo DataCloud PlayoutRecipes
  • Player SDKs
    • Introduction
  • Web player
    • Install the FastPix web player
    • Play uploaded videos
    • Handle playback errors
  • Android player
    • Install FastPix Android player
    • Set up the player
    • Play uploaded videos
    • Handle playback errors
  • iOS player
    • Install FastPix iOS player
    • Play uploaded videos
    • Handle playback errors
  • Flutter player
    • Install FastPix Flutter player
    • Play uploaded videos
    • Handle playback errors
LogoLogo
StatusSupportDiscussionsLog inSign Up
On this page
  • Unrecoverable errors
  • Data integration errors
Web player

Handle playback errors

Was this page helpful?
Previous

Autoplay, loop, and mute

Next
Built with

Troubleshoot FastPix Player errors, playback error, video error recovery, FastPix dashboard, error logging, streaming diagnostics, unrecoverable errors, video debugging, player resilience, and data integration issues.

FastPix Player is engineered for resilience, equipped with built-in mechanisms to automatically detect and recover from errors encountered during video playback.


Unrecoverable errors

In some instances, FastPix Player may encounter errors that prevent it from automatically recovering playback. These errors are typically more severe and could be due to:

  • Corrupted video files
  • Missing data streams
  • Server-side issues

When such unrecoverable errors occur, FastPix Player will prioritize displaying a clear, informative message to the viewer. This message typically includes:

  • Error description: A brief explanation of the encountered error.
  • Potential solutions (if applicable): The message might suggest actions the viewer can take to try resolving the issue, such as checking their internet connection or restarting the playback.

For developers, additional information will be logged to aid debugging and preventing future occurrences. These logs will include:

  • Debugging details: Specific details about the encountered error to assist with troubleshooting.
  • Link to more information: A link to relevant documentation or resources that provide further context on the error.

Additionally, the error will be tracked within the FastPix Video Data dashboard on the “Errors” page. This page offers a central location for developers to view detailed information on all encountered errors, including:

  • Error timestamp: The date and time the error occurred.
  • Error type: A classification that helps identify the nature of the error.
  • Playback session details: Contextual information about the playback session during which the error occurred (e.g., video ID, user information).

Data integration errors

If errors arise due to data integration issues within the FastPix Player (such as an HLS embed), these errors will not appear in the player’s on-screen messages. Instead, they will be logged on the Errors page in your FastPix Data dashboard.

To troubleshoot data integration errors, you should refer to the Errors page within the dashboard. This page provides comprehensive details about each encountered issue, supporting efficient diagnosis and resolution.