Handle playback errors
Learn about common playback errors in the FastPix iOS Player and how to troubleshoot them.
When playing video content—especially secured streams—several issues can cause playback failures. This page describes the most common errors and how to resolve them.
Expired or invalid authentication token
If the authentication token used for a secured stream has expired or is invalid, the player can’t access the content.
How to fix it:
- Verify that the token is valid and hasn’t expired before starting playback.
- Generate a new token if the current one has expired. Refer to Secure video playback for details on token generation.
Network connectivity issues
Unstable or slow network connections can cause interruptions or complete playback failures.
How to fix it:
- Check that the device has a stable network connection.
- Retry the connection if playback fails due to a transient network issue.
- Use the SDK’s network handling feature to detect connectivity changes and respond accordingly.
Corrupted or unsupported stream format
The stream might be corrupted or use a format that the player doesn’t support (for example, an unsupported HLS version or missing media segments).
How to fix it:
- Verify that the stream uses a supported format and serves correctly without corruption.
- Check that all media segments are accessible and properly encoded.