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
  • Expired or invalid authentication token
  • Network connectivity issues
  • Corrupted or unsupported stream format
iOS player

Handle playback errors

Was this page helpful?
Previous

Play live and on-demand streams

Next
Built with

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.