Error handling

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, developers should refer to the "Errors" page within the dashboard. This page provides comprehensive details about each encountered issue, supporting efficient diagnosis and resolution.