usePlayerFatalError()

usePlayerFatalError(): null | PrestoPlayError

Returns the current player fatal error, if any.

This hook provides a reactive way to observe unrecoverable playback errors emitted by the player. The error is automatically cleared when either Player.stop or Player.open is called.

⚠️ Must be used within a PlayerProvider or AVPlayerViewControllerProvider component.

Returns

null | PrestoPlayError

{PrestoPlayError | null} The current fatal PrestoPlayError object, or null if no fatal error is present.

Example

function FatalErrorBanner() {
  const fatalError = usePlayerFatalError();

  if (!fatalError) return null;

  return (
    <div className="error-banner">
      <strong>Fatal Error:</strong> {fatalError.message}
    </div>
  );
}